kdutify 0.16.9-rc.0 → 2.6.1

package/src/services/goto/index.ts

@@ -0,0 +1,92 @@
+// Extensions
+import { Service } from '../service'
+
+// Utilities
+import * as easingPatterns from './easing-patterns'
+import {
+  getContainer,
+  getOffset,
+} from './util'
+
+// Types
+import { GoToOptions, KdutifyGoToTarget } from 'kdutify/types/services/goto'
+
+import { KdutifyServiceContract } from 'kdutify/types/services'
+
+export default function goTo (
+  _target: KdutifyGoToTarget,
+  _settings: GoToOptions = {}
+): Promise<number> {
+  const settings: GoToOptions = {
+    container: (document.scrollingElement as HTMLElement | null) || document.body || document.documentElement,
+    duration: 500,
+    offset: 0,
+    easing: 'easeInOutCubic',
+    appOffset: true,
+    ..._settings,
+  }
+  const container = getContainer(settings.container)
+
+  /* istanbul ignore else */
+  if (settings.appOffset && goTo.framework.application) {
+    const isDrawer = container.classList.contains('k-navigation-drawer')
+    const isClipped = container.classList.contains('k-navigation-drawer--clipped')
+    const { bar, top } = goTo.framework.application as any
+
+    settings.offset += bar
+    /* istanbul ignore else */
+    if (!isDrawer || isClipped) settings.offset += top
+  }
+
+  const startTime = performance.now()
+
+  let targetLocation: number
+  if (typeof _target === 'number') {
+    targetLocation = getOffset(_target) - settings.offset!
+  } else {
+    targetLocation = getOffset(_target) - getOffset(container) - settings.offset!
+  }
+
+  const startLocation = container.scrollTop
+  if (targetLocation === startLocation) return Promise.resolve(targetLocation)
+
+  const ease = typeof settings.easing === 'function'
+    ? settings.easing
+    : easingPatterns[settings.easing!]
+  /* istanbul ignore else */
+  if (!ease) throw new TypeError(`Easing function "${settings.easing}" not found.`)
+
+  // Cannot be tested properly in jsdom
+  /* istanbul ignore next */
+  return new Promise(resolve => requestAnimationFrame(function step (currentTime: number) {
+    const timeElapsed = currentTime - startTime
+    const progress = Math.abs(settings.duration ? Math.min(timeElapsed / settings.duration, 1) : 1)
+
+    container.scrollTop = Math.floor(startLocation + (targetLocation - startLocation) * ease(progress))
+
+    const clientHeight = container === document.body ? document.documentElement.clientHeight : container.clientHeight
+    const reachBottom = clientHeight + container.scrollTop >= container.scrollHeight
+    if (
+      progress === 1 ||
+      // Need to go lower but reach bottom
+      (targetLocation > container.scrollTop && reachBottom)
+    ) {
+      return resolve(targetLocation)
+    }
+
+    requestAnimationFrame(step)
+  }))
+}
+
+goTo.framework = {} as Record<string, KdutifyServiceContract>
+goTo.init = () => {}
+
+export class Goto extends Service {
+  public static property: 'goTo' = 'goTo'
+
+  constructor () {
+    super()
+
+    return goTo
+  }
+}

package/src/services/goto/util.ts

@@ -0,0 +1,49 @@
+import Kdu from 'kdu'
+
+// Return target's cumulative offset from the top
+export function getOffset (target: any): number {
+  if (typeof target === 'number') {
+    return target
+  }
+
+  let el = $(target)
+  if (!el) {
+    throw typeof target === 'string'
+      ? new Error(`Target element "${target}" not found.`)
+      : new TypeError(`Target must be a Number/Selector/HTMLElement/KduComponent, received ${type(target)} instead.`)
+  }
+
+  let totalOffset = 0
+  while (el) {
+    totalOffset += el.offsetTop
+    el = el.offsetParent as HTMLElement
+  }
+
+  return totalOffset
+}
+
+export function getContainer (container: any): HTMLElement {
+  const el = $(container)
+
+  if (el) return el
+
+  throw typeof container === 'string'
+    ? new Error(`Container element "${container}" not found.`)
+    : new TypeError(`Container must be a Selector/HTMLElement/KduComponent, received ${type(container)} instead.`)
+}
+
+function type (el: any) {
+  return el == null ? el : el.constructor.name
+}
+
+function $ (el: any): HTMLElement | null {
+  if (typeof el === 'string') {
+    return document.querySelector<HTMLElement>(el)
+  } else if (el && el._isKdu) {
+    return (el as Kdu).$el as HTMLElement
+  } else if (el instanceof HTMLElement) {
+    return el
+  } else {
+    return null
+  }
+}

