@progress/kendo-vue-layout 3.5.0 → 3.5.1-dev.202208150613

package/dist/esm/stepper/Stepper.js

@@ -0,0 +1,463 @@
+var __assign = this && this.__assign || function () {
+  __assign = Object.assign || function (t) {
+    for (var s, i = 1, n = arguments.length; i < n; i++) {
+      s = arguments[i];
+
+      for (var p in s) {
+        if (Object.prototype.hasOwnProperty.call(s, p)) t[p] = s[p];
+      }
+    }
+
+    return t;
+  };
+
+  return __assign.apply(this, arguments);
+}; // @ts-ignore
+
+
+import * as Vue from 'vue';
+var allVue = Vue;
+var gh = allVue.h;
+var isV3 = allVue.version && allVue.version[0] === '3';
+import { focusFirstFocusableChild, Keys, getDefaultSlots } from '@progress/kendo-vue-common';
+import { Step } from './Step.js';
+import { ProgressBar } from '@progress/kendo-vue-progressbars';
+import { DEFAULT_ANIMATION_DURATION, NO_ANIMATION } from './contants.js';
+import { validatePackage, isRtl, templateRendering, getListeners, getTemplate } from '@progress/kendo-vue-common';
+import { packageMetadata } from '../package-metadata.js';
+/**
+ * @hidden
+ */
+
+var StepperVue2 = {
+  name: 'KendoStepper',
+  model: {
+    event: 'changemodel'
+  },
+  props: {
+    animationDuration: {
+      type: [Boolean, Number],
+      default: 400
+    },
+    dir: String,
+    disabled: Boolean,
+    item: {
+      type: [String, Object, Function, Boolean],
+      default: undefined
+    },
+    items: Array,
+    linear: Boolean,
+    mode: {
+      type: String,
+      default: 'steps',
+      validator: function validator(value) {
+        return ['steps', 'labels'].includes(value);
+      }
+    },
+    orientation: {
+      type: String,
+      default: 'horizontal',
+      validator: function validator(value) {
+        return ['horizontal', 'vertical'].includes(value);
+      }
+    },
+    value: {
+      type: Number,
+      default: 0
+    },
+    modelValue: Number,
+    successIcon: String,
+    errorIcon: String
+  },
+  created: function created() {
+    validatePackage(packageMetadata);
+    this.focusedIdx = this.computedValue !== undefined ? this.computedValue : 0;
+  },
+  mounted: function mounted() {
+    this.currentDir = this.$props.dir !== undefined ? this.$props.dir : isRtl(this.$el) ? 'rtl' : 'ltr';
+  },
+  data: function data() {
+    return {
+      currentDir: 'ltr',
+      focusedIdx: 0,
+      stepper: {},
+      currentFocused: false
+    };
+  },
+  watch: {
+    value: function value(newValue) {
+      this.focusedIdx = newValue;
+    }
+  },
+  computed: {
+    computedValue: function computedValue() {
+      return this.$props.modelValue !== undefined ? this.$props.modelValue : this.$props.value;
+    },
+    isVertical: function isVertical() {
+      return this.$props.orientation === 'vertical';
+    },
+    numOfSteps: function numOfSteps() {
+      var items = this.$props.items;
+      return items ? items.length : 0;
+    },
+    stepperClasses: function stepperClasses() {
+      return {
+        'k-stepper': true,
+        'k-stepper-linear': this.$props.linear
+      };
+    },
+    stepperStyles: function stepperStyles() {
+      return {
+        display: 'grid',
+        gridTemplateColumns: !this.isVertical ? 'repeat(' + this.numOfSteps * 2 + ', 1fr)' : undefined,
+        gridTemplateRows: this.isVertical ? 'repeat(' + this.numOfSteps * 4 + ', 1fr)' : undefined
+      };
+    },
+    listClasses: function listClasses() {
+      return {
+        'k-step-list': true,
+        'k-step-list-horizontal': !this.isVertical,
+        'k-step-list-vertical': this.isVertical
+      };
+    },
+    listStyles: function listStyles() {
+      return {
+        gridColumnStart: !this.isVertical ? 1 : '',
+        gridColumnEnd: !this.isVertical ? -1 : '',
+        gridRowStart: this.isVertical ? 1 : '',
+        gridRowEnd: this.isVertical ? -1 : ''
+      };
+    },
+    progressbarStyles: function progressbarStyles() {
+      return {
+        gridColumnStart: !this.isVertical ? 2 : '',
+        gridColumnEnd: !this.isVertical ? this.numOfSteps * 2 : '',
+        gridRowStart: this.isVertical ? 2 : '',
+        gridRowEnd: this.isVertical ? this.numOfSteps * 4 - 2 : ''
+      };
+    }
+  },
+  // @ts-ignore
+  setup: !isV3 ? undefined : function () {
+    var v3 = !!isV3;
+    return {
+      v3: v3
+    };
+  },
+  // @ts-ignore
+  render: function render(createElement) {
+    var h = gh || createElement;
+    var defaultSlot = getDefaultSlots(this);
+    var _a = this.$props,
+        animationDuration = _a.animationDuration,
+        disabled = _a.disabled,
+        items = _a.items,
+        orientation = _a.orientation;
+    var value = this.computedValue;
+    var animation = typeof animationDuration === 'number' ? animationDuration : animationDuration !== false ? DEFAULT_ANIMATION_DURATION : NO_ANIMATION;
+    var steps = items && items.map(function (element, index) {
+      var step = this.$props.item ? templateRendering.call(this, this.$props.item, getListeners.call(this)) : undefined;
+      var stepDefaultRendering = // @ts-ignore
+      h(Step, {
+        key: index,
+        index: index,
+        attrs: this.v3 ? undefined : {
+          index: index,
+          disabled: disabled || element.disabled,
+          focused: index === this.focusedIdx && this.currentFocused,
+          current: index === value,
+          icon: element.icon,
+          label: element.label,
+          optional: element.optional,
+          text: element.text,
+          isValid: element.isValid,
+          tabIndex: element.tabIndex,
+          animationDuration: this.animationDuration,
+          isVertical: this.isVertical,
+          item: this.item,
+          linear: this.linear,
+          mode: this.mode,
+          numOfSteps: this.numOfSteps,
+          value: value,
+          successIcon: this.successIcon,
+          errorIcon: this.errorIcon
+        },
+        disabled: disabled || element.disabled,
+        focused: index === this.focusedIdx && this.currentFocused,
+        current: index === value,
+        onChange: this.handleChange,
+        on: this.v3 ? undefined : {
+          "change": this.handleChange,
+          "focus": this.handleFocus
+        },
+        onFocus: this.handleFocus,
+        "class": element.class,
+        style: element.style,
+        icon: element.icon,
+        label: element.label,
+        optional: element.optional,
+        text: element.text,
+        isValid: element.isValid,
+        tabIndex: element.tabIndex,
+        animationDuration: this.animationDuration,
+        isVertical: this.isVertical,
+        item: this.item,
+        linear: this.linear,
+        mode: this.mode,
+        numOfSteps: this.numOfSteps,
+        value: value,
+        successIcon: this.successIcon,
+        errorIcon: this.errorIcon
+      });
+      var stepRendering = getTemplate.call(this, {
+        h: h,
+        template: step,
+        defaultRendering: stepDefaultRendering,
+        additionalProps: __assign(__assign({}, element), {
+          disabled: disabled || element.disabled,
+          focused: index === this.focusedIdx,
+          current: index === value,
+          value: value
+        }),
+        additionalListeners: {
+          change: this.handleChange,
+          focus: this.handleFocus
+        }
+      });
+      return stepRendering;
+    }, this);
+    return h("nav", {
+      tabindex: this.currentFocused ? -1 : 0,
+      attrs: this.v3 ? undefined : {
+        tabindex: this.currentFocused ? -1 : 0,
+        dir: this.currentDir
+      },
+      "class": this.stepperClasses,
+      style: this.stepperStyles,
+      dir: this.currentDir,
+      onFocusin: this.handleFocusin,
+      on: this.v3 ? undefined : {
+        "focusin": this.handleFocusin,
+        "focusout": this.handleFocusout,
+        "keydown": this.handleKeyDown
+      },
+      onFocusout: this.handleFocusout,
+      onKeydown: this.handleKeyDown
+    }, [h("ol", {
+      "class": this.listClasses,
+      style: this.listStyles
+    }, [steps ? steps : defaultSlot]), // @ts-ignore
+    h(ProgressBar, {
+      style: this.progressbarStyles,
+      animation: {
+        duration: animation
+      },
+      attrs: this.v3 ? undefined : {
+        animation: {
+          duration: animation
+        },
+        "aria-hidden": true,
+        max: this.numOfSteps - 1,
+        labelVisible: false,
+        orientation: orientation,
+        reverse: orientation === 'vertical',
+        value: value,
+        disabled: disabled,
+        tabIndex: -1
+      },
+      "aria-hidden": true,
+      max: this.numOfSteps - 1,
+      labelVisible: false,
+      orientation: orientation,
+      reverse: orientation === 'vertical',
+      value: value,
+      disabled: disabled,
+      tabIndex: -1
+    })]);
+  },
+  methods: {
+    focus: function focus() {
+      if (this.$el) {
+        focusFirstFocusableChild(this.$el);
+      }
+    },
+    dispatchChangeEvent: function dispatchChangeEvent(event, val) {
+      var prevIdx = val === this.computedValue - 1;
+      var currIdx = val === this.computedValue;
+      var nextIdx = val === this.computedValue + 1;
+      var allowClick = !this.linear || prevIdx || currIdx || nextIdx;
+
+      if (this.computedValue !== val && !this.disabled && allowClick) {
+        this.focusedIdx = val;
+        this.$emit('changemodel', val);
+        this.$emit('update:modelValue', val);
+        this.$emit('change', {
+          component: this,
+          event: event,
+          value: val
+        });
+      }
+    },
+    handleChange: function handleChange(event) {
+      var currentValue = event.value;
+      this.dispatchChangeEvent(event, currentValue);
+    },
+    handleFocus: function handleFocus(event) {
+      if (!this.disabled) {
+        this.$emit('focus', event, undefined);
+      }
+    },
+    handleEnter: function handleEnter(event) {
+      var newEvent = {
+        component: this,
+        event: event,
+        value: this.focusedIdx
+      };
+      this.dispatchChangeEvent(newEvent, this.focusedIdx);
+    },
+    handleFocusin: function handleFocusin() {
+      this.currentFocused = true;
+    },
+    handleFocusout: function handleFocusout() {
+      this.currentFocused = false;
+    },
+    handleKeyDown: function handleKeyDown(event) {
+      var isCurrentRtl = this.currentDir === 'rtl';
+      var currIndex = this.focusedIdx;
+      var maxNavIndex = this.items.length - 1;
+
+      switch (event.keyCode) {
+        case Keys.left:
+          event.preventDefault();
+
+          if (!isCurrentRtl && currIndex > 0) {
+            this.focusedIdx = currIndex - 1;
+          }
+
+          if (isCurrentRtl && currIndex < maxNavIndex) {
+            this.focusedIdx = currIndex + 1;
+          }
+
+          break;
+
+        case Keys.right:
+          event.preventDefault();
+
+          if (!isCurrentRtl && currIndex < maxNavIndex) {
+            this.focusedIdx = currIndex + 1;
+          }
+
+          if (isCurrentRtl && currIndex > 0) {
+            this.focusedIdx = currIndex - 1;
+          }
+
+          break;
+
+        case Keys.up:
+          event.preventDefault();
+
+          if (!isCurrentRtl && currIndex > 0) {
+            this.focusedIdx = currIndex - 1;
+          }
+
+          if (isCurrentRtl && currIndex > 0) {
+            this.focusedIdx = currIndex - 1;
+          }
+
+          break;
+
+        case Keys.down:
+          event.preventDefault();
+
+          if (!isCurrentRtl && currIndex < maxNavIndex) {
+            this.focusedIdx = currIndex + 1;
+          }
+
+          if (isCurrentRtl && currIndex < maxNavIndex) {
+            this.focusedIdx = currIndex + 1;
+          }
+
+          break;
+
+        case Keys.home:
+          event.preventDefault();
+          this.focusedIdx = 0;
+          break;
+
+        case Keys.end:
+          event.preventDefault();
+          this.focusedIdx = maxNavIndex;
+          break;
+
+        case Keys.space:
+        case Keys.enter:
+          event.preventDefault();
+
+          if (!this.items[currIndex].disabled) {
+            this.handleEnter(event);
+          }
+
+          break;
+
+        default:
+      }
+    }
+  }
+};
+/**
+ * Represents the [Kendo UI for Vue Stepper component]({% slug overview_stepper %}).
+ *
+ * ```jsx
+ * <template>
+ *    <Stepper :value="value" @change="handleChange" :items="items" />
+ * </template>
+ *
+ * <script>
+ * import {
+ *  Stepper
+ *     } from '@progress/kendo-vue-layout';
+ * export default {
+ *     components: {
+ *        Stepper
+ *     },
+ *     data () {
+ *       return {
+ *         value: 0,
+ *         items: [
+ *           {
+ *             label: "Cart",
+ *             icon: "k-i-cart",
+ *           },
+ *           {
+ *             label: "Delivery Address",
+ *             icon: "k-i-marker-pin-target",
+ *           },
+ *           {
+ *             label: "Payment Method",
+ *             icon: "k-i-dollar",
+ *           },
+ *           {
+ *             label: "Preview",
+ *             icon: "k-i-preview",
+ *             optional: true,
+ *           },
+ *           {
+ *             label: "Finish Order",
+ *             icon: "k-i-track-changes-accept",
+ *           },
+ *         ]
+ *       }
+ *     },
+ *     methods: {
+ *       handleChange (e) {
+ *         this.value = e.value;
+ *       }
+ *     }
+ * };
+ * </script>
+ * ```
+ *
+ */
+
+var Stepper = StepperVue2;
+export { Stepper, StepperVue2 };

