@leavepulse/ui 0.43.2 → 0.43.4

package/dist/components/LpLightbox.vue.d.ts

@@ -0,0 +1,62 @@
+import { type LightboxItem } from "./lightbox";
+type __VLS_Props = {
+    open?: boolean;
+    /** Images to page through. */
+    items: LightboxItem[];
+    /** Index of the visible image (v-model:index). */
+    index?: number;
+    /** Thumbnail strip along the bottom. Defaults on when there's more than one. */
+    filmstrip?: boolean;
+    /** Show the rotate control. */
+    rotatable?: boolean;
+    /** Show the download control. */
+    downloadable?: boolean;
+    /** Show "copy image" — needs a same-origin or CORS-readable source. */
+    copyable?: boolean;
+    /** Wrap from the last image back to the first. */
+    loop?: boolean;
+    /** Largest zoom level. */
+    maxZoom?: number;
+};
+type __VLS_Slots = {
+    /** Replace the caption block under the image. */
+    caption(props: {
+        item: LightboxItem;
+        index: number;
+        total: number;
+    }): unknown;
+    /** Extra controls in the toolbar, before the close button. */
+    actions(props: {
+        item: LightboxItem;
+        index: number;
+    }): unknown;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    copy: (item: LightboxItem, ok: boolean) => any;
+    download: (item: LightboxItem) => any;
+    change: (index: number, item: LightboxItem) => any;
+    "update:open": (value: boolean) => any;
+    "update:index": (value: number) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onCopy?: ((item: LightboxItem, ok: boolean) => any) | undefined;
+    onDownload?: ((item: LightboxItem) => any) | undefined;
+    onChange?: ((index: number, item: LightboxItem) => any) | undefined;
+    "onUpdate:open"?: ((value: boolean) => any) | undefined;
+    "onUpdate:index"?: ((value: number) => any) | undefined;
+}>, {
+    loop: boolean;
+    open: boolean;
+    maxZoom: number;
+    index: number;
+    copyable: boolean;
+    rotatable: boolean;
+    downloadable: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/LpLink.vue.d.ts

@@ -0,0 +1,93 @@
+import { type Component } from "vue";
+declare const _default: typeof __VLS_export;
+export default _default;
+declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
+    href?: string;
+    external?: boolean;
+    /** Shorthand for `tone="muted"`. */
+    muted?: boolean;
+    /**
+     * "brand" — the accent link colour (default).
+     * "ink"   — inherits body text colour; for links that sit inside prose or
+     *   chrome where an accent would shout (breadcrumbs, footers, nav).
+     * "muted" / "soft" — progressively quieter, both resolving to ink on hover.
+     */
+    tone?: "brand" | "ink" | "muted" | "soft";
+    /**
+     * Root element/component. Defaults to a native <a>. Pass a router link
+     * component (e.g. NuxtLink or RouterLink) to keep client-side navigation;
+     * the kit stays DOM-agnostic, the consumer supplies the link component.
+     * Router links take their destination through their own prop (`to`), which
+     * falls through as a plain attribute.
+     */
+    as?: string | Component;
+    /**
+     * "default" — plain hover underline.
+     * "underline" — underlined at rest; for links inside running prose,
+     *   where hover-only underlines leave the link invisible until pointed at.
+     * "reveal"  — an underline bar that grows in from the left on hover
+     *   (origin-left scale-x 0→1). The LeavePulse landing "monitoring" link feel;
+     *   good for inline prose links and nav items that want a bit of motion.
+     */
+    variant?: "default" | "underline" | "reveal";
+    /**
+     * Which hover draws the `reveal` bar.
+     *
+     * "self"  — the link's own hover (default), for an inline prose link.
+     * "group" — the hover of an ancestor marked `group`, for a link inside a
+     *   row or card that is itself the click target. The row lights up and the
+     *   name sweeps with it, instead of the bar waiting for the pointer to
+     *   cross the text exactly.
+     */
+    revealOn?: "self" | "group";
+}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{
+    href?: string;
+    external?: boolean;
+    /** Shorthand for `tone="muted"`. */
+    muted?: boolean;
+    /**
+     * "brand" — the accent link colour (default).
+     * "ink"   — inherits body text colour; for links that sit inside prose or
+     *   chrome where an accent would shout (breadcrumbs, footers, nav).
+     * "muted" / "soft" — progressively quieter, both resolving to ink on hover.
+     */
+    tone?: "brand" | "ink" | "muted" | "soft";
+    /**
+     * Root element/component. Defaults to a native <a>. Pass a router link
+     * component (e.g. NuxtLink or RouterLink) to keep client-side navigation;
+     * the kit stays DOM-agnostic, the consumer supplies the link component.
+     * Router links take their destination through their own prop (`to`), which
+     * falls through as a plain attribute.
+     */
+    as?: string | Component;
+    /**
+     * "default" — plain hover underline.
+     * "underline" — underlined at rest; for links inside running prose,
+     *   where hover-only underlines leave the link invisible until pointed at.
+     * "reveal"  — an underline bar that grows in from the left on hover
+     *   (origin-left scale-x 0→1). The LeavePulse landing "monitoring" link feel;
+     *   good for inline prose links and nav items that want a bit of motion.
+     */
+    variant?: "default" | "underline" | "reveal";
+    /**
+     * Which hover draws the `reveal` bar.
+     *
+     * "self"  — the link's own hover (default), for an inline prose link.
+     * "group" — the hover of an ancestor marked `group`, for a link inside a
+     *   row or card that is itself the click target. The row lights up and the
+     *   name sweeps with it, instead of the bar waiting for the pointer to
+     *   cross the text exactly.
+     */
+    revealOn?: "self" | "group";
+}> & Readonly<{}>, {
+    as: string | Component;
+    variant: "default" | "underline" | "reveal";
+    revealOn: "self" | "group";
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>, {
+    default?: (props: {}) => any;
+}>;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/LpLogViewer.vue.d.ts

@@ -0,0 +1,153 @@
+import { type ContextMenuItemDef } from "./LpContextMenu.vue";
+export type LogLevel = "trace" | "debug" | "info" | "warn" | "error" | "fatal" | "success";
+export interface LogLine {
+    /** Body of the line. */
+    message: string;
+    level?: LogLevel;
+    /** Epoch ms, ISO string, or pre-formatted label — shown in the time column. */
+    time?: number | string;
+    /** Short origin tag (service / module), rendered as a dim chip. */
+    source?: string;
+}
+declare const _default: typeof __VLS_export;
+export default _default;
+declare const __VLS_export: import("vue").DefineComponent<{
+    lines: LogLine[];
+    /** Show the timestamp column. */
+    showTime?: boolean;
+    /**
+     * Show the per-line level chip (INFO/WARN/…). On by default. Turn off for
+     * raw streams (e.g. docker logs) where most lines have no real level and a
+     * blanket "INFO" chip is just noise — the tonal level RAIL still renders, so
+     * errors/warnings stay visually distinct.
+     */
+    showLevel?: boolean;
+    /** Show 1-based gutter line numbers. */
+    lineNumbers?: boolean;
+    /** Wrap long lines instead of scrolling horizontally. */
+    wrap?: boolean;
+    /** Case-insensitive substring to highlight in message bodies. */
+    highlight?: string;
+    /** When set with `highlight`, hide every line that doesn't match. */
+    filterMatches?: boolean;
+    /** Collapse consecutive identical lines into one, badged with a ×N count. */
+    compact?: boolean;
+    /** Pin to the bottom as new lines arrive (until the user scrolls up). */
+    tail?: boolean;
+    /** Fixed height. Anything CSS-valid; defaults to a comfortable terminal. */
+    height?: string;
+    emptyLabel?: string;
+    /** Shown while the stream is held. Defaulted in English; apps with i18n
+     *  pass their own. */
+    frozenLabel?: string;
+    /**
+     * When true, a "loading older…" row is shown pinned at the top — set it while
+     * fetching a previous page in response to `reach-top`, clear it when done.
+     */
+    loadingOlder?: boolean;
+    /**
+     * When true, the viewer emits `reach-top` as the user scrolls near the top so
+     * the consumer can prepend older history (infinite scroll-back). The viewer
+     * preserves the scroll position across a prepend so the view doesn't jump.
+     */
+    loadOlder?: boolean;
+    /**
+     * Right-click row menu: built-in copy actions (+ "filter by" when the line
+     * has a source/level). Set false to disable; the row keeps the native menu.
+     */
+    rowMenu?: boolean;
+    /** Extra menu items per line, appended below the built-ins with a divider. */
+    extraRowItems?: (line: LogLine, index: number) => ContextMenuItemDef[];
+    /**
+     * Recognise common log formats inside each `message` and lift the level,
+     * timestamp and [source] out of the text into the dedicated columns. When a
+     * line already carries an explicit `level`/`time`/`source`, those win and
+     * the message is left untouched. Off by default (raw). Handles e.g.:
+     *   "2025-01-02T03:04:05.123Z INFO [auth] user logged in"
+     *   "[2025-01-02 03:04:05] WARN: disk almost full"
+     *   "ERROR something broke"
+     * so a duplicate level word / timestamp doesn't repeat in the message body.
+     */
+    parse?: boolean;
+}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    filter: (by: {
+        source?: string;
+        level?: LogLevel;
+    }) => any;
+    "reach-top": () => any;
+}, string, import("vue").PublicProps, Readonly<{
+    lines: LogLine[];
+    /** Show the timestamp column. */
+    showTime?: boolean;
+    /**
+     * Show the per-line level chip (INFO/WARN/…). On by default. Turn off for
+     * raw streams (e.g. docker logs) where most lines have no real level and a
+     * blanket "INFO" chip is just noise — the tonal level RAIL still renders, so
+     * errors/warnings stay visually distinct.
+     */
+    showLevel?: boolean;
+    /** Show 1-based gutter line numbers. */
+    lineNumbers?: boolean;
+    /** Wrap long lines instead of scrolling horizontally. */
+    wrap?: boolean;
+    /** Case-insensitive substring to highlight in message bodies. */
+    highlight?: string;
+    /** When set with `highlight`, hide every line that doesn't match. */
+    filterMatches?: boolean;
+    /** Collapse consecutive identical lines into one, badged with a ×N count. */
+    compact?: boolean;
+    /** Pin to the bottom as new lines arrive (until the user scrolls up). */
+    tail?: boolean;
+    /** Fixed height. Anything CSS-valid; defaults to a comfortable terminal. */
+    height?: string;
+    emptyLabel?: string;
+    /** Shown while the stream is held. Defaulted in English; apps with i18n
+     *  pass their own. */
+    frozenLabel?: string;
+    /**
+     * When true, a "loading older…" row is shown pinned at the top — set it while
+     * fetching a previous page in response to `reach-top`, clear it when done.
+     */
+    loadingOlder?: boolean;
+    /**
+     * When true, the viewer emits `reach-top` as the user scrolls near the top so
+     * the consumer can prepend older history (infinite scroll-back). The viewer
+     * preserves the scroll position across a prepend so the view doesn't jump.
+     */
+    loadOlder?: boolean;
+    /**
+     * Right-click row menu: built-in copy actions (+ "filter by" when the line
+     * has a source/level). Set false to disable; the row keeps the native menu.
+     */
+    rowMenu?: boolean;
+    /** Extra menu items per line, appended below the built-ins with a divider. */
+    extraRowItems?: (line: LogLine, index: number) => ContextMenuItemDef[];
+    /**
+     * Recognise common log formats inside each `message` and lift the level,
+     * timestamp and [source] out of the text into the dedicated columns. When a
+     * line already carries an explicit `level`/`time`/`source`, those win and
+     * the message is left untouched. Off by default (raw). Handles e.g.:
+     *   "2025-01-02T03:04:05.123Z INFO [auth] user logged in"
+     *   "[2025-01-02 03:04:05] WARN: disk almost full"
+     *   "ERROR something broke"
+     * so a duplicate level word / timestamp doesn't repeat in the message body.
+     */
+    parse?: boolean;
+}> & Readonly<{
+    onFilter?: ((by: {
+        source?: string;
+        level?: LogLevel;
+    }) => any) | undefined;
+    "onReach-top"?: (() => any) | undefined;
+}>, {
+    height: string;
+    wrap: boolean;
+    emptyLabel: string;
+    lineNumbers: boolean;
+    showTime: boolean;
+    showLevel: boolean;
+    tail: boolean;
+    frozenLabel: string;
+    rowMenu: boolean;
+    parse: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;

package/dist/components/LpMapPicker.vue.d.ts

@@ -0,0 +1,59 @@
+import { type LatLon, type TileSource } from "./address";
+declare const _default: typeof __VLS_export;
+export default _default;
+declare const __VLS_export: import("vue").DefineComponent<{
+    /** Picked point. Bind with v-model; undefined leaves the map unpinned. */
+    modelValue?: LatLon;
+    /** Tile server. Defaults to OpenStreetMap; swap for your own. */
+    tiles?: TileSource;
+    /** Zoom used on first paint, and when a point arrives from outside. */
+    zoom?: number;
+    /** Where to look when there is no point yet. */
+    center?: LatLon;
+    disabled?: boolean;
+    /** Any CSS length. */
+    height?: string;
+    /** Offer the "use my location" control (needs a secure context). */
+    locatable?: boolean;
+    zoomInLabel?: string;
+    zoomOutLabel?: string;
+    locateLabel?: string;
+    recentreLabel?: string;
+}, {
+    zoomIn: () => void;
+    zoomOut: () => void;
+    recentre: () => void;
+    locate: () => void;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    "update:modelValue": (value: LatLon) => any;
+}, string, import("vue").PublicProps, Readonly<{
+    /** Picked point. Bind with v-model; undefined leaves the map unpinned. */
+    modelValue?: LatLon;
+    /** Tile server. Defaults to OpenStreetMap; swap for your own. */
+    tiles?: TileSource;
+    /** Zoom used on first paint, and when a point arrives from outside. */
+    zoom?: number;
+    /** Where to look when there is no point yet. */
+    center?: LatLon;
+    disabled?: boolean;
+    /** Any CSS length. */
+    height?: string;
+    /** Offer the "use my location" control (needs a secure context). */
+    locatable?: boolean;
+    zoomInLabel?: string;
+    zoomOutLabel?: string;
+    locateLabel?: string;
+    recentreLabel?: string;
+}> & Readonly<{
+    "onUpdate:modelValue"?: ((value: LatLon) => any) | undefined;
+}>, {
+    center: LatLon;
+    height: string;
+    zoom: number;
+    tiles: TileSource;
+    locatable: boolean;
+    zoomInLabel: string;
+    zoomOutLabel: string;
+    locateLabel: string;
+    recentreLabel: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;

package/dist/components/LpMediaGallery.vue.d.ts

@@ -0,0 +1,80 @@
+import type { LightboxItem } from "./lightbox";
+type __VLS_Props = {
+    /** Images in the set. The same shape LpLightbox takes. */
+    items: LightboxItem[];
+    /**
+     * Thumbnails per row. A number is that many at every width; an object is
+     * per breakpoint, e.g. `{ base: 2, md: 3, lg: 4 }`.
+     */
+    columns?: number | {
+        base?: number;
+        sm?: number;
+        md?: number;
+        lg?: number;
+        xl?: number;
+    };
+    /** Space between thumbnails, as a Tailwind gap step. */
+    gap?: 0 | 0.5 | 1 | 1.5 | 2 | 3 | 4;
+    /** Shape of each cell. `auto` lets the image decide its own height. */
+    aspect?: "square" | "video" | "auto";
+    /**
+     * Show at most this many, with the remainder as a "+N" badge over the last
+     * visible one — the usual treatment for a set too big for the space it has.
+     * Clicking the badge opens the lightbox at the first hidden image, because
+     * that is the one the count is about.
+     */
+    max?: number;
+    /** Open the lightbox on click. Off makes the grid a pure display. */
+    openable?: boolean;
+    /** Passed through to the lightbox. */
+    downloadable?: boolean;
+    /** Passed through to the lightbox. */
+    rotatable?: boolean;
+    /** Accessible name for the grid. */
+    ariaLabel?: string;
+};
+type __VLS_Slots = {
+    /** Replace a cell's contents. Gets the item and its index. */
+    item(props: {
+        item: LightboxItem;
+        index: number;
+    }): unknown;
+    /** Shown instead of the grid when `items` is empty. */
+    empty(): unknown;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {
+    /** Open the lightbox at an index — for a "view all" button outside the grid. */
+    openAt: (i: number) => void;
+    /** Uncover every spoiler in the set. */
+    revealAll: () => void;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    select: (item: LightboxItem, index: number) => any;
+    "update:open": (value: boolean) => any;
+    reveal: (item: LightboxItem) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onSelect?: ((item: LightboxItem, index: number) => any) | undefined;
+    "onUpdate:open"?: ((value: boolean) => any) | undefined;
+    onReveal?: ((item: LightboxItem) => any) | undefined;
+}>, {
+    columns: number | {
+        base?: number;
+        sm?: number;
+        md?: number;
+        lg?: number;
+        xl?: number;
+    };
+    gap: 0 | 0.5 | 1 | 1.5 | 2 | 3 | 4;
+    ariaLabel: string;
+    aspect: "square" | "video" | "auto";
+    rotatable: boolean;
+    downloadable: boolean;
+    openable: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/LpModal.vue.d.ts

@@ -0,0 +1,66 @@
+type __VLS_Props = {
+    open?: boolean;
+    title?: string;
+    description?: string;
+    /**
+     * Max content width preset. sm≈24rem … xl≈42rem, 2xl≈56rem, 3xl≈72rem,
+     * full≈96vw (near-fullscreen, for dense catalogues).
+     */
+    size?: "sm" | "md" | "lg" | "xl" | "2xl" | "3xl" | "full";
+    /** Explicit width override (any CSS length), wins over `size`. */
+    width?: string;
+    /**
+     * Let the body fill the available height as a flex column instead of
+     * scrolling itself. Use for dense dashboards that own their inner scroll
+     * regions (e.g. multi-pane catalogues) — the panes scroll, not the modal.
+     */
+    fillBody?: boolean;
+    /**
+     * Where the keyboard lands when the dialog opens. Default `"auto"` picks
+     * the first meaningful control in the body — a field to type in, or failing
+     * that the primary action — instead of the close button, which is what
+     * happens if the DOM order is left to decide.
+     *
+     * `"none"` leaves reka's own behaviour alone; pass a CSS selector to name
+     * the element yourself.
+     */
+    autoFocus?: "auto" | "none" | string;
+    /**
+     * Frosted glass instead of a solid panel: the page shows through,
+     * blurred, under a lighter scrim (.lp-glass-overlay, .lp-scrim--light).
+     * A look, not a behaviour, so it is the app's call: unset follows
+     * `provideGlass`, and without one it is off.
+     */
+    glass?: boolean;
+};
+declare var __VLS_31: {}, __VLS_39: {}, __VLS_58: {}, __VLS_66: {}, __VLS_68: {}, __VLS_70: {};
+type __VLS_Slots = {} & {
+    aside?: (props: typeof __VLS_31) => any;
+} & {
+    title?: (props: typeof __VLS_39) => any;
+} & {
+    default?: (props: typeof __VLS_58) => any;
+} & {
+    default?: (props: typeof __VLS_66) => any;
+} & {
+    footer?: (props: typeof __VLS_68) => any;
+} & {
+    asideEnd?: (props: typeof __VLS_70) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    "update:open": (value: boolean) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:open"?: ((value: boolean) => any) | undefined;
+}>, {
+    size: "sm" | "md" | "lg" | "xl" | "2xl" | "3xl" | "full";
+    autoFocus: "auto" | "none" | string;
+    glass: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/LpModalNav.vue.d.ts

@@ -0,0 +1,66 @@
+import type { SidebarItem, SidebarSection } from "./sidebar";
+export type { SidebarItem, SidebarSection } from "./sidebar";
+type Breakpoint = "sm" | "md" | "lg" | "xl";
+type __VLS_Props = {
+    open?: boolean;
+    /** Active section id (v-model). */
+    modelValue?: string;
+    /** Flat sections, or grouped ones — the shapes LpSidebar already takes. */
+    items?: SidebarItem[];
+    sections?: SidebarSection[];
+    title?: string;
+    description?: string;
+    size?: "sm" | "md" | "lg" | "xl" | "2xl" | "3xl" | "full";
+    width?: string;
+    /** Width of the nav rail (any CSS length). */
+    navWidth?: string;
+    /** Put a filter above the nav — see LpSidebar's `searchable`. */
+    searchable?: boolean;
+    searchPlaceholder?: string;
+    /** Skeleton rows in place of the nav while the sections load. */
+    loading?: boolean;
+    /** Breakpoint below which the rail becomes a drawer. */
+    mobileBreakpoint?: Breakpoint;
+    /** Label for the button that opens that drawer. */
+    navLabel?: string;
+    /** Stand the rail to the right of the dialog instead of the left. */
+    navSide?: "start" | "end";
+    /**
+     * Let the body fill the height instead of scrolling itself. Off by default,
+     * as in a plain modal: it existed here to make the rail a full-height
+     * column inside the body, and the rail is no longer in the body.
+     */
+    fillBody?: boolean;
+    /** Frosted glass panel, passed to LpModal. Follows `provideGlass` when unset. */
+    glass?: boolean;
+};
+declare var __VLS_36: {}, __VLS_38: {}, __VLS_41: {};
+type __VLS_Slots = {} & {
+    title?: (props: typeof __VLS_36) => any;
+} & {
+    default?: (props: typeof __VLS_38) => any;
+} & {
+    footer?: (props: typeof __VLS_41) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    "update:modelValue": (value: string) => any;
+    "update:open": (value: boolean) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: string) => any) | undefined;
+    "onUpdate:open"?: ((value: boolean) => any) | undefined;
+}>, {
+    size: "sm" | "md" | "lg" | "xl" | "2xl" | "3xl" | "full";
+    glass: boolean;
+    mobileBreakpoint: Breakpoint;
+    navWidth: string;
+    navLabel: string;
+    navSide: "start" | "end";
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/LpNotificationBell.vue.d.ts

@@ -0,0 +1,85 @@
+import { type ContextMenuItemDef } from "./LpContextMenu.vue";
+export interface NotificationItem {
+    id: string;
+    title: string;
+    body?: string;
+    /** Optional icon name (e.g. "lucide:check-circle"). */
+    icon?: string;
+    /**
+     * Colours the row's icon by what KIND of notification it is — a billing
+     * notice and a security one should not look alike at a glance.
+     *
+     * A named tone rather than a class, so the categories stay themeable:
+     * consumers were mapping their own types onto raw palette classes, which is
+     * the one place a theme cannot follow them.
+     */
+    tone?: "brand" | "action" | "danger" | "accent" | "muted";
+    /** Optional deep link; the row becomes clickable when set. */
+    link?: string;
+    /** ISO-8601 creation time; rendered as a relative label. */
+    createdAt?: string;
+    /** Whether the notification has been read. */
+    read?: boolean;
+}
+/**
+ * Every user-facing string the bell renders on its own. Apps with i18n pass
+ * their translations in; the English defaults keep the component usable bare.
+ * Without this the header/row menus would be hardcoded English in every locale.
+ */
+export interface NotificationLabels {
+    title?: string;
+    markAllRead?: string;
+    clear?: string;
+    markAsRead?: string;
+    markAsUnread?: string;
+    open?: string;
+    dismiss?: string;
+    empty?: string;
+    ariaLabel?: string;
+}
+type __VLS_Props = {
+    items?: NotificationItem[];
+    /** Unread count for the badge; falls back to counting unread items. */
+    unreadCount?: number;
+    loading?: boolean;
+    emptyLabel?: string;
+    title?: string;
+    /** Cap the badge display (e.g. "9+"). */
+    maxBadge?: number;
+    /** Right-click menu items; overrides the built-in quick actions. */
+    menuItems?: ContextMenuItemDef[];
+    /** Translations for the strings the bell renders itself. */
+    labels?: NotificationLabels;
+    /**
+     * Formats `item.createdAt` for display. Defaults to a compact English
+     * relative time ("just now", "5m", "3h"); pass your own to localise it.
+     */
+    formatTime?: (iso: string) => string;
+};
+type __VLS_ModelProps = {
+    "open"?: boolean;
+};
+type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
+declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:open": (value: boolean) => any;
+} & {
+    clear: () => any;
+    select: (item: NotificationItem) => any;
+    dismiss: (id: string) => any;
+    markRead: (id: string) => any;
+    markUnread: (id: string) => any;
+    markAllRead: () => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+    onClear?: (() => any) | undefined;
+    onSelect?: ((item: NotificationItem) => any) | undefined;
+    "onUpdate:open"?: ((value: boolean) => any) | undefined;
+    onDismiss?: ((id: string) => any) | undefined;
+    onMarkRead?: ((id: string) => any) | undefined;
+    onMarkUnread?: ((id: string) => any) | undefined;
+    onMarkAllRead?: (() => any) | undefined;
+}>, {
+    items: NotificationItem[];
+    maxBadge: number;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;