@aleph-alpha/ui-library 1.12.0 → 1.14.0

package/src/components/core/sidebar/SidebarGroupLabel.vue

@@ -0,0 +1,23 @@
+<script setup lang="ts">
+  import { Primitive } from 'reka-ui';
+  import { cn } from '@/lib/utils';
+
+  defineOptions({ inheritAttrs: false });
+</script>
+
+<template>
+  <Primitive
+    v-bind="$attrs"
+    data-slot="sidebar-group-label"
+    data-sidebar="group-label"
+    :class="
+      cn(
+        'text-sidebar-foreground/70 ring-sidebar-ring flex h-8 shrink-0 items-center rounded-md px-2 text-xs font-medium outline-hidden transition-[margin,opacity] duration-200 ease-linear focus-visible:ring-2 [&>svg]:size-4 [&>svg]:shrink-0',
+        'group-data-[collapsible=icon]:-mt-8 group-data-[collapsible=icon]:opacity-0',
+        $attrs.class ?? '',
+      )
+    "
+  >
+    <slot />
+  </Primitive>
+</template>

package/src/components/core/sidebar/SidebarHeader.vue

@@ -0,0 +1,16 @@
+<script setup lang="ts">
+  import { cn } from '@/lib/utils';
+
+  defineOptions({ inheritAttrs: false });
+</script>
+
+<template>
+  <div
+    v-bind="$attrs"
+    data-slot="sidebar-header"
+    data-sidebar="header"
+    :class="cn('flex flex-col gap-2 p-2', $attrs.class ?? '')"
+  >
+    <slot />
+  </div>
+</template>

package/src/components/core/sidebar/SidebarInput.vue

@@ -0,0 +1,17 @@
+<script setup lang="ts">
+  import { cn } from '@/lib/utils';
+  import { Input } from '@/components/core/input';
+
+  defineOptions({ inheritAttrs: false });
+</script>
+
+<template>
+  <Input
+    v-bind="$attrs"
+    data-slot="sidebar-input"
+    data-sidebar="input"
+    :class="cn('bg-background h-8 w-full shadow-none', $attrs.class ?? '')"
+  >
+    <slot />
+  </Input>
+</template>

package/src/components/core/sidebar/SidebarInset.vue

@@ -0,0 +1,21 @@
+<script setup lang="ts">
+  import { cn } from '@/lib/utils';
+
+  defineOptions({ inheritAttrs: false });
+</script>
+
+<template>
+  <main
+    v-bind="$attrs"
+    data-slot="sidebar-inset"
+    :class="
+      cn(
+        'bg-background relative flex w-full flex-1 flex-col',
+        'md:peer-data-[variant=inset]:m-2 md:peer-data-[variant=inset]:ml-0 md:peer-data-[variant=inset]:rounded-xl md:peer-data-[variant=inset]:shadow-sm md:peer-data-[variant=inset]:peer-data-[state=collapsed]:ml-2',
+        $attrs.class ?? '',
+      )
+    "
+  >
+    <slot />
+  </main>
+</template>

package/src/components/core/sidebar/SidebarMenu.vue

@@ -0,0 +1,16 @@
+<script setup lang="ts">
+  import { cn } from '@/lib/utils';
+
+  defineOptions({ inheritAttrs: false });
+</script>
+
+<template>
+  <ul
+    v-bind="$attrs"
+    data-slot="sidebar-menu"
+    data-sidebar="menu"
+    :class="cn('flex w-full min-w-0 flex-col gap-1', $attrs.class ?? '')"
+  >
+    <slot />
+  </ul>
+</template>

package/src/components/core/sidebar/SidebarMenuAction.vue

@@ -0,0 +1,33 @@
+<script setup lang="ts">
+  import { Primitive } from 'reka-ui';
+  import { cn } from '@/lib/utils';
+
+  defineOptions({ inheritAttrs: false });
+
+  const props = defineProps<{
+    showOnHover?: boolean;
+  }>();
+</script>
+
+<template>
+  <Primitive
+    v-bind="{ as: 'button', ...$attrs }"
+    data-slot="sidebar-menu-action"
+    data-sidebar="menu-action"
+    :class="
+      cn(
+        'text-sidebar-foreground ring-sidebar-ring hover:bg-sidebar-accent hover:text-sidebar-accent-foreground peer-hover/menu-button:text-sidebar-accent-foreground absolute top-1.5 right-1 flex aspect-square w-5 items-center justify-center rounded-md p-0 outline-hidden transition-transform focus-visible:ring-2 [&>svg]:size-4 [&>svg]:shrink-0',
+        'after:absolute after:-inset-2 md:after:hidden',
+        'peer-data-[size=sm]/menu-button:top-1',
+        'peer-data-[size=default]/menu-button:top-1.5',
+        'peer-data-[size=lg]/menu-button:top-2.5',
+        'group-data-[collapsible=icon]:hidden',
+        showOnHover &&
+          'peer-data-[active=true]/menu-button:text-sidebar-accent-foreground group-focus-within/menu-item:opacity-100 group-hover/menu-item:opacity-100 data-[state=open]:opacity-100 md:opacity-0',
+        $attrs.class ?? '',
+      )
+    "
+  >
+    <slot />
+  </Primitive>
+</template>