package/dist/esm/stepper/contants.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @hidden
+ */
+export declare const DEFAULT_ANIMATION_DURATION = 400;
+/**
+ * @hidden
+ */
+export declare const NO_ANIMATION = 0;

package/dist/esm/stepper/contants.js

@@ -0,0 +1,8 @@
+/**
+ * @hidden
+ */
+export var DEFAULT_ANIMATION_DURATION = 400;
+/**
+ * @hidden
+ */
+export var NO_ANIMATION = 0;

package/dist/esm/stepper/context/StepperContext.d.ts

@@ -0,0 +1,16 @@
+import { StepChangeEvent } from '../interfaces/StepChangeEvent';
+import { StepFocusEvent } from '../interfaces/StepFocusEvent';
+/** @hidden */
+export declare type StepperContextType = {
+    animationDuration?: number | boolean;
+    isVertical?: boolean;
+    item?: any;
+    linear?: boolean;
+    mode?: 'steps' | 'labels';
+    numOfSteps?: number;
+    value: number;
+    successIcon?: string;
+    errorIcon?: string;
+    onChange?: (event: StepChangeEvent) => void;
+    onFocus?: (event: StepFocusEvent) => void;
+};

package/dist/esm/stepper/context/StepperContext.js

@@ -0,0 +1,9 @@
+/**
+ * @hidden
+ */
+var defaultContext = {
+    linear: false,
+    mode: 'steps',
+    value: 0
+};
+export {};

