@fastkit/vui 0.6.19 → 0.6.20

package/dist/vui.cjs.prod.js

@@ -8,7 +8,9 @@ var vueColorScheme = require('@fastkit/vue-color-scheme');
 var vueUtils = require('@fastkit/vue-utils');
 var vueLoading = require('@fastkit/vue-loading');
 var iconFont = require('@fastkit/icon-font');
+var helpers = require('@fastkit/helpers');
 var vueRouter = require('vue-router');
+var vueAppLayout = require('@fastkit/vue-app-layout');
 
 const CONTROL_SIZES = ['sm', 'md', 'lg'];
 const CONTROL_FIELD_VARIANTS = ['outlined', 'filled', 'flat'];
@@ -531,6 +533,296 @@ const VButton = vue.defineComponent({
 
 });
 
+function _isSlot$8(s) {
+  return typeof s === 'function' || Object.prototype.toString.call(s) === '[object Object]' && !vue.isVNode(s);
+}
+
+const PAGINATION_ALIGNS = ['left', 'center', 'right'];
+function paginationProps() {
+  return vueUtils.createPropsOptions({
+    /**
+     * Active Pages
+     */
+    modelValue: {
+      type: vueUtils.rawNumberPropType,
+      default: 1
+    },
+
+    /**
+     * Total number of pages
+     */
+    length: {
+      type: vueUtils.rawNumberPropType,
+      default: 0
+    },
+
+    /**
+     * Maximum number of links to display.
+     */
+    totalVisible: vueUtils.rawNumberPropType,
+
+    /**
+     * true when narrowing
+     */
+    dense: Boolean,
+    disabled: Boolean,
+    align: {
+      type: String,
+      default: 'center'
+    },
+
+    /**
+     * To synchronize with a query, use the query name
+     */
+    routeQuery: String,
+    beforeChange: Function,
+    color: String
+  });
+}
+const VPagination = vue.defineComponent({
+  name: 'VPagination',
+  props: paginationProps(),
+  emits: {
+    change: page => true
+  },
+
+  setup(props, ctx) {
+    const vui = useVui();
+    const elRef = vue.ref(null);
+    const router = vueRouter.useRouter();
+    const route = vueRouter.useRoute();
+    const internalValue = vue.ref(1);
+    const containerWidth = vue.ref(0);
+    const itemSize = vue.ref(0);
+    const capacityLength = vue.computed(() => {
+      const _itemSize = itemSize.value;
+      if (!_itemSize) return 0;
+      return Math.floor(containerWidth.value / _itemSize);
+    });
+    const colorScope = vueColorScheme.useScopeColorClass({
+      color: () => props.color || vui.setting('primaryScope')
+    });
+    const computedLength = vue.computed(() => vueUtils.resolveNumberish(props.length));
+    const computedTotalVisible = vue.computed(() => vueUtils.resolveNumberish(props.totalVisible));
+    const computedNumbersLength = vue.computed(() => capacityLength.value - 2 - 2);
+    const computedPage = vue.computed(() => {
+      const {
+        routeQuery
+      } = props;
+
+      if (routeQuery) {
+        return vueUtils.getRouteQuery(route.query, routeQuery, Number, 1);
+      }
+
+      return internalValue.value;
+    });
+
+    const _range = (from, to) => helpers.range(to - from, from);
+
+    const computedItems = vue.computed(() => {
+      const maxButtons = computedNumbersLength.value;
+      const totalVisible = computedTotalVisible.value;
+      const length = computedLength.value;
+      const pageValue = computedPage.value;
+      const maxLength = Math.min(Math.max(0, totalVisible || 0) || length, Math.max(0, maxButtons) || length, length);
+
+      if (length <= maxLength) {
+        return _range(1, length);
+      }
+
+      const even = maxLength % 2 === 0 ? 1 : 0;
+      const left = Math.floor(maxLength / 2);
+      const right = length - left + 1 + even;
+
+      if (pageValue > left && pageValue < right) {
+        const start = pageValue - left + 2;
+        const end = pageValue + left - 2 - even;
+        return [1, 'truncate', ..._range(start, end), 'truncate', length];
+      } else if (pageValue === left) {
+        const end = pageValue + left - 1 - even;
+        return [..._range(1, end), 'truncate', length];
+      } else if (pageValue === right) {
+        const start = pageValue - left + 1;
+        return [1, 'truncate', ..._range(start, length)];
+      } else {
+        return [..._range(1, left), 'truncate', ..._range(right, length)];
+      }
+    });
+    const isActive = vue.computed(() => computedLength.value > 1);
+    const isTransitioning = vue.computed(() => {
+      const {
+        routeQuery
+      } = props;
+      if (!routeQuery) return false; // @TODO
+      // return this.$location.isQueryOnlyTransitioning(routeQuery);
+
+      return false;
+    });
+    const isDisabled = vue.computed(() => props.disabled || isTransitioning.value);
+    const classes = vue.computed(() => [{
+      'v-pagination--disabled': isDisabled.value,
+      'v-pagination--dense': props.dense,
+      [`v-pagination--${props.align}`]: true
+    }, colorScope.value.className]);
+
+    async function setPage(value) {
+      if (isDisabled.value) return;
+      const {
+        beforeChange,
+        routeQuery
+      } = props;
+      const newPage = vueUtils.resolveNumberish(value);
+      if (computedPage.value === newPage) return;
+
+      if (beforeChange) {
+        try {
+          let result = beforeChange(newPage);
+          if (helpers.isPromise(result)) result = await result;
+          if (result === false) return;
+        } catch (e) {}
+      }
+
+      if (routeQuery) {
+        const to = createRoutableLocationByPage(newPage, routeQuery);
+        return router.push(to).then(failure => {
+          !failure && ctx.emit('change', newPage);
+        });
+      } else {
+        internalValue.value = newPage;
+        ctx.emit('update:modelValue', newPage);
+        ctx.emit('change', newPage);
+      }
+    }
+
+    function createPageInfo(source) {
+      const currentPage = computedPage.value;
+      const length = computedLength.value;
+      let number;
+      let page;
+      let active;
+      let disabled;
+
+      if (typeof source === 'number') {
+        number = true;
+        page = source;
+        active = currentPage === page;
+        disabled = false;
+      } else if (source === 'truncate') {
+        number = false;
+        active = false;
+        disabled = false;
+      } else {
+        number = false;
+        const isPrev = source === 'prev';
+        const ammount = isPrev ? -1 : 1;
+        page = currentPage + ammount;
+        active = false;
+        disabled = page < 1 || page > length;
+      }
+
+      return {
+        number,
+        page,
+        active,
+        disabled
+      };
+    }
+
+    function createRoutableLocationByPage(page, routeQuery) {
+      return vueUtils.getQueryMergedLocation({
+        [routeQuery]: page
+      }, route);
+    }
+
+    function genItem(source, index) {
+      const {
+        number,
+        page,
+        active,
+        disabled
+      } = createPageInfo(source);
+      const type = number ? 'num' : source; // const staticClass = `pagination__item`;
+
+      const classes = ['v-pagination__item', {
+        [`v-pagination__item--${type}`]: true,
+        'v-pagination__item--active': active,
+        'v-pagination__item--disabled': disabled
+      }];
+      const children = number ? page : (() => {
+        if (type === 'truncate') {
+          return vue.createVNode("span", null, [vue.createTextVNode("...")]);
+        }
+
+        const isPrev = type === 'prev';
+        const name = isPrev ? 'chevron-left' : 'chevron-right';
+        return vue.createVNode(VIcon, {
+          "class": "v-pagination__item__icon",
+          "name": name
+        }, null);
+      })();
+
+      const onClick = ev => {
+        ev.preventDefault();
+        if (page === undefined || active || disabled) return;
+        setPage(page);
+      };
+
+      const key = `${source}-${index}`;
+      const {
+        routeQuery
+      } = props;
+
+      if (page !== undefined && routeQuery) {
+        const to = createRoutableLocationByPage(page, routeQuery);
+        return vue.createVNode(vueRouter.RouterLink, {
+          "class": classes,
+          "to": to,
+          "key": key
+        }, _isSlot$8(children) ? children : {
+          default: () => [children]
+        });
+      } else {
+        return vue.createVNode("button", {
+          "class": classes,
+          "type": "button",
+          "value": page,
+          "onClick": onClick,
+          "key": key
+        }, [children]);
+      }
+    }
+
+    vue.watch(() => props.modelValue, modelValue => {
+      internalValue.value = vueUtils.resolveNumberish(modelValue);
+    }, {
+      immediate: true
+    });
+    return () => {
+      if (!isActive.value) return undefined;
+      const $items = ['prev', ...computedItems.value, 'next'].map((i, index) => genItem(i, index));
+      return vue.withDirectives(vue.createVNode("nav", {
+        "class": ['v-pagination', classes.value],
+        "ref": elRef
+      }, [$items]), [vueUtils.resizeDirectiveArgument(({
+        width
+      }) => {
+        const el = elRef.value;
+
+        if (el) {
+          const style = window.getComputedStyle(el, 'before');
+          const width = style.getPropertyValue('width');
+          const margin = style.getPropertyValue('margin');
+          const size = parseFloat(width) + parseFloat(margin) * 0.5;
+          itemSize.value = size;
+        }
+
+        containerWidth.value = width;
+      })]);
+    };
+  }
+
+});
+
 function createListTileProps() {
   const icon = rawIconProp();
   return { ...vueUtils.navigationableProps,
@@ -651,6 +943,51 @@ const VDrawerLayout = vue.defineComponent({
 
 });
 
+function _isSlot$7(s) {
+  return typeof s === 'function' || Object.prototype.toString.call(s) === '[object Object]' && !vue.isVNode(s);
+}
+
+const VHero = vue.defineComponent({
+  name: 'VHero',
+  props: {
+    color: {
+      type: String,
+      default: 'primary'
+    },
+    tag: {
+      type: String,
+      default: 'header'
+    },
+    hTag: {
+      type: String,
+      default: 'h1'
+    }
+  },
+
+  setup(props, ctx) {
+    return () => {
+      let _slot;
+
+      const TagName = props.tag;
+      const HTagName = props.hTag;
+      return vue.createVNode(vueAppLayout.VAppContainer, {
+        "pulled": true
+      }, {
+        default: () => [vue.createVNode(TagName, {
+          "class": ['v-hero', vueColorScheme.toScopeColorClass(props.color)]
+        }, {
+          default: () => [vue.createVNode(HTagName, {
+            "class": "v-hero__title"
+          }, _isSlot$7(_slot = vueUtils.renderSlotOrEmpty(ctx.slots, 'default')) ? _slot : {
+            default: () => [_slot]
+          })]
+        })]
+      });
+    };
+  }
+
+});
+
 function _isSlot$6(s) {
   return typeof s === 'function' || Object.prototype.toString.call(s) === '[object Object]' && !vue.isVNode(s);
 }
@@ -1897,6 +2234,7 @@ exports.VSnackbar = vueKit.VSnackbar;
 exports.ICON_NAMES = iconFont.ICON_NAMES;
 exports.CONTROL_FIELD_VARIANTS = CONTROL_FIELD_VARIANTS;
 exports.CONTROL_SIZES = CONTROL_SIZES;
+exports.PAGINATION_ALIGNS = PAGINATION_ALIGNS;
 exports.VApp = VApp;
 exports.VButton = VButton;
 exports.VCard = VCard;
@@ -1906,12 +2244,14 @@ exports.VCheckbox = VCheckbox;
 exports.VCheckboxGroup = VCheckboxGroup;
 exports.VDrawerLayout = VDrawerLayout;
 exports.VForm = VForm;
+exports.VHero = VHero;
 exports.VIcon = VIcon;
 exports.VListTile = VListTile;
 exports.VNavigation = VNavigation;
 exports.VNavigationItem = VNavigationItem;
 exports.VOption = VOption;
 exports.VOptionGroup = VOptionGroup;
+exports.VPagination = VPagination;
 exports.VPaper = VPaper;
 exports.VRadio = VRadio;
 exports.VRadioGroup = VRadioGroup;
@@ -1953,6 +2293,7 @@ exports.defineFormSelectorComponent = defineFormSelectorComponent;
 exports.iconProps = iconProps;
 exports.installVuiPlugin = installVuiPlugin;
 exports.listTileEmits = listTileEmits;
+exports.paginationProps = paginationProps;
 exports.rawIconProp = rawIconProp;
 exports.renderNavigationItemInput = renderNavigationItemInput;
 exports.resolveNavigationItemInput = resolveNavigationItemInput;

package/dist/vui.css

@@ -512,6 +512,15 @@ template {
   --toolbar-dense-height: calc(var(--toolbar-height) * 0.8);
   --card-content-padding: 1rem;
   --card-actions-padding: 0.5rem;
+  --pagination-item-radius: 2px;
+  --pagination-item-font-size: var(--root-em);
+  --pagination-item-size: calc(var(--root-em) * 2);
+  --pagination-item-margin: calc(var(--root-em) * 0.5);
+  --pagination-item-font-size-dense: calc(
+    var(--pagination-item-font-size) * 0.625
+  );
+  --pagination-item-size-dense: calc(var(--pagination-item-size) * 0.8125);
+  --pagination-item-margin-dense: calc(var(--pagination-item-margin) * 0.75);
 }
 
 :root,
@@ -922,6 +931,108 @@ h6,
   z-index: 1;
   transform: translate(-50%, -50%);
 }
+.v-pagination {
+  --pagination-size: var(--pagination-item-size);
+  --pagination-margin: var(--pagination-item-margin);
+  --pagination-font-size: var(--pagination-item-font-size);
+  --pagination-radius: var(--pagination-item-radius);
+  display: flex;
+  align-items: center;
+  overflow: hidden;
+  font-weight: bold;
+  line-height: 1;
+}
+.v-pagination::before {
+  width: var(--pagination-size);
+  margin: var(--pagination-margin);
+  content: none;
+}
+.v-pagination--left {
+  justify-content: flex-start;
+}
+.v-pagination--center {
+  justify-content: center;
+}
+.v-pagination--right {
+  justify-content: flex-end;
+}
+.v-pagination__item,
+.v-pagination a.v-pagination__item {
+  -webkit-tap-highlight-color: rgba(0, 0, 0, 0);
+  padding: 0;
+  touch-action: manipulation;
+  cursor: pointer;
+  user-select: none;
+  background-color: transparent;
+  border: 0;
+  outline: 0;
+  appearance: none;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  min-width: var(--pagination-size);
+  height: var(--pagination-size);
+  margin: calc(var(--pagination-margin) * 0.5);
+  font-size: var(--pagination-font-size);
+  color: inherit;
+  border-radius: var(--pagination-radius);
+  transition: 0.1s;
+}
+.v-pagination__item::-moz-focus-inner,
+.v-pagination a.v-pagination__item::-moz-focus-inner {
+  border: 0;
+}
+.v-pagination__item, .v-pagination__item:hover, .v-pagination__item:focus,
+.v-pagination a.v-pagination__item,
+.v-pagination a.v-pagination__item:hover,
+.v-pagination a.v-pagination__item:focus {
+  text-decoration: none;
+}
+.v-pagination__item:hover, .v-pagination__item:focus,
+.v-pagination a.v-pagination__item:hover,
+.v-pagination a.v-pagination__item:focus {
+  background: rgba(0, 0, 0, 0.1);
+}
+.v-pagination__item--active, .v-pagination__item--active:hover, .v-pagination__item--active:focus, .v-pagination__item--active:active,
+.v-pagination a.v-pagination__item--active,
+.v-pagination a.v-pagination__item--active:hover,
+.v-pagination a.v-pagination__item--active:focus,
+.v-pagination a.v-pagination__item--active:active {
+  color: var(--text-color);
+  pointer-events: none;
+  background-color: var(--main-color);
+}
+.v-pagination__item--disabled,
+.v-pagination a.v-pagination__item--disabled {
+  color: var(--palette-muted) !important;
+  pointer-events: none !important;
+  background: transparent !important;
+}
+.v-pagination__item--truncate,
+.v-pagination a.v-pagination__item--truncate {
+  color: var(--palette-muted) !important;
+  pointer-events: none !important;
+  background: transparent !important;
+}
+.v-pagination__item .v-icon,
+.v-pagination a.v-pagination__item .v-icon {
+  font-size: 150%;
+}
+.v-pagination--dense .v-pagination__item {
+  --pagination-size: var(--pagination-item-size-dense);
+  --pagination-margin: var(--pagination-item-margin-dense);
+  --pagination-font-size: var(--pagination-item-font-size-dense);
+}
+.v-pagination--disabled .v-pagination__item {
+  color: var(--palette-muted);
+  pointer-events: none;
+}
+.v-pagination--disabled .v-pagination__item:hover, .v-pagination--disabled .v-pagination__item:focus {
+  background: transparent;
+}
+.v-pagination--disabled .v-pagination__item--active {
+  background: var(--palette-muted);
+}
 .v-list-tile {
   --tile-background: var(--main-color, transparent);
   --tile-active-background: var(--deep-color, transparent);
@@ -994,6 +1105,21 @@ h6,
   flex: 0 0 auto;
   margin-top: auto;
 }
+.v-hero {
+  --hero-background-color: var(--main-color);
+  --hero-text-color: var(--text-color);
+  padding: 20px 30px;
+  margin: 0;
+  color: var(--hero-text-color);
+  background-color: var(--hero-background-color);
+}
+.v-hero__title {
+  margin: 0;
+  font-size: 1.75rem;
+  font-weight: 300;
+  line-height: 1;
+  color: inherit;
+}
 .v-navigation-item--opened {
   --tile-background: var(--tile-active-background);
   --tile-text-color: var(--tile-text-active-color);

package/dist/vui.d.ts

@@ -484,6 +484,44 @@ export declare interface NavigationItemInput extends ExtractPropInput<ReturnType
     children?: NavigationItemInput[];
 }
 
+export declare const PAGINATION_ALIGNS: readonly ["left", "center", "right"];
+
+export declare function paginationProps(): {
+    /**
+     * Active Pages
+     */
+    modelValue: {
+        type: PropType<string | number>;
+        default: number;
+    };
+    /**
+     * Total number of pages
+     */
+    length: {
+        type: PropType<string | number>;
+        default: number;
+    };
+    /**
+     * Maximum number of links to display.
+     */
+    totalVisible: PropType<string | number>;
+    /**
+     * true when narrowing
+     */
+    dense: BooleanConstructor;
+    disabled: BooleanConstructor;
+    align: {
+        type: PropType<"left" | "center" | "right">;
+        default: string;
+    };
+    /**
+     * To synchronize with a query, use the query name
+     */
+    routeQuery: StringConstructor;
+    beforeChange: PropType<VPaginationGuard>;
+    color: PropType<ScopeName>;
+};
+
 export declare type RawIconProp = IconName | EmptyIconSymbol | ToggleableIconHook;
 
 export declare function rawIconProp(): PropType<RawIconProp>;
@@ -1313,6 +1351,33 @@ export declare interface VFormSlots {
     default: VueForm;
 }
 
+export declare const VHero: DefineComponent<{
+    color: {
+        type: PropType<ScopeName>;
+        default: string;
+    };
+    tag: {
+        type: StringConstructor;
+        default: string;
+    };
+    hTag: {
+        type: StringConstructor;
+        default: string;
+    };
+}, () => JSX.Element, unknown, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, Record<string, any>, string, VNodeProps & AllowedComponentProps & ComponentCustomProps, Readonly<{
+    color?: unknown;
+    tag?: unknown;
+    hTag?: unknown;
+} & {
+    color: ScopeName;
+    tag: string;
+    hTag: string;
+} & {}>, {
+    color: ScopeName;
+    tag: string;
+    hTag: string;
+}>;
+
 export declare const VIcon: DefineComponent<{
     name: {
         type: PropType<IconName | "$empty">;
@@ -1736,6 +1801,77 @@ export declare const VOptionGroup: DefineComponent<{
     disabled: boolean;
 }>;
 
+export declare const VPagination: DefineComponent<{
+    /**
+     * Active Pages
+     */
+    modelValue: {
+        type: PropType<string | number>;
+        default: number;
+    };
+    /**
+     * Total number of pages
+     */
+    length: {
+        type: PropType<string | number>;
+        default: number;
+    };
+    /**
+     * Maximum number of links to display.
+     */
+    totalVisible: PropType<string | number>;
+    /**
+     * true when narrowing
+     */
+    dense: BooleanConstructor;
+    disabled: BooleanConstructor;
+    align: {
+        type: PropType<"left" | "center" | "right">;
+        default: string;
+    };
+    /**
+     * To synchronize with a query, use the query name
+     */
+    routeQuery: StringConstructor;
+    beforeChange: PropType<VPaginationGuard>;
+    color: PropType<ScopeName>;
+}, () => JSX.Element | undefined, unknown, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    change: (page: number) => true;
+}, string, VNodeProps & AllowedComponentProps & ComponentCustomProps, Readonly<{
+    modelValue?: unknown;
+    length?: unknown;
+    totalVisible?: unknown;
+    dense?: unknown;
+    disabled?: unknown;
+    align?: unknown;
+    routeQuery?: unknown;
+    beforeChange?: unknown;
+    color?: unknown;
+} & {
+    dense: boolean;
+    disabled: boolean;
+    length: string | number;
+    modelValue: string | number;
+    align: "left" | "center" | "right";
+} & {
+    totalVisible?: string | number | undefined;
+    routeQuery?: string | undefined;
+    beforeChange?: VPaginationGuard | undefined;
+    color?: ScopeName | undefined;
+}> & {
+    onChange?: ((page: number) => any) | undefined;
+}, {
+    dense: boolean;
+    disabled: boolean;
+    length: string | number;
+    modelValue: string | number;
+    align: "left" | "center" | "right";
+}>;
+
+export declare type VPaginationAlign = typeof PAGINATION_ALIGNS[number];
+
+export declare type VPaginationGuard = (page: number) => boolean | void | Promise<boolean | void>;
+
 export declare const VPaper: DefineComponent<{
     square: BooleanConstructor;
     headerProps: PropType<ARGS>;