package/src/components/core/sidebar/SidebarMenuBadge.vue

@@ -0,0 +1,26 @@
+<script setup lang="ts">
+  import { cn } from '@/lib/utils';
+
+  defineOptions({ inheritAttrs: false });
+</script>
+
+<template>
+  <div
+    v-bind="$attrs"
+    data-slot="sidebar-menu-badge"
+    data-sidebar="menu-badge"
+    :class="
+      cn(
+        'text-sidebar-foreground pointer-events-none absolute right-1 flex h-5 min-w-5 items-center justify-center rounded-md px-1 text-xs font-medium tabular-nums select-none',
+        'peer-hover/menu-button:text-sidebar-accent-foreground peer-data-[active=true]/menu-button:text-sidebar-accent-foreground',
+        'peer-data-[size=sm]/menu-button:top-1',
+        'peer-data-[size=default]/menu-button:top-1.5',
+        'peer-data-[size=lg]/menu-button:top-2.5',
+        'group-data-[collapsible=icon]:hidden',
+        $attrs.class ?? '',
+      )
+    "
+  >
+    <slot />
+  </div>
+</template>

package/src/components/core/sidebar/SidebarMenuButton.vue

@@ -0,0 +1,49 @@
+<script setup lang="ts">
+  import type { Component } from 'vue';
+  import type { SidebarMenuButtonProps } from './SidebarMenuButtonChild.vue';
+  import { reactiveOmit } from '@vueuse/core';
+  import { Tooltip, TooltipContent, TooltipTrigger } from '@/components/core/tooltip';
+  import SidebarMenuButtonChild from './SidebarMenuButtonChild.vue';
+  import { useSidebar } from './utils';
+
+  defineOptions({
+    inheritAttrs: false,
+  });
+
+  const props = withDefaults(
+    defineProps<
+      SidebarMenuButtonProps & {
+        tooltip?: string | Component;
+      }
+    >(),
+    {
+      as: 'button',
+      variant: 'default',
+      size: 'default',
+    },
+  );
+
+  const { isMobile, state } = useSidebar();
+
+  const delegatedProps = reactiveOmit(props, 'tooltip');
+</script>
+
+<template>
+  <SidebarMenuButtonChild v-if="!tooltip" v-bind="{ ...delegatedProps, ...$attrs }">
+    <slot />
+  </SidebarMenuButtonChild>
+
+  <Tooltip v-else>
+    <TooltipTrigger as-child>
+      <SidebarMenuButtonChild v-bind="{ ...delegatedProps, ...$attrs }">
+        <slot />
+      </SidebarMenuButtonChild>
+    </TooltipTrigger>
+    <TooltipContent side="right" align="center" :hidden="state !== 'collapsed' || isMobile">
+      <template v-if="typeof tooltip === 'string'">
+        {{ tooltip }}
+      </template>
+      <component :is="tooltip" v-else />
+    </TooltipContent>
+  </Tooltip>
+</template>

package/src/components/core/sidebar/SidebarMenuButtonChild.vue

@@ -0,0 +1,36 @@
+<script setup lang="ts">
+  import type { PrimitiveProps } from 'reka-ui';
+  import type { SidebarMenuButtonVariants } from '.';
+  import { Primitive } from 'reka-ui';
+  import { cn } from '@/lib/utils';
+  import { sidebarMenuButtonVariants } from '.';
+
+  defineOptions({ inheritAttrs: false });
+
+  export interface SidebarMenuButtonProps extends PrimitiveProps {
+    variant?: SidebarMenuButtonVariants['variant'];
+    size?: SidebarMenuButtonVariants['size'];
+    isActive?: boolean;
+  }
+
+  const props = withDefaults(defineProps<SidebarMenuButtonProps>(), {
+    as: 'button',
+    variant: 'default',
+    size: 'default',
+  });
+</script>
+
+<template>
+  <Primitive
+    v-bind="$attrs"
+    data-slot="sidebar-menu-button"
+    data-sidebar="menu-button"
+    :data-size="size"
+    :data-active="isActive"
+    :class="cn(sidebarMenuButtonVariants({ variant, size }), $attrs.class ?? '')"
+    :as="as"
+    :as-child="asChild"
+  >
+    <slot />
+  </Primitive>
+</template>

