@leavepulse/ui 0.57.0 → 0.58.1

package/dist/components/LpEmptyState.vue.js

@@ -1,4 +1,4 @@
-import { _ as _sfc_main } from "../chunks/LpEmptyState-BJbZXC8D.js";
+import { _ as _sfc_main } from "../chunks/LpEmptyState-CBwwkkdA.js";
 export {
   _sfc_main as default
 };

package/dist/components/LpFieldNotice.vue.js

@@ -1,4 +1,4 @@
-import { _ as _sfc_main } from "../chunks/LpFieldNotice-wtieLUTj.js";
+import { _ as _sfc_main } from "../chunks/LpFieldNotice-9hH4ITZa.js";
 export {
   _sfc_main as default
 };

package/dist/components/LpFileTree.vue.js

@@ -1,4 +1,4 @@
-import { _ as _sfc_main } from "../chunks/LpFileTree-3E4w4Rjr.js";
+import { _ as _sfc_main } from "../chunks/LpFileTree-CMA0_rsB.js";
 export {
   _sfc_main as default
 };

package/dist/components/LpFileTreeNode.vue.js

@@ -1,4 +1,4 @@
-import { _ as _sfc_main } from "../chunks/LpFileTreeNode-B4uB8Ks_.js";
+import { _ as _sfc_main } from "../chunks/LpFileTreeNode-B4T258hF.js";
 export {
   _sfc_main as default
 };

package/dist/components/LpFormField.vue.js

@@ -1,4 +1,4 @@
-import { _ as _sfc_main } from "../chunks/LpFormField-CtVYj6tO.js";
+import { _ as _sfc_main } from "../chunks/LpFormField-BpQ6WJPe.js";
 export {
   _sfc_main as default
 };

package/dist/components/LpHintLayer.vue.js

@@ -1,4 +1,4 @@
-import { _ as _sfc_main } from "../chunks/LpHintLayer-CI1oZ9Pd.js";
+import { _ as _sfc_main } from "../chunks/LpHintLayer-B5-6FyEf.js";
 export {
   _sfc_main as default
 };

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