package/src/services/icons/index.ts

@@ -0,0 +1,39 @@
+// Extensions
+import { Service } from '../service'
+
+// Utilities
+import { mergeDeep } from '../../util/helpers'
+
+// Types
+import { KdutifyPreset } from 'kdutify/types/services/presets'
+import { Icons as IIcons } from 'kdutify/types/services/icons'
+
+// Presets
+import presets from './presets'
+
+export class Icons extends Service implements IIcons {
+  static property: 'icons' = 'icons'
+
+  public iconfont: IIcons['iconfont']
+
+  public values: IIcons['values']
+
+  public component: IIcons['component']
+
+  constructor (preset: KdutifyPreset) {
+    super()
+
+    const {
+      iconfont,
+      values,
+      component,
+    } = preset[Icons.property]
+
+    this.component = component
+    this.iconfont = iconfont
+    this.values = mergeDeep(
+      presets[iconfont],
+      values
+    ) as IIcons['values']
+  }
+}

package/src/services/icons/presets/fa-svg.ts

@@ -0,0 +1,23 @@
+import { KdutifyIcons } from 'kdutify/types/services/icons'
+import { Component } from 'kdu'
+import icons from './fa'
+
+export function convertToComponentDeclarations (
+  component: Component | string,
+  iconSet: KdutifyIcons,
+) {
+  const result: Partial<KdutifyIcons> = {}
+
+  for (const key in iconSet) {
+    result[key] = {
+      component,
+      props: {
+        icon: (iconSet[key] as string).split(' fa-'),
+      },
+    }
+  }
+
+  return result as KdutifyIcons
+}
+
+export default convertToComponentDeclarations('font-awesome-icon', icons)

package/src/services/icons/presets/fa.ts

@@ -0,0 +1,39 @@
+import { KdutifyIcons } from 'kdutify/types/services/icons'
+
+const icons: KdutifyIcons = {
+  complete: 'fas fa-check',
+  cancel: 'fas fa-times-circle',
+  close: 'fas fa-times',
+  delete: 'fas fa-times-circle', // delete (e.g. k-chip close)
+  clear: 'fas fa-times-circle', // delete (e.g. k-chip close)
+  success: 'fas fa-check-circle',
+  info: 'fas fa-info-circle',
+  warning: 'fas fa-exclamation',
+  error: 'fas fa-exclamation-triangle',
+  prev: 'fas fa-chevron-left',
+  next: 'fas fa-chevron-right',
+  checkboxOn: 'fas fa-check-square',
+  checkboxOff: 'far fa-square', // note 'far'
+  checkboxIndeterminate: 'fas fa-minus-square',
+  delimiter: 'fas fa-circle', // for carousel
+  sort: 'fas fa-sort-up',
+  expand: 'fas fa-chevron-down',
+  menu: 'fas fa-bars',
+  subgroup: 'fas fa-caret-down',
+  dropdown: 'fas fa-caret-down',
+  radioOn: 'far fa-dot-circle',
+  radioOff: 'far fa-circle',
+  edit: 'fas fa-edit',
+  ratingEmpty: 'far fa-star',
+  ratingFull: 'fas fa-star',
+  ratingHalf: 'fas fa-star-half',
+  loading: 'fas fa-sync',
+  first: 'fas fa-step-backward',
+  last: 'fas fa-step-forward',
+  unfold: 'fas fa-arrows-alt-v',
+  file: 'fas fa-paperclip',
+  plus: 'fas fa-plus',
+  minus: 'fas fa-minus',
+}
+
+export default icons

package/src/services/icons/presets/fa4.ts

