@cocoar/vue-ui 2.0.0 → 2.2.0

package/dist/components/_internal/use-router-link.d.ts

@@ -0,0 +1,32 @@
+import { resolveDynamicComponent } from 'vue';
+/**
+ * Shared soft-Vue-Router-integration helper used by `CoarSidebarItem`,
+ * `CoarMenuItem`, `CoarButton`, and `CoarLink`. Detects whether `RouterLink`
+ * is globally registered (via `app.use(router)`) without taking a hard
+ * dependency on `vue-router` — `resolveDynamicComponent` returns the
+ * resolved component when present or the literal string `'RouterLink'`
+ * otherwise; the string-vs-component check is the canonical Vue 3 detection
+ * pattern.
+ *
+ * Also exposes a one-shot warning for the silent-footgun case: consumer
+ * passes a non-string `to` (an object route literal like `{ name: 'docs' }`)
+ * to a component that has no router available — we fall back to
+ * `<a href={String(to)}>` which renders `href="[object Object]"` and never
+ * navigates. The warning fires at most once per call site and only in DEV
+ * builds; production output is silent.
+ */
+export interface RouterLinkBinding {
+    /** Resolved `<RouterLink>` component, or the string `'RouterLink'` if unregistered. */
+    RouterLink: ReturnType<typeof resolveDynamicComponent>;
+    /** True when `vue-router` is installed AND its plugin registered globally. */
+    hasRouterLink: boolean;
+    /**
+     * Call from the consuming component (typically inside the same setup block
+     * where `to` is read for the first time) to emit a DEV-only warning when
+     * `to` is an object but no router is installed. Idempotent — fires only
+     * once per `useRouterLink()` call.
+     */
+    warnIfMisconfigured(toValue: unknown, componentName: string): void;
+}
+export declare function useRouterLink(): RouterLinkBinding;
+//# sourceMappingURL=use-router-link.d.ts.map

package/dist/components/_internal/use-router-link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-router-link.d.ts","sourceRoot":"","sources":["../../../src/components/_internal/use-router-link.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,KAAK,CAAC;AAE9C;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,iBAAiB;IAChC,uFAAuF;IACvF,UAAU,EAAE,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAC;IACvD,8EAA8E;IAC9E,aAAa,EAAE,OAAO,CAAC;IACvB;;;;;OAKG;IACH,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CACpE;AAED,wBAAgB,aAAa,IAAI,iBAAiB,CAsBjD"}

package/dist/components/breadcrumb/CoarBreadcrumbItem.vue.d.ts

@@ -1,17 +1,65 @@
+import { RouteLocationRaw } from 'vue-router';
 type __VLS_Props = {
-    /** Whether this item represents the current page */
+    /**
+     * Vue Router target. When set, the item renders as `<a href>` instead of
+     * requiring the consumer to slot an `<a>` / `<RouterLink>` themselves —
+     * for the common 90% case where every crumb is a link. Routing is via
+     * `<RouterLink>` if `vue-router` is installed and registered, otherwise
+     * a plain `<a href={String(to)}>` fallback.
+     *
+     * If `active` is also set, `to` is intentionally IGNORED: the current
+     * page is by WAI-ARIA convention NOT a link to itself, so the item
+     * renders as `<span aria-current="page">`. Consumers can pass `to` for
+     * every crumb (including the last) without stripping it manually — the
+     * `active` flag is the single source of truth for "this is current page".
+     */
+    to?: RouteLocationRaw | string;
+    /**
+     * External `href`. Used when `to` is not set — for absolute URLs and
+     * non-router targets. Same active-wins rule as `to`.
+     */
+    href?: string;
+    /**
+     * Leading icon name (rendered before the slot content, inside the `<a>` /
+     * `<span>` so it shares the link's hit-area and styling). Override with
+     * the `#icon` slot for custom content (avatar, badge, coloured icon).
+     */
+    icon?: string;
+    /**
+     * Marks this item as the current page. Renders as a non-interactive
+     * `<span aria-current="page">` even if `to` / `href` are set. Convention
+     * is that the last breadcrumb is the active one.
+     */
     active?: boolean;
+    /**
+     * Visually de-activates the link. `aria-disabled="true"`, `tabindex="-1"`,
+     * navigation suppressed. Only meaningful in link mode (no effect on
+     * active mode — already non-interactive — or on bare-slot mode).
+     */
+    disabled?: boolean;
 };
 declare function __VLS_template(): {
     attrs: Partial<{}>;
     slots: {
+        icon?(_: {}): any;
+        icon?(_: {}): any;
+        icon?(_: {}): any;
+        default?(_: {}): any;
+        default?(_: {}): any;
+        default?(_: {}): any;
         default?(_: {}): any;
     };
     refs: {};
     rootEl: HTMLLIElement;
 };
 type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
-declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLLIElement>;
+declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    disabled: boolean;
+    to: RouteLocationRaw | string;
+    href: string;
+    icon: string;
+    active: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLLIElement>;
 declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
 export default _default;
 type __VLS_WithTemplateSlots<T, S> = T & {

package/dist/components/breadcrumb/CoarBreadcrumbItem.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CoarBreadcrumbItem.vue.d.ts","sourceRoot":"","sources":["../../../src/components/breadcrumb/CoarBreadcrumbItem.vue"],"names":[],"mappings":"AAkDA,KAAK,WAAW,GAAG;IACjB,oDAAoD;IACpD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAKF,iBAAS,cAAc;WA+BT,OAAO,IAA6B;;yBAVrB,GAAG;;;;EAe/B;AAQD,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAC9D,QAAA,MAAM,eAAe,4SAOnB,CAAC;wBACkB,uBAAuB,CAAC,OAAO,eAAe,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAAnG,wBAAoG;AAQpG,KAAK,uBAAuB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IACxC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC"}
+{"version":3,"file":"CoarBreadcrumbItem.vue.d.ts","sourceRoot":"","sources":["../../../src/components/breadcrumb/CoarBreadcrumbItem.vue"],"names":[],"mappings":"AA+QA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAInD,KAAK,WAAW,GAAG;IACf;;;;;;;;;;;;OAYG;IACH,EAAE,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAAC;IAC/B;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AA+EJ,iBAAS,cAAc;WAwJT,OAAO,IAA6B;;sBAhBxB,GAAG;sBAEF,GAAG;sBAEH,GAAG;yBAHD,GAAG;yBAEF,GAAG;yBAEH,GAAG;yBACH,GAAG;;;;EAehC;AAeD,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAC9D,QAAA,MAAM,eAAe;cA7PN,OAAO;QAvBb,gBAAgB,GAAG,MAAM;UAKvB,MAAM;UAMN,MAAM;YAMJ,OAAO;uFA2QlB,CAAC;wBACkB,uBAAuB,CAAC,OAAO,eAAe,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAAnG,wBAAoG;AAapG,KAAK,uBAAuB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IACxC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC"}

package/dist/components/button/CoarButton.vue.d.ts

@@ -1,3 +1,4 @@
+import { RouteLocationRaw } from 'vue-router';
 export type ButtonVariant = 'primary' | 'secondary' | 'tertiary' | 'danger' | 'ghost';
 export type ButtonSize = 'xs' | 's' | 'm' | 'l';
 export interface CoarButtonProps {
@@ -9,7 +10,7 @@ export interface CoarButtonProps {
     disabled?: boolean;
     /** Whether the button is in loading state */
     loading?: boolean;
-    /** Button type attribute */
+    /** Button type attribute (only applied when rendering as <button>). */
     type?: 'button' | 'submit' | 'reset';
     /** Icon name to display before the label */
     iconStart?: string;
@@ -19,6 +20,20 @@ export interface CoarButtonProps {
     fullWidth?: boolean;
     /** Optional aria-label for the underlying button */
     ariaLabel?: string;
+    /**
+     * Optional Vue Router target. Accepts anything `RouterLink.to` accepts
+     * (string path, named-route object, etc.). When set the button renders as
+     * an `<a href>` (via `RouterLink` if `vue-router` is installed, otherwise
+     * a plain anchor) so middle-click / ctrl-click open a new tab, right-click
+     * exposes "Open in new tab" / "Copy link address", and screenreaders
+     * announce "link" instead of "button". `vue-router` is intentionally NOT a
+     * peerDependency — apps without a router can still use buttons normally.
+     *
+     * `type` and the native `disabled` attribute are dropped on the link path
+     * (invalid on `<a>`); disabled/loading state is enforced via
+     * `aria-disabled`, `tabindex=-1`, and `pointer-events: none` from CSS.
+     */
+    to?: RouteLocationRaw | string;
 }
 declare function __VLS_template(): {
     attrs: Partial<{}>;
@@ -26,7 +41,7 @@ declare function __VLS_template(): {
         default?(_: {}): any;
     };
     refs: {};
-    rootEl: HTMLButtonElement;
+    rootEl: any;
 };
 type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
 declare const __VLS_component: import('vue').DefineComponent<CoarButtonProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
@@ -43,7 +58,8 @@ declare const __VLS_component: import('vue').DefineComponent<CoarButtonProps, {}
     iconEnd: string;
     fullWidth: boolean;
     ariaLabel: string;
-}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLButtonElement>;
+    to: RouteLocationRaw | string;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
 export default _default;
 type __VLS_WithTemplateSlots<T, S> = T & {

package/dist/components/button/CoarButton.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CoarButton.vue.d.ts","sourceRoot":"","sources":["../../../src/components/button/CoarButton.vue"],"names":[],"mappings":"AA0ZA,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC;AACtF,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAEhD,MAAM,WAAW,eAAe;IAC9B,4BAA4B;IAC5B,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,kBAAkB;IAClB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,4BAA4B;IAC5B,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;IACrC,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAqDD,iBAAS,cAAc;WA6JT,OAAO,IAA6B;;yBAVpB,GAAG;;;;EAehC;AAcD,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAC9D,QAAA,MAAM,eAAe;;;;;cAnPR,OAAO;UAIX,QAAQ,GAAG,QAAQ,GAAG,OAAO;UAN7B,UAAU;aAFP,aAAa;aAMb,OAAO;eAIL,MAAM;aAER,MAAM;eAEJ,OAAO;eAEP,MAAM;2FAgPlB,CAAC;wBACkB,uBAAuB,CAAC,OAAO,eAAe,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAAnG,wBAAoG;AAapG,KAAK,uBAAuB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IACxC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC"}
+{"version":3,"file":"CoarButton.vue.d.ts","sourceRoot":"","sources":["../../../src/components/button/CoarButton.vue"],"names":[],"mappings":"AA+dA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAInD,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC;AACtF,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAEhD,MAAM,WAAW,eAAe;IAC9B,4BAA4B;IAC5B,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,kBAAkB;IAClB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,uEAAuE;IACvE,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;IACrC,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;;;;;;OAYG;IACH,EAAE,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAAC;CAChC;AAwGD,iBAAS,cAAc;WAgLT,OAAO,IAA6B;;yBAVpB,GAAG;;;;EAehC;AAiBD,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAC9D,QAAA,MAAM,eAAe;;;;;cA1UR,OAAO;UAIX,QAAQ,GAAG,QAAQ,GAAG,OAAO;UAN7B,UAAU;aAFP,aAAa;aAMb,OAAO;eAIL,MAAM;aAER,MAAM;eAEJ,OAAO;eAEP,MAAM;QAcb,gBAAgB,GAAG,MAAM;6EAyT9B,CAAC;wBACkB,uBAAuB,CAAC,OAAO,eAAe,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAAnG,wBAAoG;AAapG,KAAK,uBAAuB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IACxC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC"}

package/dist/components/link/CoarLink.vue.d.ts

@@ -0,0 +1,62 @@
+import { RouteLocationRaw } from 'vue-router';
+export type CoarLinkVariant = 'accent' | 'subtle';
+export type CoarLinkSize = 's' | 'm' | 'l';
+export interface CoarLinkProps {
+    /**
+     * Vue Router target. Takes precedence over `href`. When set the link
+     * renders via `<RouterLink>` (if installed) for SPA navigation, or a
+     * plain `<a href={String(to)}>` fallback. Modifier-click (Ctrl/Cmd/middle)
+     * opens a new tab natively in both cases.
+     */
+    to?: RouteLocationRaw | string;
+    /**
+     * External `href`. Used when `to` is not set — for absolute URLs and
+     * `mailto:` / `tel:` schemes that have no router target. If `target` is
+     * `_blank` and `rel` is not provided, `rel="noopener"` is added
+     * automatically to defend against tab-nabbing.
+     */
+    href?: string;
+    /** Visual variant — `accent` is the default link color, `subtle` blends into surrounding text. */
+    variant?: CoarLinkVariant;
+    /** Typography size — `s`, `m` (default), `l`. */
+    size?: CoarLinkSize;
+    /** Disabled state — `aria-disabled`, `tabindex=-1`, navigation suppressed. */
+    disabled?: boolean;
+    /** Anchor `target` attribute. Only applied when rendering as a plain `<a>` (not via `<RouterLink>`). */
+    target?: string;
+    /** Anchor `rel` attribute. Auto-fills to `noopener` when `target="_blank"` is set and `rel` is omitted. */
+    rel?: string;
+}
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        default?(_: {}): any;
+        default?(_: {}): any;
+        default?(_: {}): any;
+        default?(_: {}): any;
+    };
+    refs: {};
+    rootEl: any;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<CoarLinkProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    click: (event: MouseEvent) => any;
+}, string, import('vue').PublicProps, Readonly<CoarLinkProps> & Readonly<{
+    onClick?: ((event: MouseEvent) => any) | undefined;
+}>, {
+    disabled: boolean;
+    target: string;
+    size: CoarLinkSize;
+    variant: CoarLinkVariant;
+    to: RouteLocationRaw | string;
+    href: string;
+    rel: string;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
+//# sourceMappingURL=CoarLink.vue.d.ts.map

package/dist/components/link/CoarLink.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CoarLink.vue.d.ts","sourceRoot":"","sources":["../../../src/components/link/CoarLink.vue"],"names":[],"mappings":"AA4LA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGnD,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAClD,MAAM,MAAM,YAAY,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAE3C,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,EAAE,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAAC;IAC/B;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kGAAkG;IAClG,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,iDAAiD;IACjD,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wGAAwG;IACxG,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2GAA2G;IAC3G,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAqFD,iBAAS,cAAc;WAqFT,OAAO,IAA6B;;yBAbrB,GAAG;yBACH,GAAG;yBACH,GAAG;yBACH,GAAG;;;;EAe/B;AAkBD,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAC9D,QAAA,MAAM,eAAe;;;;;cAvMR,OAAO;YAET,MAAM;UAJR,YAAY;aAFT,eAAe;QATpB,gBAAgB,GAAG,MAAM;UAOvB,MAAM;SAUP,MAAM;6EA2MZ,CAAC;wBACkB,uBAAuB,CAAC,OAAO,eAAe,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAAnG,wBAAoG;AAapG,KAAK,uBAAuB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IACxC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC"}

package/dist/components/link/index.d.ts

@@ -0,0 +1,3 @@
+export { default as CoarLink } from './CoarLink.vue';
+export type { CoarLinkProps, CoarLinkSize, CoarLinkVariant, } from './CoarLink.vue';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/link/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/link/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACrD,YAAY,EACV,aAAa,EACb,YAAY,EACZ,eAAe,GAChB,MAAM,gBAAgB,CAAC"}

package/dist/components/menu/CoarMenuItem.vue.d.ts

@@ -1,3 +1,4 @@
+import { RouteLocationRaw } from 'vue-router';
 export interface MenuItemClickEvent {
     /** Call to prevent auto-close of the menu tree */
     keepMenuOpen(): void;
@@ -9,6 +10,23 @@ type __VLS_Props = {
     label?: string;
     /** Optional icon name */
     icon?: string;
+    /**
+     * Optional Vue Router target. Accepts anything `RouterLink.to` accepts
+     * (string path, named-route object, etc.). When set the item renders as a
+     * real `<a href>` so middle-click / ctrl-click open a new tab, right-click
+     * exposes "Open in new tab" / "Copy link address", and screenreaders
+     * announce "link to {label}" instead of just "menuitem". Routing is
+     * delegated to `RouterLink` when `vue-router` is installed; otherwise a
+     * plain `<a>` is rendered (works for absolute URLs via the browser's
+     * native navigation). `vue-router` is intentionally NOT a peerDependency.
+     *
+     * `clicked` is still emitted on plain-click after navigation kicks off,
+     * so `keepMenuOpen()` and other consumer side-effects continue to work.
+     * On modifier-click (Ctrl/Cmd/Middle = new tab) the click event is
+     * suppressed by the browser default — the menu does NOT auto-close so
+     * the user can fire several link items in a row.
+     */
+    to?: RouteLocationRaw | string;
     /** Disabled state */
     disabled?: boolean;
 };
@@ -16,11 +34,13 @@ declare function __VLS_template(): {
     attrs: Partial<{}>;
     slots: {
         default?(_: {}): any;
+        default?(_: {}): any;
+        default?(_: {}): any;
     };
     refs: {
         itemRef: HTMLDivElement;
     };
-    rootEl: HTMLDivElement;
+    rootEl: any;
 };
 type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
 declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
@@ -30,10 +50,11 @@ declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}
 }>, {
     label: string;
     disabled: boolean;
+    to: RouteLocationRaw | string;
     icon: string;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
     itemRef: HTMLDivElement;
-}, HTMLDivElement>;
+}, any>;
 declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
 export default _default;
 type __VLS_WithTemplateSlots<T, S> = T & {

package/dist/components/menu/CoarMenuItem.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CoarMenuItem.vue.d.ts","sourceRoot":"","sources":["../../../src/components/menu/CoarMenuItem.vue"],"names":[],"mappings":"AA4LA,MAAM,WAAW,kBAAkB;IACjC,kDAAkD;IAClD,YAAY,IAAI,IAAI,CAAC;IACrB,2BAA2B;IAC3B,KAAK,EAAE,UAAU,CAAC;CACnB;AAED,KAAK,WAAW,GAAG;IACf,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AA0FJ,iBAAS,cAAc;WAgET,OAAO,IAA6B;;yBAXrB,GAAG;;;;;;EAgB/B;AAeD,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAC9D,QAAA,MAAM,eAAe;;;;;WApLT,MAAM;cAIH,OAAO;UAFX,MAAM;;;kBA4Lf,CAAC;wBACkB,uBAAuB,CAAC,OAAO,eAAe,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAAnG,wBAAoG;AAapG,KAAK,uBAAuB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IACxC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC"}
+{"version":3,"file":"CoarMenuItem.vue.d.ts","sourceRoot":"","sources":["../../../src/components/menu/CoarMenuItem.vue"],"names":[],"mappings":"AA2WA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAInD,MAAM,WAAW,kBAAkB;IACjC,kDAAkD;IAClD,YAAY,IAAI,IAAI,CAAC;IACrB,2BAA2B;IAC3B,KAAK,EAAE,UAAU,CAAC;CACnB;AAED,KAAK,WAAW,GAAG;IACf,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;;;;;;;;;;OAeG;IACH,EAAE,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAAC;IAC/B,qBAAqB;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAwKJ,iBAAS,cAAc;WAqKT,OAAO,IAA6B;;yBAbpB,GAAG;yBACH,GAAG;yBACH,GAAG;;;;;;EAgBhC;AAmBD,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAC9D,QAAA,MAAM,eAAe;;;;;WA5XT,MAAM;cAqBH,OAAO;QAFb,gBAAgB,GAAG,MAAM;UAjBvB,MAAM;;;OAmYf,CAAC;wBACkB,uBAAuB,CAAC,OAAO,eAAe,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAAnG,wBAAoG;AAapG,KAAK,uBAAuB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IACxC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC"}

package/dist/components/number-input/CoarNumberInput.vue.d.ts

@@ -77,13 +77,13 @@ declare const __VLS_component: import('vue').DefineComponent<__VLS_PublicProps,
     name: string;
     placeholder: string;
     size: CoarNumberInputSize;
+    step: number;
     max: number;
     readonly: boolean;
     clearable: boolean;
     prefix: string;
     suffix: string;
     min: number;
-    step: number;
     decimals: number;
     stepperButtons: CoarNumberInputStepperButtons;
     locale: string;

package/dist/components/number-input/CoarNumberInput.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CoarNumberInput.vue.d.ts","sourceRoot":"","sources":["../../../src/components/number-input/CoarNumberInput.vue"],"names":[],"mappings":"AA+qBA,0CAA0C;AAC1C,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,MAAM,mBAAmB,GAAG,IAAI,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AACzD,MAAM,MAAM,6BAA6B,GAAG,MAAM,GAAG,WAAW,GAAG,WAAW,GAAG,MAAM,CAAC;AAExF,MAAM,WAAW,oBAAoB;IACnC,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB;IACjB,IAAI,CAAC,EAAE,mBAAmB,CAAC;IAC3B,4BAA4B;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yBAAyB;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iFAAiF;IACjF,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,0BAA0B;IAC1B,cAAc,CAAC,EAAE,6BAA6B,CAAC;IAC/C,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,wBAAwB;IACxB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0BAA0B;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,KAAK,WAAW,GAAG,oBAAoB,CAAC;AA4QxC,KAAK,iBAAiB,GAAG;IACzB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,GAAG,WAAW,CAAC;AAKhB,iBAAS,cAAc;WAmKT,OAAO,IAA6B;;wBAZtB,GAAG;wBACH,GAAG;;;;;;EAgB9B;AAkCD,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAC9D,QAAA,MAAM,eAAe;;;;;;;;;;;WAjfX,OAAO;cAFJ,OAAO;cAJP,OAAO;QAoBb,MAAM;UAEJ,MAAM;iBAlCC,MAAM;UAEb,mBAAmB;SAIpB,MAAM;cAQD,OAAO;eAMN,OAAO;YAIV,MAAM;YAEN,MAAM;SAtBT,MAAM;UAIL,MAAM;cAEF,MAAM;oBAYA,6BAA6B;YAMrC,MAAM;kBAEA,kBAAkB;;;kBA+ejC,CAAC;wBACkB,uBAAuB,CAAC,OAAO,eAAe,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAAnG,wBAAoG;AAapG,KAAK,uBAAuB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IACxC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC"}
+{"version":3,"file":"CoarNumberInput.vue.d.ts","sourceRoot":"","sources":["../../../src/components/number-input/CoarNumberInput.vue"],"names":[],"mappings":"AA+qBA,0CAA0C;AAC1C,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,MAAM,mBAAmB,GAAG,IAAI,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AACzD,MAAM,MAAM,6BAA6B,GAAG,MAAM,GAAG,WAAW,GAAG,WAAW,GAAG,MAAM,CAAC;AAExF,MAAM,WAAW,oBAAoB;IACnC,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB;IACjB,IAAI,CAAC,EAAE,mBAAmB,CAAC;IAC3B,4BAA4B;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yBAAyB;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iFAAiF;IACjF,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,0BAA0B;IAC1B,cAAc,CAAC,EAAE,6BAA6B,CAAC;IAC/C,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,wBAAwB;IACxB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0BAA0B;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,KAAK,WAAW,GAAG,oBAAoB,CAAC;AA4QxC,KAAK,iBAAiB,GAAG;IACzB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,GAAG,WAAW,CAAC;AAKhB,iBAAS,cAAc;WAmKT,OAAO,IAA6B;;wBAZtB,GAAG;wBACH,GAAG;;;;;;EAgB9B;AAkCD,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAC9D,QAAA,MAAM,eAAe;;;;;;;;;;;WAjfX,OAAO;cAFJ,OAAO;cAJP,OAAO;QAoBb,MAAM;UAEJ,MAAM;iBAlCC,MAAM;UAEb,mBAAmB;UAMnB,MAAM;SAFP,MAAM;cAQD,OAAO;eAMN,OAAO;YAIV,MAAM;YAEN,MAAM;SAtBT,MAAM;cAMD,MAAM;oBAYA,6BAA6B;YAMrC,MAAM;kBAEA,kBAAkB;;;kBA+ejC,CAAC;wBACkB,uBAAuB,CAAC,OAAO,eAAe,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAAnG,wBAAoG;AAapG,KAAK,uBAAuB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IACxC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC"}

package/dist/components/overlay/CoarOverlayOutlet.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CoarOverlayOutlet.vue.d.ts","sourceRoot":"","sources":["../../../src/components/overlay/CoarOverlayOutlet.vue"],"names":[],"mappings":"AA6IA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,KAAK,WAAW,GAAG;IACjB,QAAQ,EAAE,eAAe,CAAC;CAC3B,CAAC;AAqDF,iBAAS,cAAc;WA6FT,OAAO,IAA6B;;yBAZpB,GAAG;;;;;;;EAiBhC;AAYD,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAC9D,QAAA,MAAM,eAAe;;;OAQnB,CAAC;wBACkB,uBAAuB,CAAC,OAAO,eAAe,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAAnG,wBAAoG;AAQpG,KAAK,uBAAuB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IACxC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC"}
+{"version":3,"file":"CoarOverlayOutlet.vue.d.ts","sourceRoot":"","sources":["../../../src/components/overlay/CoarOverlayOutlet.vue"],"names":[],"mappings":"AAqJA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,KAAK,WAAW,GAAG;IACjB,QAAQ,EAAE,eAAe,CAAC;CAC3B,CAAC;AAqDF,iBAAS,cAAc;WA6FT,OAAO,IAA6B;;yBAZpB,GAAG;;;;;;;EAiBhC;AAYD,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAC9D,QAAA,MAAM,eAAe;;;OAQnB,CAAC;wBACkB,uBAAuB,CAAC,OAAO,eAAe,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAAnG,wBAAoG;AAQpG,KAAK,uBAAuB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IACxC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC"}

package/dist/components/sidebar/CoarSidebarItem.vue.d.ts

@@ -1,9 +1,36 @@
+import { RouteLocationRaw } from 'vue-router';
 type __VLS_Props = {
     /** Item label text */
     label: string;
     /** Icon name (required for collapsed mode) */
     icon?: string;
-    /** Whether this item is currently active (e.g. current route) */
+    /**
+     * Optional Vue Router target. Accepts anything `RouterLink.to` accepts
+     * (string path, named-route object, etc.). When set the item renders as a
+     * real `<a href>` so:
+     *  - middle-click + ctrl/cmd-click open in a new tab (browser default)
+     *  - right-click shows "Open in new tab" / "Copy link address"
+     *  - screenreaders announce "link" instead of "menuitem"
+     * Routing is delegated to `RouterLink` when `vue-router` is installed and
+     * its plugin registered globally; otherwise we degrade to a plain anchor
+     * that uses the browser's native navigation (works for absolute URLs).
+     * `vue-router` is an optional `peerDependenciesMeta` entry — apps without
+     * a router still use this component for click-emit items (logout, toggles).
+     *
+     * A11y note: the `<a>` branch intentionally drops `role="menuitem"`. The
+     * surrounding `<CoarSidebar>` is `role="navigation"`, where a native link
+     * is semantically complete on its own — adding `role="menuitem"` would
+     * require a `role="menu"` parent per WAI-ARIA and would mislead AT
+     * announcements. The legacy `<div>` branch (no `to`) keeps the role for
+     * back-compat with the original API.
+     */
+    to?: RouteLocationRaw | string;
+    /**
+     * Whether this item is currently active (e.g. current route).
+     * If `to` is set and `active` is left undefined, the active state is
+     * inferred from `RouterLink`'s `isActive`. Setting `active` explicitly
+     * always wins (use for non-route active states, e.g. drawer-open).
+     */
     active?: boolean;
     /** Disabled state */
     disabled?: boolean;
@@ -14,8 +41,9 @@ declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {
     onClick?: ((event: MouseEvent) => any) | undefined;
 }>, {
     disabled: boolean;
+    to: RouteLocationRaw | string;
     icon: string;
     active: boolean;
-}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 export default _default;
 //# sourceMappingURL=CoarSidebarItem.vue.d.ts.map

package/dist/components/sidebar/CoarSidebarItem.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CoarSidebarItem.vue.d.ts","sourceRoot":"","sources":["../../../src/components/sidebar/CoarSidebarItem.vue"],"names":[],"mappings":"AAyPA,KAAK,WAAW,GAAG;IACf,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;;;;;;cADW,OAAO;UAJX,MAAM;YAEJ,OAAO;;AAsJpB,wBASG"}
+{"version":3,"file":"CoarSidebarItem.vue.d.ts","sourceRoot":"","sources":["../../../src/components/sidebar/CoarSidebarItem.vue"],"names":[],"mappings":"AAyXA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAcnD,KAAK,WAAW,GAAG;IACf,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;;;;;;;;;;;;;;OAmBG;IACH,EAAE,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAAC;IAC/B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;;;;;;cADW,OAAO;QATb,gBAAgB,GAAG,MAAM;UArBvB,MAAM;YA4BJ,OAAO;;AAwRpB,wBAQG"}