@code-coaching/vuetiful 0.3.0 → 0.4.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@code-coaching/vuetiful",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "scripts": {
     "dev": "onchange 'src/**/*.vue' 'src/**/*.ts' 'src/**/*.css' -- npm run build",
     "prebuild": "node 'scripts/intellisense.js'",

package/src/components/index.ts

@@ -1,4 +1,4 @@
 import { VButton } from "./atoms";
-import { VRail, VRailTile, VShell } from "./molecules";
+import { VDrawer, VRail, VRailTile, VShell } from "./molecules";
 
-export { VButton, VRail, VRailTile, VShell };
+export { VButton, VRail, VRailTile, VShell, VDrawer };

package/src/components/molecules/VDrawer.vue

@@ -0,0 +1,97 @@
+<script setup lang="ts">
+import type { CssClasses } from "@/index";
+import { useDrawer } from "@/services";
+import { Ref, computed, onMounted, ref, toRefs, useAttrs } from "vue";
+
+const { drawer, close } = useDrawer();
+const attrs = useAttrs();
+
+// #region Props
+const props = defineProps({
+  position: {
+    type: String as () => "left" | "top" | "right" | "bottom",
+    default: "left",
+  },
+  duration: {
+    type: Number as () => 150 | 300,
+    default: 300,
+  },
+
+  // Regions
+  regionBackdrop: {
+    type: String as () => CssClasses,
+    default: "",
+  },
+  regionDrawer: {
+    type: String as () => CssClasses,
+    default: "",
+  },
+
+  // a11y
+  labelledby: {
+    type: String,
+    default: "",
+  },
+  describedby: {
+    type: String,
+    default: "",
+  },
+});
+
+// prettier-ignore
+const { position, duration, regionBackdrop, regionDrawer, labelledby, describedby } = toRefs(props);
+// prettier-ignore
+const presets = {
+	top: { alignment: 'top-0', width: 'w-full', height: 'h-[50%]', rounded: 'rounded-bl-container-token rounded-br-container-token' },
+	bottom: { alignment: 'bottom-0', width: 'w-full', height: ' h-[50%]', rounded: 'rounded-tl-container-token rounded-tr-container-token' },
+	left: { alignment: 'lef-0', width: 'w-[90%]', height: 'h-full', rounded: 'rounded-tr-container-token rounded-br-container-token' },
+	right: { alignment: 'right-0', width: 'w-[90%]', height: 'h-full', rounded: 'rounded-tl-container-token rounded-bl-container-token' }
+};
+const preset = computed(() => presets[position.value]);
+// #endregion
+
+// #region template refs
+const elemBackdrop: Ref<HTMLElement> = ref() as Ref<HTMLElement>;
+const elemDrawer: Ref<HTMLElement> = ref() as Ref<HTMLElement>;
+// #endregion
+
+// #region Event Handlers
+const onBackdropInteraction = (event: Event) => {
+  if (event.target === elemBackdrop.value) close();
+};
+
+const onKeydownWindow = (event: KeyboardEvent) => {
+  if (event.code === "Escape") close();
+};
+onMounted(() => {
+  window.addEventListener("keydown", onKeydownWindow);
+});
+// #endregion
+</script>
+
+<template>
+  <transition :name="`slide-${position}-${duration}`">
+    <div
+      v-if="drawer.open"
+      ref="elemDrawer"
+      :class="`drawer absolute overflow-y-auto shadow-xl transition-transform bg-surface-100-800-token ${preset.width} ${preset.height} ${preset.rounded} ${preset.alignment} z-50 ${regionDrawer}`"
+      role="dialog"
+      aria-modal="true"
+      :aria-labelledby="labelledby"
+      :aria-describedby="describedby"
+    >
+      <slot />
+    </div>
+  </transition>
+  <transition :name="`fade-${duration}`">
+    <div
+      v-if="drawer.open"
+      ref="elemBackdrop"
+      :class="`drawer-backdrop backdrop-blur-xs fixed top-0 left-0 right-0 bottom-0 flex bg-surface-backdrop-token ${regionBackdrop} z-40 ${
+        attrs.class ?? ''
+      }`"
+      @mousedown="onBackdropInteraction"
+      @touchstart="onBackdropInteraction"
+    ></div>
+  </transition>
+</template>

package/src/components/molecules/VRailTile.vue

@@ -37,7 +37,7 @@ const { selectedRailTile } = useRail();
 const active = inject("active");
 const hover = inject("hover");
 
-const onClickHandler = (event: MouseEvent) => {
+const onClickHandler = () => {
   if (!props.value) return;
   selectedRailTile.value = props.value;
   emit("click");
@@ -51,10 +51,7 @@ const onKeyHandler = (event: KeyboardEvent) => {
 </script>
 
 <template>
-  <div
-    @click="onClickHandler"
-    @keydown="onKeyHandler"
-  >
+  <div @click="onClickHandler" @keydown="onKeyHandler">
     <component
       :is="tag"
       v-bind="attrs"

package/src/components/molecules/VShell.vue

@@ -41,7 +41,7 @@ const attrs = useAttrs();
           v-if="$slots.pageHeader"
           :class="`vuetiful-page-header flex-none ${slotPageHeader}`"
         >
-          <slot name="pageHeader">(slot:header)</slot>
+          <slot name="pageHeader" />
         </header>
 
         <main :class="`vuetiful-page-content flex-auto ${slotPageContent}`">
@@ -52,7 +52,7 @@ const attrs = useAttrs();
           v-if="$slots.pageFooter"
           :class="`vuetiful-page-footer flex-none ${slotPageFooter}`"
         >
-          <slot name="pageFooter">(slot:footer)</slot>
+          <slot name="pageFooter" />
         </footer>
       </div>
 

package/src/components/molecules/index.ts

@@ -1,5 +1,6 @@
+import VDrawer from "./VDrawer.vue";
 import VRail from "./VRail.vue";
 import VRailTile from "./VRailTile.vue";
 import VShell from "./VShell.vue";
 
-export { VRail, VRailTile, VShell };
+export { VRail, VRailTile, VShell, VDrawer };

package/src/services/drawer.service.ts

@@ -0,0 +1,43 @@
+import { reactive, readonly } from 'vue';
+
+export interface DrawerSettings {
+  id?: string;
+  open?: boolean;
+
+  position?: 'left' | 'top' | 'right' | 'bottom';
+  duration?: 150 | 300;
+
+  regionBackdrop?: string;
+  regionDrawer?: string;
+
+  [key: string]: unknown;
+}
+
+const drawer = reactive<DrawerSettings>({
+  id: 'default',
+  open: false,
+});
+
+const useDrawer = () => {
+  const open = (settings?: DrawerSettings) => {
+    drawer.open = true;
+    if (settings) {
+      Object.keys(settings).forEach((key: string) => {
+        drawer[key] = settings[key];
+      });
+    }
+  };
+
+  const close = () => (drawer.open = false);
+
+  const toggle = () => (drawer.open = !drawer.open);
+
+  return {
+    drawer: readonly(drawer),
+    open,
+    close,
+    toggle,
+  };
+};
+
+export { useDrawer };

package/src/services/index.ts

@@ -1,3 +1,4 @@
 import { useRail } from "./rail.service";
+import { useDrawer } from "./drawer.service";
 
-export { useRail };
+export { useRail, useDrawer };