@@ -0,0 +1,39 @@
+import { KdutifyIcons } from 'kdutify/types/services/icons'
+
+const icons: KdutifyIcons = {
+  complete: 'fa fa-check',
+  cancel: 'fa fa-times-circle',
+  close: 'fa fa-times',
+  delete: 'fa fa-times-circle', // delete (e.g. k-chip close)
+  clear: 'fa fa-times-circle', // delete (e.g. k-chip close)
+  success: 'fa fa-check-circle',
+  info: 'fa fa-info-circle',
+  warning: 'fa fa-exclamation',
+  error: 'fa fa-exclamation-triangle',
+  prev: 'fa fa-chevron-left',
+  next: 'fa fa-chevron-right',
+  checkboxOn: 'fa fa-check-square',
+  checkboxOff: 'fa fa-square-o',
+  checkboxIndeterminate: 'fa fa-minus-square',
+  delimiter: 'fa fa-circle', // for carousel
+  sort: 'fa fa-sort-up',
+  expand: 'fa fa-chevron-down',
+  menu: 'fa fa-bars',
+  subgroup: 'fa fa-caret-down',
+  dropdown: 'fa fa-caret-down',
+  radioOn: 'fa fa-dot-circle-o',
+  radioOff: 'fa fa-circle-o',
+  edit: 'fa fa-pencil',
+  ratingEmpty: 'fa fa-star-o',
+  ratingFull: 'fa fa-star',
+  ratingHalf: 'fa fa-star-half-o',
+  loading: 'fa fa-refresh',
+  first: 'fa fa-step-backward',
+  last: 'fa fa-step-forward',
+  unfold: 'fa fa-angle-double-down',
+  file: 'fa fa-paperclip',
+  plus: 'fa fa-plus',
+  minus: 'fa fa-minus',
+}
+
+export default icons

package/src/services/icons/presets/index.ts

@@ -0,0 +1,15 @@
+import mdiSvg from './mdi-svg'
+import md from './md'
+import mdi from './mdi'
+import fa from './fa'
+import fa4 from './fa4'
+import faSvg from './fa-svg'
+
+export default Object.freeze({
+  mdiSvg,
+  md,
+  mdi,
+  fa,
+  fa4,
+  faSvg,
+})

package/src/services/icons/presets/md.ts

@@ -0,0 +1,39 @@
+import { KdutifyIcons } from 'kdutify/types/services/icons'
+
+const icons: KdutifyIcons = {
+  complete: 'check',
+  cancel: 'cancel',
+  close: 'close',
+  delete: 'cancel', // delete (e.g. k-chip close)
+  clear: 'clear',
+  success: 'check_circle',
+  info: 'info',
+  warning: 'priority_high',
+  error: 'warning',
+  prev: 'chevron_left',
+  next: 'chevron_right',
+  checkboxOn: 'check_box',
+  checkboxOff: 'check_box_outline_blank',
+  checkboxIndeterminate: 'indeterminate_check_box',
+  delimiter: 'fiber_manual_record', // for carousel
+  sort: 'arrow_upward',
+  expand: 'keyboard_arrow_down',
+  menu: 'menu',
+  subgroup: 'arrow_drop_down',
+  dropdown: 'arrow_drop_down',
+  radioOn: 'radio_button_checked',
+  radioOff: 'radio_button_unchecked',
+  edit: 'edit',
+  ratingEmpty: 'star_border',
+  ratingFull: 'star',
+  ratingHalf: 'star_half',
+  loading: 'cached',
+  first: 'first_page',
+  last: 'last_page',
+  unfold: 'unfold_more',
+  file: 'attach_file',
+  plus: 'add',
+  minus: 'remove',
+}
+
+export default icons

package/src/services/icons/presets/mdi-svg.ts