package/src/components/core/sidebar/SidebarMenuItem.vue

@@ -0,0 +1,16 @@
+<script setup lang="ts">
+  import { cn } from '@/lib/utils';
+
+  defineOptions({ inheritAttrs: false });
+</script>
+
+<template>
+  <li
+    v-bind="$attrs"
+    data-slot="sidebar-menu-item"
+    data-sidebar="menu-item"
+    :class="cn('group/menu-item relative', $attrs.class ?? '')"
+  >
+    <slot />
+  </li>
+</template>

package/src/components/core/sidebar/SidebarMenuSkeleton.vue

@@ -0,0 +1,32 @@
+<script setup lang="ts">
+  import { computed } from 'vue';
+  import { cn } from '@/lib/utils';
+  import { Skeleton } from '@/components/core/skeleton';
+
+  defineOptions({ inheritAttrs: false });
+
+  const props = defineProps<{
+    showIcon?: boolean;
+  }>();
+
+  const width = computed(() => {
+    return `${Math.floor(Math.random() * 40) + 50}%`;
+  });
+</script>
+
+<template>
+  <div
+    v-bind="$attrs"
+    data-slot="sidebar-menu-skeleton"
+    data-sidebar="menu-skeleton"
+    :class="cn('flex h-8 items-center gap-2 rounded-md px-2', $attrs.class ?? '')"
+  >
+    <Skeleton v-if="showIcon" class="size-4 rounded-md" data-sidebar="menu-skeleton-icon" />
+
+    <Skeleton
+      class="h-4 max-w-(--skeleton-width) flex-1"
+      data-sidebar="menu-skeleton-text"
+      :style="{ '--skeleton-width': width }"
+    />
+  </div>
+</template>

package/src/components/core/sidebar/SidebarMenuSub.vue

@@ -0,0 +1,22 @@
+<script setup lang="ts">
+  import { cn } from '@/lib/utils';
+
+  defineOptions({ inheritAttrs: false });
+</script>
+
+<template>
+  <ul
+    v-bind="$attrs"
+    data-slot="sidebar-menu-sub"
+    data-sidebar="menu-sub"
+    :class="
+      cn(
+        'border-sidebar-border mx-3.5 flex min-w-0 translate-x-px flex-col gap-1 border-l px-2.5 py-0.5',
+        'group-data-[collapsible=icon]:hidden',
+        $attrs.class ?? '',
+      )
+    "
+  >
+    <slot />
+  </ul>
+</template>

package/src/components/core/sidebar/SidebarMenuSubButton.vue

@@ -0,0 +1,38 @@
+<script setup lang="ts">
+  import { Primitive } from 'reka-ui';
+  import { cn } from '@/lib/utils';
+
+  defineOptions({ inheritAttrs: false });
+
+  const props = withDefaults(
+    defineProps<{
+      size?: 'sm' | 'md';
+      isActive?: boolean;
+    }>(),
+    {
+      size: 'md',
+    },
+  );
+</script>
+
+<template>
+  <Primitive
+    v-bind="{ as: 'a', ...$attrs }"
+    data-slot="sidebar-menu-sub-button"
+    data-sidebar="menu-sub-button"
+    :data-size="size"
+    :data-active="isActive"
+    :class="
+      cn(
+        'text-sidebar-foreground ring-sidebar-ring hover:bg-sidebar-accent hover:text-sidebar-accent-foreground active:bg-sidebar-accent active:text-sidebar-accent-foreground [&>svg]:text-sidebar-accent-foreground flex h-7 min-w-0 -translate-x-px items-center gap-2 overflow-hidden rounded-md px-2 outline-hidden focus-visible:ring-2 disabled:pointer-events-none disabled:opacity-50 aria-disabled:pointer-events-none aria-disabled:opacity-50 [&>span:last-child]:truncate [&>svg]:size-4 [&>svg]:shrink-0',
+        'data-[active=true]:bg-sidebar-accent data-[active=true]:text-sidebar-accent-foreground',
+        size === 'sm' && 'text-xs',
+        size === 'md' && 'text-sm',
+        'group-data-[collapsible=icon]:hidden',
+        $attrs.class ?? '',
+      )
+    "
+  >
+    <slot />
+  </Primitive>
+</template>