package/dist/esm/stepper/interfaces/StepChangeEvent.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The arguments for the `onChange` Step event.
+ */
+export interface StepChangeEvent {
+    /**
+     * The index of the selected Step.
+     */
+    value: number;
+}

package/dist/esm/stepper/interfaces/StepChangeEvent.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/stepper/interfaces/StepFocusEvent.d.ts

@@ -0,0 +1,5 @@
+/**
+ * The arguments for the `onFocus` Step event.
+ */
+export interface StepFocusEvent {
+}

package/dist/esm/stepper/interfaces/StepFocusEvent.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/stepper/interfaces/StepHandle.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The Step ref.
+ */
+export interface StepHandle {
+    /**
+     * The Step element.
+     */
+    element: HTMLLIElement | null;
+    /**
+     * Focus the Step.
+     */
+    focus: () => void;
+}

package/dist/esm/stepper/interfaces/StepHandle.js

@@ -0,0 +1,4 @@
+/**
+ * The Step ref.
+ */
+export {};

package/dist/esm/stepper/interfaces/StepProps.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Represents the props of the [Kendo UI for Vue Step component]({% slug overview_stepper %}).
+ */
+export interface StepProps {
+    /**
+     * Represents the children that are passed to the Step.
+     */
+    children?: any;
+    /**
+     * Specifies a list of CSS classes that will be added to the Step element.
+     */
+    className?: string;
+    /**
+     * Represents the content that will be rendered inside each Step.
+     *
+     * @hidden
+     */
+    content?: any;
+    /**
+     * Specifies the current Step.
+     */
+    current?: boolean;
+    /**
+     * Sets a custom property.
+     */
+    [customProp: string]: any;
+    /**
+     * Specifies if the Step is disabled
+     * ([see example]({% slug display_modes_stepper %})).
+     */
+    disabled?: boolean;
+    /**
+     * Defines the name for an existing icon in a Kendo UI for Vue theme.
+     * The icon is rendered inside the Step indicator by a `span.k-icon` element
+     * ([see example]({% slug display_modes_stepper %})).
+     */
+    icon?: string;
+    /**
+     * Sets the index of the Step that is used to identify it.
+     */
+    index?: number;
+    /**
+     * Specifies the validity of the step
+     * ([see example]({% slug display_modes_stepper %})).
+     */
+    isValid?: boolean;
+    /**
+     * Specifies the label of the Step
+     * ([see example]({% slug display_modes_stepper %})).
+     */
+    label?: string;
+    /**
+     * Specifies if the step is optional. The validation is not applied to these steps
+     * ([see example]({% slug display_modes_stepper %})).
+     */
+    optional?: boolean;
+    /**
+     * Sets the `tabIndex` property of the Step.
+     * Defaults to `0`.
+     */
+    tabIndex?: number;
+    /**
+     * Specifies the text content of the Step indicator
+     * ([see example]({% slug display_modes_stepper %})).
+     */
+    text?: string;
+}