@@ -0,0 +1,39 @@
+import { KdutifyIcons } from 'kdutify/types/services/icons'
+
+const icons: KdutifyIcons = {
+  complete: 'M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z',
+  cancel: 'M12,2C17.53,2 22,6.47 22,12C22,17.53 17.53,22 12,22C6.47,22 2,17.53 2,12C2,6.47 6.47,2 12,2M15.59,7L12,10.59L8.41,7L7,8.41L10.59,12L7,15.59L8.41,17L12,13.41L15.59,17L17,15.59L13.41,12L17,8.41L15.59,7Z',
+  close: 'M19,6.41L17.59,5L12,10.59L6.41,5L5,6.41L10.59,12L5,17.59L6.41,19L12,13.41L17.59,19L19,17.59L13.41,12L19,6.41Z',
+  delete: 'M12,2C17.53,2 22,6.47 22,12C22,17.53 17.53,22 12,22C6.47,22 2,17.53 2,12C2,6.47 6.47,2 12,2M15.59,7L12,10.59L8.41,7L7,8.41L10.59,12L7,15.59L8.41,17L12,13.41L15.59,17L17,15.59L13.41,12L17,8.41L15.59,7Z', // delete (e.g. k-chip close)
+  clear: 'M19,6.41L17.59,5L12,10.59L6.41,5L5,6.41L10.59,12L5,17.59L6.41,19L12,13.41L17.59,19L19,17.59L13.41,12L19,6.41Z',
+  success: 'M12,2C17.52,2 22,6.48 22,12C22,17.52 17.52,22 12,22C6.48,22 2,17.52 2,12C2,6.48 6.48,2 12,2M11,16.5L18,9.5L16.59,8.09L11,13.67L7.91,10.59L6.5,12L11,16.5Z',
+  info: 'M13,9H11V7H13M13,17H11V11H13M12,2C6.48,2 2,6.48 2,12C2,17.52 6.48,22 12,22C17.52,22 22,17.52 22,12C22,6.48 17.52,2 12,2Z',
+  warning: 'M11,4.5H13V15.5H11V4.5M13,17.5V19.5H11V17.5H13Z',
+  error: 'M13,14H11V10H13M13,18H11V16H13M1,21H23L12,2L1,21Z',
+  prev: 'M15.41,16.58L10.83,12L15.41,7.41L14,6L8,12L14,18L15.41,16.58Z',
+  next: 'M8.59,16.58L13.17,12L8.59,7.41L10,6L16,12L10,18L8.59,16.58Z',
+  checkboxOn: 'M10,17L5,12L6.41,10.58L10,14.17L17.59,6.58L19,8M19,3H5C3.89,3 3,3.89 3,5V19C3,20.1 3.9,21 5,21H19C20.1,21 21,20.1 21,19V5C21,3.89 20.1,3 19,3Z',
+  checkboxOff: 'M19,3H5C3.89,3 3,3.89 3,5V19C3,20.1 3.9,21 5,21H19C20.1,21 21,20.1 21,19V5C21,3.89 20.1,3 19,3M19,5V19H5V5H19Z',
+  checkboxIndeterminate: 'M17,13H7V11H17M19,3H5C3.89,3 3,3.89 3,5V19C3,20.1 3.9,21 5,21H19C20.1,21 21,20.1 21,19V5C21,3.89 20.1,3 19,3Z',
+  delimiter: 'M12,2C6.48,2 2,6.48 2,12C2,17.52 6.48,22 12,22C17.52,22 22,17.52 22,12C22,6.48 17.52,2 12,2Z', // for carousel
+  sort: 'M13,20H11V8L5.5,13.5L4.08,12.08L12,4.16L19.92,12.08L18.5,13.5L13,8V20Z',
+  expand: 'M7.41,8.58L12,13.17L16.59,8.58L18,10L12,16L6,10L7.41,8.58Z',
+  menu: 'M3,6H21V8H3V6M3,11H21V13H3V11M3,16H21V18H3V16Z',
+  subgroup: 'M7,10L12,15L17,10H7Z',
+  dropdown: 'M7,10L12,15L17,10H7Z',
+  radioOn: 'M12,20C7.58,20 4,16.42 4,12C4,7.58 7.58,4 12,4C16.42,4 20,7.58 20,12C20,16.42 16.42,20 12,20M12,2C6.48,2 2,6.48 2,12C2,17.52 6.48,22 12,22C17.52,22 22,17.52 22,12C22,6.48 17.52,2 12,2M12,7C9.24,7 7,9.24 7,12C7,14.76 9.24,17 12,17C14.76,17 17,14.76 17,12C17,9.24 14.76,7 12,7Z',
+  radioOff: 'M12,20C7.58,20 4,16.42 4,12C4,7.58 7.58,4 12,4C16.42,4 20,7.58 20,12C20,16.42 16.42,20 12,20M12,2C6.48,2 2,6.48 2,12C2,17.52 6.48,22 12,22C17.52,22 22,17.52 22,12C22,6.48 17.52,2 12,2Z',
+  edit: 'M20.71,7.04C21.1,6.65 21.1,6 20.71,5.63L18.37,3.29C18,2.9 17.35,2.9 16.96,3.29L15.12,5.12L18.87,8.87M3,17.25V21H6.75L17.81,9.93L14.06,6.18L3,17.25Z',
+  ratingEmpty: 'M12,15.39L8.24,17.66L9.23,13.38L5.91,10.5L10.29,10.13L12,6.09L13.71,10.13L18.09,10.5L14.77,13.38L15.76,17.66M22,9.24L14.81,8.63L12,2L9.19,8.63L2,9.24L7.45,13.97L5.82,21L12,17.27L18.18,21L16.54,13.97L22,9.24Z',
+  ratingFull: 'M12,17.27L18.18,21L16.54,13.97L22,9.24L14.81,8.62L12,2L9.19,8.62L2,9.24L7.45,13.97L5.82,21L12,17.27Z',
+  ratingHalf: 'M12,15.4V6.1L13.71,10.13L18.09,10.5L14.77,13.39L15.76,17.67M22,9.24L14.81,8.63L12,2L9.19,8.63L2,9.24L7.45,13.97L5.82,21L12,17.27L18.18,21L16.54,13.97L22,9.24Z',
+  loading: 'M19,8L15,12H18C18,15.31 15.31,18 12,18C11,18 10.03,17.75 9.2,17.3L7.74,18.76C8.97,19.54 10.43,20 12,20C16.42,20 20,16.42 20,12H23M6,12C6,8.69 8.69,6 12,6C13,6 13.97,6.25 14.8,6.7L16.26,5.24C15.03,4.46 13.57,4 12,4C7.58,4 4,7.58 4,12H1L5,16L9,12',
+  first: 'M18.41,16.59L13.82,12L18.41,7.41L17,6L11,12L17,18L18.41,16.59M6,6H8V18H6V6Z',
+  last: 'M5.59,7.41L10.18,12L5.59,16.59L7,18L13,12L7,6L5.59,7.41M16,6H18V18H16V6Z',
+  unfold: 'M12,18.17L8.83,15L7.42,16.41L12,21L16.59,16.41L15.17,15M12,5.83L15.17,9L16.58,7.59L12,3L7.41,7.59L8.83,9L12,5.83Z',
+  file: 'M16.5,6V17.5C16.5,19.71 14.71,21.5 12.5,21.5C10.29,21.5 8.5,19.71 8.5,17.5V5C8.5,3.62 9.62,2.5 11,2.5C12.38,2.5 13.5,3.62 13.5,5V15.5C13.5,16.05 13.05,16.5 12.5,16.5C11.95,16.5 11.5,16.05 11.5,15.5V6H10V15.5C10,16.88 11.12,18 12.5,18C13.88,18 15,16.88 15,15.5V5C15,2.79 13.21,1 11,1C8.79,1 7,2.79 7,5V17.5C7,20.54 9.46,23 12.5,23C15.54,23 18,20.54 18,17.5V6H16.5Z',
+  plus: 'M19,13H13V19H11V13H5V11H11V5H13V11H19V13Z',
+  minus: 'M19,13H5V11H19V13Z',
+}
+
+export default icons