package/src/components/core/sidebar/SidebarMenuSubItem.vue

@@ -0,0 +1,16 @@
+<script setup lang="ts">
+  import { cn } from '@/lib/utils';
+
+  defineOptions({ inheritAttrs: false });
+</script>
+
+<template>
+  <li
+    v-bind="$attrs"
+    data-slot="sidebar-menu-sub-item"
+    data-sidebar="menu-sub-item"
+    :class="cn('group/menu-sub-item relative', $attrs.class ?? '')"
+  >
+    <slot />
+  </li>
+</template>

package/src/components/core/sidebar/SidebarProvider.vue

@@ -0,0 +1,102 @@
+<script setup lang="ts">
+  import type { Ref } from 'vue';
+  import { defaultDocument, useEventListener, useMediaQuery, useVModel } from '@vueuse/core';
+  import { TooltipProvider } from 'reka-ui';
+  import { computed, ref } from 'vue';
+  import { cn } from '@/lib/utils';
+  import {
+    provideSidebarContext,
+    SIDEBAR_COOKIE_MAX_AGE,
+    SIDEBAR_COOKIE_NAME,
+    SIDEBAR_KEYBOARD_SHORTCUT,
+    SIDEBAR_WIDTH,
+    SIDEBAR_WIDTH_ICON,
+  } from './utils';
+
+  defineOptions({ inheritAttrs: false });
+
+  const props = withDefaults(
+    defineProps<{
+      defaultOpen?: boolean;
+      open?: boolean;
+    }>(),
+    {
+      defaultOpen: !defaultDocument?.cookie.includes(`${SIDEBAR_COOKIE_NAME}=false`),
+      open: undefined,
+    },
+  );
+
+  const emits = defineEmits<{
+    'update:open': [open: boolean];
+  }>();
+
+  const isMobile = useMediaQuery('(max-width: 768px)');
+  const openMobile = ref(false);
+
+  const open = useVModel(props, 'open', emits, {
+    defaultValue: props.defaultOpen ?? false,
+    // Cast required: useVModel overloads discriminate on the literal type of `passive`.
+    // At runtime this evaluates to `true` (uncontrolled) when `open` prop is omitted.
+    passive: (props.open === undefined) as false,
+  }) as Ref<boolean>;
+
+  function setOpen(value: boolean) {
+    open.value = value; // emits('update:open', value)
+
+    // This sets the cookie to keep the sidebar state.
+    if (defaultDocument) {
+      defaultDocument.cookie = `${SIDEBAR_COOKIE_NAME}=${open.value}; path=/; max-age=${SIDEBAR_COOKIE_MAX_AGE}`;
+    }
+  }
+
+  function setOpenMobile(value: boolean) {
+    openMobile.value = value;
+  }
+
+  // Helper to toggle the sidebar.
+  function toggleSidebar() {
+    return isMobile.value ? setOpenMobile(!openMobile.value) : setOpen(!open.value);
+  }
+
+  useEventListener('keydown', (event: KeyboardEvent) => {
+    if (event.key === SIDEBAR_KEYBOARD_SHORTCUT && (event.metaKey || event.ctrlKey)) {
+      event.preventDefault();
+      toggleSidebar();
+    }
+  });
+
+  // We add a state so that we can do data-state="expanded" or "collapsed".
+  // This makes it easier to style the sidebar with Tailwind classes.
+  const state = computed(() => (open.value ? 'expanded' : 'collapsed'));
+
+  provideSidebarContext({
+    state,
+    open,
+    setOpen,
+    isMobile,
+    openMobile,
+    setOpenMobile,
+    toggleSidebar,
+  });
+</script>
+
+<template>
+  <TooltipProvider :delay-duration="0">
+    <div
+      v-bind="$attrs"
+      data-slot="sidebar-wrapper"
+      :style="{
+        '--sidebar-width': SIDEBAR_WIDTH,
+        '--sidebar-width-icon': SIDEBAR_WIDTH_ICON,
+      }"
+      :class="
+        cn(
+          'group/sidebar-wrapper has-data-[variant=inset]:bg-sidebar flex min-h-svh w-full',
+          $attrs.class ?? '',
+        )
+      "
+    >
+      <slot />
+    </div>
+  </TooltipProvider>
+</template>

