Common

A set of Vue 3 composables, router helpers, Pinia store helpers, error classes and small utilities shared across the @basmilius ecosystem. The package is opinionated about its peer dependencies — it expects a Vue 3 application with Vue Router and Pinia available — but is otherwise unobtrusive.

Categories

• Composables — Vue 3 composables for clipboard, debouncing, observers, pagination and more
• Router helpers — small wrappers around vue-router for typed parameters, navigation and named views
• Store — a Pinia defineStore variant that returns refs by default
• Errors — domain exceptions used by guarded and consumed by useService
• Utilities — small helpers such as persistentRef, generateColorPalette and unwrapElement

Peer dependencies

The package leans on three peers that you almost certainly already have in any Vue 3 application.

• vue — composables and lifecycle hooks
• vue-router — required by everything in /common/router/
• pinia — required by defineStore

@basmilius/http-client is an optional peer that unlocks the data-oriented composables useDataTable, useDtoForm and useService.

Quick example

import { ref } from 'vue';
import { useDebouncedRef, persistentStringRef } from '@basmilius/common';

const query = persistentStringRef('search:query', null);
const debounced = useDebouncedRef(query, 250);

Continue with installation or jump straight to a category from the sidebar.