package/src/services/icons/presets/mdi.ts

@@ -0,0 +1,39 @@
+import { KdutifyIcons } from 'kdutify/types/services/icons'
+
+const icons: KdutifyIcons = {
+  complete: 'mdi-check',
+  cancel: 'mdi-close-circle',
+  close: 'mdi-close',
+  delete: 'mdi-close-circle', // delete (e.g. k-chip close)
+  clear: 'mdi-close',
+  success: 'mdi-check-circle',
+  info: 'mdi-information',
+  warning: 'mdi-exclamation',
+  error: 'mdi-alert',
+  prev: 'mdi-chevron-left',
+  next: 'mdi-chevron-right',
+  checkboxOn: 'mdi-checkbox-marked',
+  checkboxOff: 'mdi-checkbox-blank-outline',
+  checkboxIndeterminate: 'mdi-minus-box',
+  delimiter: 'mdi-circle', // for carousel
+  sort: 'mdi-arrow-up',
+  expand: 'mdi-chevron-down',
+  menu: 'mdi-menu',
+  subgroup: 'mdi-menu-down',
+  dropdown: 'mdi-menu-down',
+  radioOn: 'mdi-radiobox-marked',
+  radioOff: 'mdi-radiobox-blank',
+  edit: 'mdi-pencil',
+  ratingEmpty: 'mdi-star-outline',
+  ratingFull: 'mdi-star',
+  ratingHalf: 'mdi-star-half-full',
+  loading: 'mdi-cached',
+  first: 'mdi-page-first',
+  last: 'mdi-page-last',
+  unfold: 'mdi-unfold-more-horizontal',
+  file: 'mdi-paperclip',
+  plus: 'mdi-plus',
+  minus: 'mdi-minus',
+}
+
+export default icons

package/src/services/index.ts