package/src/components/core/sidebar/SidebarRail.vue

@@ -0,0 +1,33 @@
+<script setup lang="ts">
+  import { cn } from '@/lib/utils';
+  import { useSidebar } from './utils';
+
+  defineOptions({ inheritAttrs: false });
+
+  const { toggleSidebar } = useSidebar();
+</script>
+
+<template>
+  <button
+    v-bind="$attrs"
+    data-sidebar="rail"
+    data-slot="sidebar-rail"
+    aria-label="Toggle Sidebar"
+    :tabindex="-1"
+    title="Toggle Sidebar"
+    :class="
+      cn(
+        'hover:after:bg-sidebar-border absolute inset-y-0 z-20 hidden w-4 -translate-x-1/2 transition-all ease-linear group-data-[side=left]:-right-4 group-data-[side=right]:left-0 after:absolute after:inset-y-0 after:left-1/2 after:w-[2px] sm:flex',
+        'in-data-[side=left]:cursor-w-resize in-data-[side=right]:cursor-e-resize',
+        '[[data-side=left][data-state=collapsed]_&]:cursor-e-resize [[data-side=right][data-state=collapsed]_&]:cursor-w-resize',
+        'hover:group-data-[collapsible=offcanvas]:bg-sidebar group-data-[collapsible=offcanvas]:translate-x-0 group-data-[collapsible=offcanvas]:after:left-full',
+        '[[data-side=left][data-collapsible=offcanvas]_&]:-right-2',
+        '[[data-side=right][data-collapsible=offcanvas]_&]:-left-2',
+        $attrs.class ?? '',
+      )
+    "
+    @click="toggleSidebar"
+  >
+    <slot />
+  </button>
+</template>

package/src/components/core/sidebar/SidebarSeparator.vue

@@ -0,0 +1,17 @@
+<script setup lang="ts">
+  import { cn } from '@/lib/utils';
+  import { Separator } from '@/components/core/separator';
+
+  defineOptions({ inheritAttrs: false });
+</script>
+
+<template>
+  <Separator
+    v-bind="$attrs"
+    data-slot="sidebar-separator"
+    data-sidebar="separator"
+    :class="cn('bg-sidebar-border mx-2 w-auto', $attrs.class ?? '')"
+  >
+    <slot />
+  </Separator>
+</template>

package/src/components/core/sidebar/SidebarTrigger.vue

@@ -0,0 +1,25 @@
+<script setup lang="ts">
+  import { PanelLeft } from 'lucide-vue-next';
+  import { cn } from '@/lib/utils';
+  import { Button } from '@/components/core/button';
+  import { useSidebar } from './utils';
+
+  defineOptions({ inheritAttrs: false });
+
+  const { toggleSidebar } = useSidebar();
+</script>
+
+<template>
+  <Button
+    v-bind="$attrs"
+    data-sidebar="trigger"
+    data-slot="sidebar-trigger"
+    variant="ghost"
+    size="icon"
+    :class="cn('h-7 w-7', $attrs.class ?? '')"
+    @click="toggleSidebar"
+  >
+    <PanelLeft />
+    <span class="sr-only">Toggle Sidebar</span>
+  </Button>
+</template>

package/src/components/core/sidebar/index.ts