package/dist/esm/stepper/interfaces/StepProps.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/stepper/interfaces/StepperChangeEvent.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The arguments for the `onChange` Stepper event.
+ */
+export interface StepperChangeEvent {
+    /**
+     * The index of the selected Step.
+     */
+    value: number;
+}

package/dist/esm/stepper/interfaces/StepperChangeEvent.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/stepper/interfaces/StepperFocusEvent.d.ts

@@ -0,0 +1,5 @@
+/**
+ * The arguments for the `onFocus` Stepper event.
+ */
+export interface StepperFocusEvent {
+}

package/dist/esm/stepper/interfaces/StepperFocusEvent.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/stepper/interfaces/StepperHandle.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The Stepper ref.
+ */
+export interface StepperHandle {
+    /**
+     * The Stepper element.
+     */
+    element: HTMLMenuElement | null;
+    /**
+     * Focus the Stepper's first focusable child.
+     */
+    focus: () => void;
+}

package/dist/esm/stepper/interfaces/StepperHandle.js

@@ -0,0 +1,4 @@
+/**
+ * The Stepper ref.
+ */
+export {};

package/dist/esm/stepper/interfaces/StepperOnNavigateEvent.d.ts

@@ -0,0 +1,23 @@
+import { StepperHandle } from './../interfaces/StepperHandle';
+/**
+ * The `StepperOnNavigateEvent` event.
+ */
+export declare class StepperOnNavigateEvent {
+    /**
+     * The Stepper component.
+     */
+    target: StepperHandle;
+    event: any;
+    /**
+     * The previous index of the Step.
+     */
+    prevIndex: number;
+    /**
+     * The new index of the Step.
+     */
+    nextIndex: number;
+    /**
+     * @hidden
+     */
+    constructor(target: StepperHandle, prevIndex: number, nextIndex: number);
+}