@@ -0,0 +1,7 @@
+export * from './application'
+export * from './breakpoint'
+export * from './goto'
+export * from './icons'
+export * from './lang'
+export * from './presets'
+export * from './theme'

package/src/services/lang/index.ts

@@ -0,0 +1,88 @@
+// Extensions
+import { Service } from '../service'
+
+// Utilities
+import { getObjectValueByPath } from '../../util/helpers'
+import { consoleError, consoleWarn } from '../../util/console'
+
+// Types
+import { KdutifyPreset } from 'kdutify/types/services/presets'
+import {
+  KdutifyLocale,
+  Lang as ILang,
+} from 'kdutify/types/services/lang'
+
+const LANG_PREFIX = '$kdutify.'
+const fallback = Symbol('Lang fallback')
+
+function getTranslation (
+  locale: KdutifyLocale,
+  key: string,
+  usingDefault = false,
+  defaultLocale: KdutifyLocale
+): string {
+  const shortKey = key.replace(LANG_PREFIX, '')
+  let translation = getObjectValueByPath(locale, shortKey, fallback) as string | typeof fallback
+
+  if (translation === fallback) {
+    if (usingDefault) {
+      consoleError(`Translation key "${shortKey}" not found in fallback`)
+      translation = key
+    } else {
+      consoleWarn(`Translation key "${shortKey}" not found, falling back to default`)
+      translation = getTranslation(defaultLocale, key, true, defaultLocale)
+    }
+  }
+
+  return translation
+}
+
+export class Lang extends Service implements ILang {
+  static property: 'lang' = 'lang'
+
+  public current: ILang['current']
+
+  public defaultLocale = 'en'
+
+  public locales: ILang['locales']
+
+  private translator: ILang['t']
+
+  constructor (preset: KdutifyPreset) {
+    super()
+
+    const {
+      current,
+      locales,
+      t,
+    } = preset[Lang.property]
+
+    this.current = current
+    this.locales = locales
+    this.translator = t || this.defaultTranslator
+  }
+
+  public currentLocale (key: string) {
+    const translation = this.locales[this.current]
+    const defaultLocale = this.locales[this.defaultLocale]
+
+    return getTranslation(translation, key, false, defaultLocale)
+  }
+
+  public t (key: string, ...params: any[]) {
+    if (!key.startsWith(LANG_PREFIX)) return this.replace(key, params)
+
+    return this.translator(key, ...params)
+  }
+
+  private defaultTranslator (key: string, ...params: any[]) {
+    return this.replace(this.currentLocale(key), params)
+  }
+
+  private replace (str: string, params: any[]) {
+    return str.replace(/\{(\d+)\}/g, (match: string, index: string) => {
+      /* istanbul ignore next */
+      return String(params[+index])
+    })
+  }
+}

package/src/services/presets/index.ts

@@ -0,0 +1,44 @@
+// Preset
+import { preset as Preset } from '../../presets/default'
+
+// Utilities
+import { consoleWarn } from '../../util/console'
+import { mergeDeep } from '../../util/helpers'
+
+// Types
+import Kdutify from 'kdutify/types'
+import { Service } from '../service'
+import {
+  UserKdutifyPreset,
+  KdutifyPreset,
+} from 'kdutify/types/services/presets'
+
+export class Presets extends Service {
+  static property: 'presets' = 'presets'
+
+  constructor (
+    parentPreset: Partial<UserKdutifyPreset>,
+    parent: Kdutify,
+  ) {
+    super()
+
+    // The default preset
+    const defaultPreset = mergeDeep({}, Preset)
+    // The user provided preset
+    const { userPreset } = parent
+    // The user provided global preset
+    const {
+      preset: globalPreset = {},
+      ...preset
+    } = userPreset
+
+    if (globalPreset.preset != null) {
+      consoleWarn('Global presets do not support the **preset** option, it can be safely omitted')
+    }
+
+    parent.preset = mergeDeep(
+      mergeDeep(defaultPreset, globalPreset),
+      preset
+    ) as KdutifyPreset
+  }
+}

package/src/services/service/index.ts

@@ -0,0 +1,11 @@
+// Contracts
+import { KdutifyServiceContract } from 'kdutify/types/services/index'
+
+// Types
+import Kdu from 'kdu'
+
+export class Service implements KdutifyServiceContract {
+  framework = {}
+
+  init (root: Kdu, ssrContext?: object) {}
+}