@@ -0,0 +1,58 @@
+import type { VariantProps } from 'class-variance-authority';
+import { cva } from 'class-variance-authority';
+
+export interface SidebarProps {
+  side?: 'left' | 'right';
+  variant?: 'sidebar' | 'floating' | 'inset';
+  collapsible?: 'offcanvas' | 'icon' | 'none';
+}
+
+export { default as Sidebar } from './Sidebar.vue';
+export { default as SidebarContent } from './SidebarContent.vue';
+export { default as SidebarFooter } from './SidebarFooter.vue';
+export { default as SidebarGroup } from './SidebarGroup.vue';
+export { default as SidebarGroupAction } from './SidebarGroupAction.vue';
+export { default as SidebarGroupContent } from './SidebarGroupContent.vue';
+export { default as SidebarGroupLabel } from './SidebarGroupLabel.vue';
+export { default as SidebarHeader } from './SidebarHeader.vue';
+export { default as SidebarInput } from './SidebarInput.vue';
+export { default as SidebarInset } from './SidebarInset.vue';
+export { default as SidebarMenu } from './SidebarMenu.vue';
+export { default as SidebarMenuAction } from './SidebarMenuAction.vue';
+export { default as SidebarMenuBadge } from './SidebarMenuBadge.vue';
+export { default as SidebarMenuButton } from './SidebarMenuButton.vue';
+export { default as SidebarMenuItem } from './SidebarMenuItem.vue';
+export { default as SidebarMenuSkeleton } from './SidebarMenuSkeleton.vue';
+export { default as SidebarMenuSub } from './SidebarMenuSub.vue';
+export { default as SidebarMenuSubButton } from './SidebarMenuSubButton.vue';
+export { default as SidebarMenuSubItem } from './SidebarMenuSubItem.vue';
+export { default as SidebarProvider } from './SidebarProvider.vue';
+export { default as SidebarRail } from './SidebarRail.vue';
+export { default as SidebarSeparator } from './SidebarSeparator.vue';
+export { default as SidebarTrigger } from './SidebarTrigger.vue';
+
+export { useSidebar } from './utils';
+
+export const sidebarMenuButtonVariants = cva(
+  'peer/menu-button flex w-full items-center gap-2 overflow-hidden rounded-md p-2 text-left text-sm outline-hidden ring-sidebar-ring transition-[width,height,padding] hover:bg-sidebar-accent hover:text-sidebar-accent-foreground focus-visible:ring-2 active:bg-sidebar-accent active:text-sidebar-accent-foreground disabled:pointer-events-none disabled:opacity-50 group-has-data-[sidebar=menu-action]/menu-item:pr-8 aria-disabled:pointer-events-none aria-disabled:opacity-50 data-[active=true]:bg-sidebar-accent data-[active=true]:font-medium data-[active=true]:text-sidebar-accent-foreground data-[state=open]:hover:bg-sidebar-accent data-[state=open]:hover:text-sidebar-accent-foreground group-data-[collapsible=icon]:size-8! group-data-[collapsible=icon]:p-2! [&>span:last-child]:truncate [&>svg]:size-4 [&>svg]:shrink-0',
+  {
+    variants: {
+      variant: {
+        default: 'hover:bg-sidebar-accent hover:text-sidebar-accent-foreground',
+        outline:
+          'bg-background shadow-[0_0_0_1px_hsl(var(--sidebar-border))] hover:bg-sidebar-accent hover:text-sidebar-accent-foreground hover:shadow-[0_0_0_1px_hsl(var(--sidebar-accent))]',
+      },
+      size: {
+        default: 'h-8 text-sm',
+        sm: 'h-7 text-xs',
+        lg: 'h-12 text-sm group-data-[collapsible=icon]:p-0!',
+      },
+    },
+    defaultVariants: {
+      variant: 'default',
+      size: 'default',
+    },
+  },
+);
+
+export type SidebarMenuButtonVariants = VariantProps<typeof sidebarMenuButtonVariants>;

package/src/components/core/sidebar/utils.ts

@@ -0,0 +1,19 @@
+import type { ComputedRef, Ref } from 'vue';
+import { createContext } from 'reka-ui';
+
+export const SIDEBAR_COOKIE_NAME = 'sidebar_state';
+export const SIDEBAR_COOKIE_MAX_AGE = 60 * 60 * 24 * 7;
+export const SIDEBAR_WIDTH = '16rem';
+export const SIDEBAR_WIDTH_MOBILE = '18rem';
+export const SIDEBAR_WIDTH_ICON = '3rem';
+export const SIDEBAR_KEYBOARD_SHORTCUT = 'b';
+
+export const [useSidebar, provideSidebarContext] = createContext<{
+  state: ComputedRef<'expanded' | 'collapsed'>;
+  open: Ref<boolean>;
+  setOpen: (value: boolean) => void;
+  isMobile: Ref<boolean>;
+  openMobile: Ref<boolean>;
+  setOpenMobile: (value: boolean) => void;
+  toggleSidebar: () => void;
+}>('Sidebar');

package/src/components/core/spinner/Spinner.vue

@@ -0,0 +1,19 @@
+<script setup lang="ts">
+  import type { HTMLAttributes } from 'vue';
+  import { UiIcon } from '@/components/UiIcon';
+  import { cn } from '@/lib/utils';
+
+  const props = defineProps<{
+    class?: HTMLAttributes['class'];
+  }>();
+</script>
+
+<template>
+  <UiIcon
+    name="loader-circle"
+    :size="16"
+    role="status"
+    aria-label="Loading"
+    :class="cn('animate-spin', props.class)"
+  />
+</template>