@@ -0,0 +1,20 @@
+import { type HintSystem } from "../composables/useHintSystem";
+type __VLS_Props = {
+    system: HintSystem;
+    labels?: Partial<typeof DEFAULT_LABELS>;
+};
+declare const DEFAULT_LABELS: {
+    tourTitle: string;
+    tourText: string;
+    assignedTitle: string;
+    assignedText: string;
+    newsTitle: string;
+    show: string;
+    notNow: string;
+    never: string;
+    gotIt: string;
+    noThanks: string;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/LpHints.vue.js

@@ -0,0 +1,4 @@
+import { _ as _sfc_main } from "../chunks/LpHints-BqoZXHZk.js";
+export {
+  _sfc_main as default
+};

package/dist/components/LpIcon.vue.js

@@ -1,4 +1,4 @@
-import { _ as _sfc_main } from "../chunks/LpIcon-DYtaid0K.js";
+import { _ as _sfc_main } from "../chunks/LpIcon-B5guGKrW.js";
 export {
   _sfc_main as default
 };

package/dist/components/LpImageEditor.vue.js

@@ -4,9 +4,9 @@ import { isSideways, coverScale, cropGeometry } from "./imageCrop.js";
 import { useHotkeys } from "../composables/useHotkeys.js";
 import { useReveal } from "../composables/useReveal.js";
 import { useZoomPan } from "../composables/useZoomPan.js";
-import { _ as _sfc_main$1 } from "../chunks/LpButton-BdfZFNqi.js";
+import { _ as _sfc_main$1 } from "../chunks/LpButton-vhlwmpBy.js";
 import "reka-ui";
-import { _ as _sfc_main$2 } from "../chunks/LpIcon-DYtaid0K.js";
+import { _ as _sfc_main$2 } from "../chunks/LpIcon-B5guGKrW.js";
 import { useMergedAttrs } from "../composables/useMergedClass.js";
 import { _ as _export_sfc } from "../chunks/_plugin-vue_export-helper-1tPrXgE0.js";
 import '../assets/LpImageEditor-CbMA82g8.css';const _hoisted_1 = ["aria-label"];

package/dist/components/LpInput.vue.js

@@ -1,4 +1,4 @@
-import { _ as _sfc_main } from "../chunks/LpInput-D-YGQbEv.js";
+import { _ as _sfc_main } from "../chunks/LpInput-WvyP02ID.js";
 export {
   _sfc_main as default
 };

package/dist/components/LpLightbox.vue.js

@@ -1,4 +1,4 @@
-import { _ as _sfc_main } from "../chunks/LpLightbox-EVXzAq62.js";
+import { _ as _sfc_main } from "../chunks/LpLightbox-Dq-e36uT.js";
 export {
   _sfc_main as default
 };

package/dist/components/LpLogViewer.vue.js

@@ -1,4 +1,4 @@
-import { _ as _sfc_main } from "../chunks/LpLogViewer-BfgtXVKm.js";
+import { _ as _sfc_main } from "../chunks/LpLogViewer-DwiYE32z.js";
 export {
   _sfc_main as default
 };

package/dist/components/LpMapPicker.vue.js

@@ -1,4 +1,4 @@
-import { _ as _sfc_main } from "../chunks/LpMapPicker-Cc84LaM3.js";
+import { _ as _sfc_main } from "../chunks/LpMapPicker-BH5csaBt.js";
 export {
   _sfc_main as default
 };

package/dist/components/LpMediaGallery.vue.js

@@ -1,4 +1,4 @@
-import { _ as _sfc_main } from "../chunks/LpMediaGallery-BnlkN_1f.js";
+import { _ as _sfc_main } from "../chunks/LpMediaGallery-B1kDypJ-.js";
 export {
   _sfc_main as default
 };

package/dist/components/LpModal.vue.js

@@ -1,4 +1,4 @@
-import { _ as _sfc_main } from "../chunks/LpModal-JNa3B_Lr.js";
+import { _ as _sfc_main } from "../chunks/LpModal-BxYssnXg.js";
 export {
   _sfc_main as default
 };

package/dist/components/LpModalNav.vue.js

@@ -1,4 +1,4 @@
-import { _ as _sfc_main } from "../chunks/LpModalNav-DXyAyhQl.js";
+import { _ as _sfc_main } from "../chunks/LpModalNav-Bn2ws64b.js";
 export {
   _sfc_main as default
 };

package/dist/components/LpNotificationBell.vue.js

@@ -1,4 +1,4 @@
-import { _ as _sfc_main } from "../chunks/LpNotificationBell-DEL-RoHS.js";
+import { _ as _sfc_main } from "../chunks/LpNotificationBell-DJfs4JjQ.js";
 export {
   _sfc_main as default
 };

package/dist/components/LpNumberField.vue.js

@@ -1,4 +1,4 @@
-import { _ as _sfc_main } from "../chunks/LpNumberField-B77O-z28.js";
+import { _ as _sfc_main } from "../chunks/LpNumberField-CJPjmoDz.js";
 export {
   _sfc_main as default
 };

package/dist/components/LpPagination.vue.js

@@ -1,4 +1,4 @@
-import { _ as _sfc_main } from "../chunks/LpPagination-BcDlo3r_.js";
+import { _ as _sfc_main } from "../chunks/LpPagination-DehAaJLY.js";
 export {
   _sfc_main as default
 };

package/dist/components/LpPaletteFacts.vue.js

@@ -1,6 +1,6 @@
 import { defineComponent, openBlock, createElementBlock, normalizeClass, toDisplayString, createCommentVNode, createElementVNode, Fragment, renderList, normalizeStyle, createBlock, createVNode, renderSlot } from "vue";
 import { _ as _sfc_main$2 } from "../chunks/HighlightText-BvnYZkhi.js";
-import { _ as _sfc_main$1 } from "../chunks/LpIcon-DYtaid0K.js";
+import { _ as _sfc_main$1 } from "../chunks/LpIcon-B5guGKrW.js";
 import { _ as _sfc_main$3 } from "../chunks/LpRollingText-DB7upf-5.js";
 import { _ as _export_sfc } from "../chunks/_plugin-vue_export-helper-1tPrXgE0.js";
 import '../assets/LpPaletteFacts-B9FdVmIO.css';const _hoisted_1 = {

package/dist/components/LpPaletteHeader.vue.js

@@ -1,6 +1,6 @@
 import { defineComponent, computed, openBlock, createElementBlock, createElementVNode, renderSlot, createBlock, createVNode, createCommentVNode, toDisplayString } from "vue";
-import { _ as _sfc_main$1 } from "../chunks/LpAvatar-LTvy0OkE.js";
-import { _ as _sfc_main$2 } from "../chunks/LpIcon-DYtaid0K.js";
+import { _ as _sfc_main$1 } from "../chunks/LpAvatar-BxNs23Xu.js";
+import { _ as _sfc_main$2 } from "../chunks/LpIcon-B5guGKrW.js";
 import { _ as _sfc_main$3 } from "../chunks/HighlightText-BvnYZkhi.js";
 import { _ as _export_sfc } from "../chunks/_plugin-vue_export-helper-1tPrXgE0.js";
 import '../assets/LpPaletteHeader-BVOu1UX5.css';const _hoisted_1 = { class: "lp-palette-header" };

package/dist/components/LpPasswordInput.vue.js

@@ -1,4 +1,4 @@
-import { _ as _sfc_main } from "../chunks/LpPasswordInput-eKzQhbQP.js";
+import { _ as _sfc_main } from "../chunks/LpPasswordInput-Bg5uTZbx.js";
 export {
   _sfc_main as default
 };

package/dist/components/LpPhoneInput.vue.js

@@ -1,4 +1,4 @@
-import { _ as _sfc_main } from "../chunks/LpPhoneInput-BCbrrhgE.js";
+import { _ as _sfc_main } from "../chunks/LpPhoneInput-DStwcbnQ.js";
 export {
   _sfc_main as default
 };

package/dist/components/LpPie.vue.js

@@ -1,4 +1,4 @@
-import { _ as _sfc_main } from "../chunks/LpPie-CXka8Jvx.js";
+import { _ as _sfc_main } from "../chunks/LpPie-DeTkbbOK.js";
 export {
   _sfc_main as default
 };

package/dist/components/LpRangeCalendar.vue.js

@@ -1,4 +1,4 @@
-import { _ as _sfc_main } from "../chunks/LpRangeCalendar-DZuaRV0W.js";
+import { _ as _sfc_main } from "../chunks/LpRangeCalendar-D5sDID9W.js";
 export {
   _sfc_main as default
 };

package/dist/components/LpSection.vue.js

@@ -1,4 +1,4 @@
-import { _ as _sfc_main } from "../chunks/LpSection-tKEH0jYf.js";
+import { _ as _sfc_main } from "../chunks/LpSection-B19VPYmr.js";
 export {
   _sfc_main as default
 };

package/dist/components/LpSegmented.vue.js

@@ -1,4 +1,4 @@
-import { _ as _sfc_main } from "../chunks/LpSegmented-C09EEam2.js";
+import { _ as _sfc_main } from "../chunks/LpSegmented-D3Eam8sa.js";
 export {
   _sfc_main as default
 };

package/dist/components/LpSelect.vue.js

@@ -1,4 +1,4 @@
-import { _ as _sfc_main } from "../chunks/LpSelect-DNIL6MB9.js";
+import { _ as _sfc_main } from "../chunks/LpSelect-DynjWK1A.js";
 export {
   _sfc_main as default
 };

package/dist/components/LpShortcutsDialog.vue.js

@@ -1,6 +1,6 @@
 import { defineComponent, computed, openBlock, createBlock, unref, withCtx, createElementVNode, createElementBlock, Fragment, renderList, toDisplayString, createTextVNode, createCommentVNode, createVNode } from "vue";
 import LpKeys from "./LpKeys.vue.js";
-import { _ as _sfc_main$1 } from "../chunks/LpModal-JNa3B_Lr.js";
+import { _ as _sfc_main$1 } from "../chunks/LpModal-BxYssnXg.js";
 import { mergeShortcutGroups, activeShortcuts, useHotkeys } from "../composables/useHotkeys.js";
 import { useLabels } from "../composables/useLpConfig.js";
 import { _ as _export_sfc } from "../chunks/_plugin-vue_export-helper-1tPrXgE0.js";

package/dist/components/LpSidebar.vue.js

@@ -1,4 +1,4 @@
-import { _ as _sfc_main } from "../chunks/LpSidebar-hZ8D1cVr.js";
+import { _ as _sfc_main } from "../chunks/LpSidebar-CshW0fqC.js";
 export {
   _sfc_main as default
 };

package/dist/components/LpSidebarNav.vue.js

@@ -1,4 +1,4 @@
-import { _ as _sfc_main } from "../chunks/LpSidebarNav-C9dHu-2b.js";
+import { _ as _sfc_main } from "../chunks/LpSidebarNav-C9b3i9G2.js";
 export {
   _sfc_main as default
 };

package/dist/components/LpStat.vue.js

@@ -1,4 +1,4 @@
-import { _ as _sfc_main } from "../chunks/LpStat-B-7udBRP.js";
+import { _ as _sfc_main } from "../chunks/LpStat-BS2TEXYK.js";
 export {
   _sfc_main as default
 };

package/dist/components/LpStepper.vue.js

@@ -1,4 +1,4 @@
-import { _ as _sfc_main } from "../chunks/LpStepper-C7XiVKZj.js";
+import { _ as _sfc_main } from "../chunks/LpStepper-BSglWF45.js";
 export {
   _sfc_main as default
 };

package/dist/components/LpTable.vue.js

@@ -1,20 +1,20 @@
 import { defineComponent, computed, useAttrs, ref, shallowRef, watch, onMounted, onBeforeUnmount, openBlock, createElementBlock, normalizeClass, createVNode, withCtx, createTextVNode, toDisplayString, createCommentVNode, Fragment, renderList, createElementVNode, Transition, renderSlot, mergeProps, normalizeStyle, createBlock, TransitionGroup, unref, withModifiers, nextTick } from "vue";
-import { _ as _sfc_main$7 } from "../chunks/LpCheckbox-DvVYeOD-.js";
-import { _ as _sfc_main$6 } from "../chunks/LpContextMenu-EF_90u3g.js";
-import { _ as _sfc_main$2 } from "../chunks/LpIcon-DYtaid0K.js";
-import { _ as _sfc_main$a } from "../chunks/LpPagination-BcDlo3r_.js";
+import { _ as _sfc_main$7 } from "../chunks/LpCheckbox-B_C8sOoT.js";
+import { _ as _sfc_main$6 } from "../chunks/LpContextMenu-B1NGfpp1.js";
+import { _ as _sfc_main$2 } from "../chunks/LpIcon-B5guGKrW.js";
+import { _ as _sfc_main$a } from "../chunks/LpPagination-DehAaJLY.js";
 import { _ as _sfc_main$8 } from "../chunks/LpPopover-DCKeqiVn.js";
 import { _ as _sfc_main$5 } from "../chunks/LpScrollArea-Hz3-JWUG.js";
 import { _ as _sfc_main$4 } from "../chunks/LpRollingText-DB7upf-5.js";
 import { _ as _sfc_main$3 } from "../chunks/LpShift-DXNsauQZ.js";
-import { _ as _sfc_main$9 } from "../chunks/LpTableFilter-CrW7_Rj4.js";
+import { _ as _sfc_main$9 } from "../chunks/LpTableFilter-CwHXVxJt.js";
 import { useAsyncTask } from "../composables/useAsyncTask.js";
 import { useHotkeys } from "../composables/useHotkeys.js";
 import { usePaintSelect } from "../composables/usePaintSelect.js";
 import { useRovingFocus } from "../composables/useRovingFocus.js";
 import { useLabels } from "../composables/useLpConfig.js";
 import { compareValues } from "./tableSort.js";
-import { _ as _sfc_main$1 } from "../chunks/LpButton-BdfZFNqi.js";
+import { _ as _sfc_main$1 } from "../chunks/LpButton-vhlwmpBy.js";
 import { toCsv, downloadFile, fileStem } from "./exportData.js";
 import { summarizeShown, parseTableState, serializeTableState, countValues } from "./tableFilter.js";
 import { _ as _export_sfc } from "../chunks/_plugin-vue_export-helper-1tPrXgE0.js";

package/dist/components/LpTableFilter.vue.js

@@ -1,4 +1,4 @@
-import { _ as _sfc_main } from "../chunks/LpTableFilter-CrW7_Rj4.js";
+import { _ as _sfc_main } from "../chunks/LpTableFilter-CwHXVxJt.js";
 export {
   _sfc_main as default
 };

package/dist/components/LpTabs.vue.js

@@ -1,4 +1,4 @@
-import { _ as _sfc_main } from "../chunks/LpTabs-BMSBB78h.js";
+import { _ as _sfc_main } from "../chunks/LpTabs-BBGRHY38.js";
 export {
   _sfc_main as default
 };

package/dist/components/LpTagsInput.vue.js

@@ -1,4 +1,4 @@
-import { _ as _sfc_main } from "../chunks/LpTagsInput-D1SuqbhB.js";
+import { _ as _sfc_main } from "../chunks/LpTagsInput-CHbQoAAA.js";
 export {
   _sfc_main as default
 };

package/dist/components/LpTextarea.vue.js

@@ -1,4 +1,4 @@
-import { _ as _sfc_main } from "../chunks/LpTextarea-uuScWo6-.js";
+import { _ as _sfc_main } from "../chunks/LpTextarea-Bz2IWhTH.js";
 export {
   _sfc_main as default
 };

package/dist/components/LpThemeSwitcher.vue.js

@@ -1,4 +1,4 @@
-import { _ as _sfc_main } from "../chunks/LpThemeSwitcher-Fz85BCRS.js";
+import { _ as _sfc_main } from "../chunks/LpThemeSwitcher-B_qhSl7q.js";
 export {
   _sfc_main as default
 };

package/dist/components/LpTimeField.vue.js

@@ -1,4 +1,4 @@
-import { _ as _sfc_main } from "../chunks/LpTimeField-Cqe7fXnh.js";
+import { _ as _sfc_main } from "../chunks/LpTimeField-DvGXgdES.js";
 export {
   _sfc_main as default
 };

package/dist/components/LpToaster.vue.js

@@ -1,4 +1,4 @@
-import { _ as _sfc_main } from "../chunks/LpToaster-DTtWuKvq.js";
+import { _ as _sfc_main } from "../chunks/LpToaster-Bo9Q4QBP.js";
 export {
   _sfc_main as default
 };

package/dist/components/LpTour.vue.js

@@ -1,4 +1,4 @@
-import { _ as _sfc_main } from "../chunks/LpTour-C1TC2GyY.js";
+import { _ as _sfc_main } from "../chunks/LpTour-D7m9ZxNk.js";
 export {
   _sfc_main as default
 };

package/dist/components/MenuTitle.vue.js

@@ -1,4 +1,4 @@
-import { _ as _sfc_main } from "../chunks/MenuTitle-J3ZDYjpV.js";
+import { _ as _sfc_main } from "../chunks/MenuTitle-DQP6hc2N.js";
 export {
   _sfc_main as default
 };

package/dist/components/TourCard.vue.js

@@ -1,4 +1,4 @@
-import { _ as _sfc_main } from "../chunks/TourCard-BQS3ztqj.js";
+import { _ as _sfc_main } from "../chunks/TourCard-DCHOjr6e.js";
 export {
   _sfc_main as default
 };

package/dist/composables/useHintSystem.d.ts

@@ -0,0 +1,195 @@
+import { type ComputedRef } from "vue";
+import type { HintNote } from "../components/LpHintLayer.vue";
+import type { TourContext, TourStep } from "../components/LpTour.vue";
+export interface HintFeature {
+    page: string;
+    title: string;
+    text: string;
+    order?: number;
+    keys?: string;
+    try?: boolean;
+    side?: TourStep["side"];
+    /** Bump to announce a changed feature again: it reads as new to everyone. */
+    rev?: number;
+    /** Keeps its dot until explained, even after "not now". */
+    required?: boolean;
+    /**
+     * Rendered only in some states (data-dependent, behind a filter). Its first
+     * appearance is not news, so it is never marked new for merely showing up;
+     * a `rev` bump still announces it.
+     */
+    conditional?: boolean;
+    /** When the `v-hint` id is not the element to light (a column header, an opened menu). */
+    target?: () => Element | null;
+    enter?: (context: TourContext) => void | Promise<void>;
+}
+export interface HintPage {
+    title: string;
+    /**
+     * A localStorage key prefix that proves the user worked on this page before
+     * the system existed (a remembered table layout). Such a page is treated as
+     * known on first sight: no tour offer, no dots for what was always there.
+     */
+    known?: string;
+}
+export interface HintNews {
+    id: string;
+    date: string;
+    page: string;
+    text: string;
+    feature?: string;
+}
+export interface HintNudge {
+    id: string;
+    feature: string;
+    text: string;
+}
+export type HintLevel = "seen" | "explained" | "used";
+export interface HintRecord {
+    state: HintLevel;
+    dismissed: boolean;
+    count: number;
+    assigned?: boolean;
+    updatedAt: string;
+}
+export interface HintDelta {
+    key: string;
+    state?: HintLevel;
+    dismissed?: boolean;
+    add?: number;
+}
+export interface HintStorage {
+    load(): Promise<Record<string, HintRecord>> | Record<string, HintRecord>;
+    save(deltas: HintDelta[]): Promise<void> | void;
+    /** Last chance on page hide (sendBeacon); falls back to `save`. */
+    saveOnLeave?(deltas: HintDelta[]): void;
+}
+export interface HintTiming {
+    settle: number;
+    offerAgain: number;
+    offersMax: number;
+    freshLimit: number;
+    nudgeAgain: number;
+    flush: number;
+}
+export interface HintSystemOptions {
+    features: Record<string, HintFeature>;
+    pages?: Record<string, HintPage>;
+    news?: HintNews[];
+    storage?: HintStorage;
+    /** The current page id, read reactively (map your route to it). */
+    page: () => string;
+    sessionKey?: string;
+    timing?: Partial<HintTiming>;
+}
+export type HintOffer = {
+    kind: "tour" | "assigned";
+    page: string;
+} | {
+    kind: "news";
+    page: string;
+    items: HintNews[];
+} | {
+    kind: "nudge";
+    page: string;
+    nudge: HintNudge;
+};
+/** Records in localStorage: for anonymous sessions and apps without a server. */
+export declare function localHintStorage(key?: string): HintStorage;
+/** Record keys, for apps that read or assign records directly (a "who knows what" view). */
+export declare const hintKey: {
+    feature: (id: string, rev?: number) => string;
+    page: (page: string) => string;
+    news: (id: string) => string;
+    nudge: (id: string) => string;
+};
+export interface HintSummary {
+    tour: "done" | "assigned" | "declined" | "offered" | "never";
+    offers: number;
+    known: number;
+    total: number;
+    /** Titles of `required` features this person has not been shown. */
+    missing: string[];
+}
+/** What one person knows of a page, from their records: for a manager's view. */
+export declare function hintSummary(records: Map<string, Pick<HintRecord, "state" | "dismissed" | "count" | "assigned">>, features: Record<string, HintFeature>, page: string): HintSummary;
+export declare function createHintSystem(options: HintSystemOptions): {
+    state: {
+        records: Map<string, {
+            state: HintLevel;
+            dismissed: boolean;
+            count: number;
+            assigned?: boolean | undefined;
+            updatedAt: string;
+        }> & Omit<Map<string, HintRecord>, keyof Map<any, any>>;
+        loaded: boolean;
+        page: string;
+        tour: {
+            open: boolean;
+            step: number;
+            steps: {
+                target?: (string | Element | (() => Element | null)) | undefined;
+                title: string;
+                text?: string | undefined;
+                keys?: string | undefined;
+                side?: "top" | "right" | "bottom" | "left" | undefined;
+                try?: boolean | undefined;
+                perform?: (() => void | Promise<void>) | undefined;
+                enter?: ((context: TourContext) => void | Promise<void>) | undefined;
+            }[];
+            ids: string[];
+            page: string;
+        };
+        offer: {
+            kind: "tour" | "assigned";
+            page: string;
+        } | {
+            kind: "news";
+            page: string;
+            items: {
+                id: string;
+                date: string;
+                page: string;
+                text: string;
+                feature?: string | undefined;
+            }[];
+        } | {
+            kind: "nudge";
+            page: string;
+            nudge: {
+                id: string;
+                feature: string;
+                text: string;
+            };
+        } | null;
+        candidate: {
+            id: string;
+            feature: string;
+            text: string;
+            page: string;
+        } | null;
+        settledAt: number;
+        intent: boolean;
+    };
+    fresh: ComputedRef<string[]>;
+    notes: ComputedRef<Record<string, HintNote>>;
+    start: () => void;
+    stop: () => void;
+    hasTour: (page?: string) => boolean;
+    startTour: (page?: string, only?: string[]) => void;
+    load(): Promise<void>;
+    /** Ask for a nudge; it shows when the budget and the page allow. */
+    nudge(n: HintNudge): void;
+    /** The user navigated on purpose (palette, notification): do not interrupt this arrival. */
+    markIntent(): void;
+    unreadNews: (page?: string) => HintNews[];
+    readNews: (page: string) => void;
+    pageTitle: (page: string) => string;
+    readFresh(id: string): void;
+    tourShown(index: number): void;
+    tourEnded(finished: boolean): void;
+    answer(choice: "show" | "later" | "never"): void;
+};
+export type HintSystem = ReturnType<typeof createHintSystem>;
+export declare function provideHintSystem(system: HintSystem): void;
+export declare function useHintSystem(): HintSystem | null;