@leavepulse/ui 0.59.0 → 0.61.0

package/dist/composables/useHintSystem.js

@@ -1,6 +1,55 @@
-import { provide, reactive, computed, inject, watch } from "vue";
+import { shallowRef, provide, onBeforeUnmount, reactive, computed, inject, watch } from "vue";
 import { anyModalOpen } from "../components/modalDepth.js";
 import { hints } from "./useHints.js";
+const HINT_SIGNALS = {
+  /** A context menu was opened (right click or long press). */
+  contextMenu: "lp.context-menu",
+  /** A "…" menu marked `rightClickToo` was opened: its items were one right click away. */
+  menuButton: "lp.menu-button",
+  /** A left click on something that also has a context menu. */
+  contextTarget: "lp.context-target",
+  /** The command palette was opened. */
+  palette: "lp.palette",
+  /** The current hint page changed: a navigation. */
+  navigate: "lp.navigate",
+  /** An item's actions were opened in the palette (Tab). */
+  paletteActions: "lp.palette-actions"
+};
+let lastContextTarget = null;
+function noteContextTarget(el) {
+  lastContextTarget = new WeakRef(el);
+}
+const onScreen = (el) => {
+  const box = el.getBoundingClientRect();
+  return el.isConnected && box.width > 0 && box.bottom > 0 && box.top < window.innerHeight;
+};
+function rightClickTarget() {
+  const last = lastContextTarget?.deref();
+  if (last && onScreen(last)) return last;
+  const visible = (selector) => [...document.querySelectorAll(selector)].find(onScreen) ?? null;
+  return visible("[data-lp-context-row]") ?? visible("main [data-lp-context-menu]") ?? visible("[data-lp-context-menu]");
+}
+function contextMenuTip(text = {}) {
+  return {
+    id: "lp.tip.context-menu",
+    title: text.title ?? "Right-click works here",
+    text: text.text ?? "Rows and cards open their actions on right-click, even where no … button shows it.",
+    when: (count) => count(HINT_SIGNALS.contextMenu) === 0 && (count(HINT_SIGNALS.menuButton) >= 5 || count(HINT_SIGNALS.contextTarget) >= 25),
+    step: () => {
+      const target = rightClickTarget();
+      return target ? { target, title: text.title ?? "Right-click works here", text: text.stepText ?? "Right-click this to see what it can do.", try: true } : null;
+    }
+  };
+}
+function paletteTip(keys = "Ctrl+K", text = {}) {
+  return {
+    id: "lp.tip.palette",
+    title: text.title ?? "Jump anywhere",
+    text: text.text ?? "Search pages, people and settings from anywhere instead of the menu.",
+    keys,
+    when: (count) => count(HINT_SIGNALS.navigate) >= 15 && count(HINT_SIGNALS.palette) === 0
+  };
+}
 const RANK = { seen: 0, explained: 1, used: 2 };
 const DAY = 24 * 3600 * 1e3;
 const DEFAULT_TIMING = {
@@ -69,12 +118,15 @@ function createHintSystem(options) {
   const features = options.features;
   const pages = options.pages ?? {};
   const news = options.news ?? [];
+  const tips = options.tips ?? [];
+  const TIP_MAX = 3;
   const storage = options.storage ?? localHintStorage();
   const sessionKey = options.sessionKey ?? "lp-hints:interrupted";
   const state = reactive({
     records: /* @__PURE__ */ new Map(),
     loaded: false,
     page: "",
+    overlay: null,
     tour: { open: false, step: 0, steps: [], ids: [], page: "" },
     offer: null,
     candidate: null,
@@ -87,6 +139,9 @@ function createHintSystem(options) {
   const pageKey = hintKey.page;
   const newsKey = hintKey.news;
   const nudgeKey = hintKey.nudge;
+  const signalKey = (name) => `u:${name}`;
+  const tipKey = (id) => `p:${id}`;
+  const count = (name) => state.records.get(signalKey(name))?.count ?? 0;
   function interrupted() {
     try {
       return sessionStorage.getItem(sessionKey) === "1";
@@ -213,21 +268,35 @@ function createHintSystem(options) {
       return;
     }
     const n = state.candidate;
-    if (!n || n.page !== page) return;
-    const seen = state.records.get(nudgeKey(n.id));
-    if (seen?.dismissed || state.records.get(featureKey(n.feature))?.state === "used" || !hints.present(n.feature)) return;
-    if (seen && Date.now() - Date.parse(seen.updatedAt) < timing.nudgeAgain) return;
-    state.candidate = null;
-    spend();
-    record(nudgeKey(n.id), { add: 1 });
-    state.offer = { kind: "nudge", page, nudge: n };
+    if (n && n.page === page) {
+      const seen = state.records.get(nudgeKey(n.id));
+      const f = features[n.feature];
+      const visible = !!f && (!!f.target || !!f.enter || hints.present(n.feature));
+      if (!seen?.dismissed && state.records.get(featureKey(n.feature))?.state !== "used" && visible && !(seen && Date.now() - Date.parse(seen.updatedAt) < timing.nudgeAgain)) {
+        state.candidate = null;
+        spend();
+        record(nudgeKey(n.id), { add: 1 });
+        state.offer = { kind: "nudge", page, nudge: n };
+        return;
+      }
+    }
+    for (const tip of tips) {
+      const seen = state.records.get(tipKey(tip.id));
+      if (seen?.dismissed || (seen?.count ?? 0) >= (tip.max ?? TIP_MAX)) continue;
+      if (seen && Date.now() - Date.parse(seen.updatedAt) < timing.nudgeAgain) continue;
+      if (!tip.when(count)) continue;
+      spend();
+      state.offer = { kind: "tip", page, tip };
+      return;
+    }
   }
   let stops = [];
   function start() {
     if (stops.length) return;
     const stopPage = watch(
-      options.page,
-      (page) => {
+      () => state.overlay ?? options.page(),
+      (page, previous) => {
+        if (previous !== void 0 && page !== previous && !state.overlay) record(signalKey(HINT_SIGNALS.navigate), { add: 1 });
         state.page = page;
         state.settledAt = Date.now();
         if (state.offer && state.offer.page !== page) state.offer = null;
@@ -249,6 +318,7 @@ function createHintSystem(options) {
       stopPage,
       hints.on("used", (id) => {
         if (features[id]) record(featureKey(id), { state: "used", add: 1 });
+        if (id.startsWith("lp.") || !features[id]) record(signalKey(id), { add: 1 });
       }),
       () => clearInterval(poll),
       () => window.removeEventListener("pagehide", flushOnLeave)
@@ -279,6 +349,16 @@ function createHintSystem(options) {
     nudge(n) {
       state.candidate = { ...n, page: state.page };
     },
+    /**
+     * A dialog acts as its own page while open (its dots and tour), then hands
+     * back. Pass null on close, and on unmount: a dialog left open by a route
+     * change would otherwise keep the page.
+     */
+    overlay(page) {
+      state.overlay = page;
+    },
+    /** How many times a signal was reported (for an app's own tips or reports). */
+    count,
     /** The user navigated on purpose (palette, notification): do not interrupt this arrival. */
     markIntent() {
       state.intent = true;
@@ -294,6 +374,7 @@ function createHintSystem(options) {
       if (id) record(featureKey(id), { state: "explained" });
     },
     tourEnded(finished) {
+      if (!state.tour.ids.length) return;
       record(pageKey(state.tour.page), finished ? { state: "explained" } : { add: 1 });
       baseline(state.tour.page);
     },
@@ -305,6 +386,10 @@ function createHintSystem(options) {
         const ids = offer.items.map((n) => n.feature).filter((id) => !!id);
         readNews(offer.page);
         if (choice === "show" && ids.length) startTour(offer.page, ids);
+      } else if (offer.kind === "tip") {
+        record(tipKey(offer.tip.id), { add: 1, dismissed: choice === "never" });
+        const step = choice === "show" ? offer.tip.step?.() : null;
+        if (step) Object.assign(state.tour, { open: true, step: 0, page: offer.page, ids: [], steps: [step] });
       } else if (offer.kind === "nudge") {
         if (choice === "show") startTour(features[offer.nudge.feature].page, [offer.nudge.feature]);
         else record(nudgeKey(offer.nudge.id), { dismissed: true });
@@ -318,17 +403,30 @@ function createHintSystem(options) {
   };
 }
 const HINT_SYSTEM = /* @__PURE__ */ Symbol.for("lp-hint-system");
+const running = shallowRef(null);
 function provideHintSystem(system) {
   provide(HINT_SYSTEM, system);
+  running.value = system;
+  onBeforeUnmount(() => {
+    if (running.value === system) running.value = null;
+  });
 }
 function useHintSystem() {
-  return inject(HINT_SYSTEM, null);
+  return inject(HINT_SYSTEM, null) ?? running.value;
+}
+function runningHintSystem() {
+  return running.value;
 }
 export {
+  HINT_SIGNALS,
+  contextMenuTip,
   createHintSystem,
   hintKey,
   hintSummary,
   localHintStorage,
+  noteContextTarget,
+  paletteTip,
   provideHintSystem,
+  runningHintSystem,
   useHintSystem
 };

package/dist/composables/useToast.d.ts

@@ -19,6 +19,8 @@ export interface ToastItem {
     actions?: ToastAction[];
     /** Whole-toast click handler (UAProject-style clickable toast). */
     onClick?: () => void | Promise<void>;
+    /** Copied with the message, not shown: what a bug report needs (request, status, ids). */
+    details?: string;
 }
 export interface ToastOptions {
     /**
@@ -31,12 +33,19 @@ export interface ToastOptions {
     duration?: number;
     actions?: ToastAction[];
     onClick?: () => void | Promise<void>;
+    /** Copied with the message, not shown. An Error passed to `error()` brings its own `details`. */
+    details?: string;
+    /** The error behind a hand-written message ("Not saved: " + e.message): its `details` ride along. */
+    cause?: unknown;
 }
-declare function push(variant: ToastVariant, message: string, options?: ToastOptions): number;
+export type ToastMessage = string | (Error & {
+    details?: string;
+});
+declare function push(variant: ToastVariant, input: ToastMessage, given?: ToastOptions): number;
 export interface ToastPromiseMessages<T> {
     loading: string;
     success: string | ((value: T) => string);
-    error: string | ((error: unknown) => string);
+    error: string | ((error: unknown) => ToastMessage);
 }
 /**
  * One toast that follows a promise: a persistent "loading" toast that turns
@@ -50,8 +59,8 @@ export declare function useToast(): {
     toast: (message: string, o?: ToastOptions) => number;
     info: (message: string, o?: ToastOptions) => number;
     success: (message: string, o?: ToastOptions) => number;
-    warning: (message: string, o?: ToastOptions) => number;
-    error: (message: string, o?: ToastOptions) => number;
+    warning: (message: ToastMessage, o?: ToastOptions) => number;
+    error: (message: ToastMessage, o?: ToastOptions) => number;
     promise: typeof promise;
     /** Low-level push for bridges (e.g. @leavepulse/ui-sdk apiError). */
     push: typeof push;

package/dist/composables/useToast.js

@@ -1,11 +1,21 @@
 import { reactive } from "vue";
+function detailsOf(source) {
+  const details = source?.details;
+  return typeof details === "string" && details ? details : void 0;
+}
+function split(message, options) {
+  const text = typeof message === "string" ? message : message.message;
+  const details = options.details ?? (typeof message === "string" ? void 0 : detailsOf(message)) ?? detailsOf(options.cause);
+  return [text, { ...options, details }];
+}
 const DEFAULT_DURATION = 4500;
 const MAX_ACTIVE = 4;
 const STATE_KEY = /* @__PURE__ */ Symbol.for("@leavepulse/ui:toast-queue");
 const g = globalThis;
 const state = g[STATE_KEY] ??= { queue: reactive([]), nextId: 0 };
 const queue = state.queue;
-function push(variant, message, options = {}) {
+function push(variant, input, given = {}) {
+  const [message, options] = split(input, given);
   if (typeof window === "undefined") return -1;
   const duration = options.duration ?? DEFAULT_DURATION;
   const fields = {
@@ -16,7 +26,8 @@ function push(variant, message, options = {}) {
     duration,
     dismissAt: duration > 0 ? Date.now() + duration : null,
     actions: options.actions,
-    onClick: options.onClick
+    onClick: options.onClick,
+    details: options.details
   };
   const same = options.key === void 0 ? -1 : queue.findIndex((t) => t.key === options.key);
   const existing = queue[same];

package/dist/icons-all.js

@@ -1,3 +1,3 @@
 import lucide from "@iconify-json/lucide/icons.json";
-import { a as registerIconCollection } from "./chunks/icons-QqBscG5I.js";
+import { a as registerIconCollection } from "./chunks/icons-CuO3W46H.js";
 registerIconCollection(lucide);

package/dist/index.d.ts

@@ -8,7 +8,7 @@ export type { ActionBarAction } from "./components/LpActionBar.vue";
 export { default as LpAlert } from "./components/LpAlert.vue";
 export { default as LpAppShell } from "./components/LpAppShell.vue";
 export { default as LpAutocomplete } from "./components/LpAutocomplete.vue";
-export type { AutocompleteOption } from "./components/LpAutocomplete.vue";
+export type { AutocompleteOption, AutocompleteSelection } from "./components/LpAutocomplete.vue";
 export { default as LpAvatar } from "./components/LpAvatar.vue";
 export { default as LpBadge } from "./components/LpBadge.vue";
 export { default as LpBreadcrumbs } from "./components/LpBreadcrumbs.vue";
@@ -125,6 +125,7 @@ export type { SelectOption, SelectValue } from "./components/LpSelect.vue";
 export { default as LpServiceNode } from "./components/LpServiceNode.vue";
 export type { ServiceNodeData } from "./components/LpServiceNode.vue";
 export { default as LpShift } from "./components/LpShift.vue";
+export { default as LpSwap } from "./components/LpSwap.vue";
 export { default as LpShortcutsDialog } from "./components/LpShortcutsDialog.vue";
 export { default as LpSidebar } from "./components/LpSidebar.vue";
 export type { SidebarItem, SidebarSection } from "./components/LpSidebar.vue";
@@ -162,8 +163,8 @@ export type { TourContext, TourStep } from "./components/LpTour.vue";
 export { holeOf, openContextMenu, panelsAround } from "./components/tour";
 export { default as LpHintLayer } from "./components/LpHintLayer.vue";
 export { default as LpHints } from "./components/LpHints.vue";
-export { createHintSystem, hintKey, hintSummary, localHintStorage, provideHintSystem, useHintSystem } from "./composables/useHintSystem";
-export type { HintDelta, HintFeature, HintLevel, HintNews, HintNudge, HintOffer, HintPage, HintRecord, HintStorage, HintSummary, HintSystem, HintSystemOptions, HintTiming, } from "./composables/useHintSystem";
+export { HINT_SIGNALS, contextMenuTip, createHintSystem, hintKey, hintSummary, localHintStorage, paletteTip, provideHintSystem, runningHintSystem, useHintSystem } from "./composables/useHintSystem";
+export type { HintDelta, HintFeature, HintLevel, HintNews, HintNudge, HintOffer, HintPage, HintRecord, HintStorage, HintSummary, HintSystem, HintTip, HintSystemOptions, HintTiming, } from "./composables/useHintSystem";
 export type { HintNote } from "./components/LpHintLayer.vue";
 export { default as LpTooltipProvider } from "./components/LpTooltipProvider.vue";
 export { default as LpTopologyCanvas } from "./components/LpTopologyCanvas.vue";
@@ -237,7 +238,7 @@ export type { UseTilt, UseTiltOptions } from "./composables/useTilt";
 export { useZoomPan } from "./composables/useZoomPan";
 export type { UseZoomPan, UseZoomPanOptions } from "./composables/useZoomPan";
 export { useToast } from "./composables/useToast";
-export type { ToastAction, ToastItem, ToastOptions, ToastVariant, } from "./composables/useToast";
+export type { ToastAction, ToastItem, ToastMessage, ToastOptions, ToastVariant, } from "./composables/useToast";
 export type { ToastPromiseMessages } from "./composables/useToast";
 export { cacheSystemThemes, normalizeTheme, prefersDarkScheme, themeEntries, } from "./theme/useTheme";
 export type { SystemThemes, UseTheme } from "./theme/useTheme";

package/dist/index.js

@@ -1,24 +1,24 @@
-import { _ } from "./chunks/LayoutCanvas-BcGLJVBq.js";
-import { _ as _2 } from "./chunks/LpAddressInput-D-H94m4q.js";
-import { _ as _3 } from "./chunks/LpMapPicker-BH5csaBt.js";
+import { _ } from "./chunks/LayoutCanvas-t7LWFCEn.js";
+import { _ as _2 } from "./chunks/LpAddressInput-CzdZguBo.js";
+import { _ as _3 } from "./chunks/LpMapPicker-DybIlWnF.js";
 import { OSM_TILES, createNominatimProvider, emptyAddress, formatAddress, project, tileUrl, unproject } from "./components/address.js";
-import { _ as _4 } from "./chunks/LpActionBar-DCN-_pZP.js";
-import { _ as _5 } from "./chunks/LpAlert-CXMn1GYE.js";
-import { _ as _6 } from "./chunks/LpAppShell-BeMuKEjh.js";
-import { _ as _7 } from "./chunks/LpAutocomplete-hJ_6CHlh.js";
-import { _ as _8 } from "./chunks/LpAvatar-CeW4Z5CL.js";
+import { _ as _4 } from "./chunks/LpActionBar-BsSp66S_.js";
+import { _ as _5 } from "./chunks/LpAlert--KLL4NLk.js";
+import { _ as _6 } from "./chunks/LpAppShell-BXMNDEpF.js";
+import { _ as _7 } from "./chunks/LpAutocomplete-D9mY5Tqk.js";
+import { _ as _8 } from "./chunks/LpAvatar-K6MOMfgn.js";
 import { _ as _9 } from "./chunks/LpBadge-Fe0D1bYx.js";
-import { _ as _10 } from "./chunks/LpBreadcrumbs-BLzOEgAF.js";
-import { _ as _11 } from "./chunks/LpButton-vhlwmpBy.js";
-import { _ as _12 } from "./chunks/LpCalendar-BLoE8Qm7.js";
-import { _ as _13 } from "./chunks/LpCard-Gbr8a1xK.js";
+import { _ as _10 } from "./chunks/LpBreadcrumbs-CndzPYiG.js";
+import { _ as _11 } from "./chunks/LpButton-CJSD7N0Z.js";
+import { _ as _12 } from "./chunks/LpCalendar-CXVDbb2M.js";
+import { _ as _13 } from "./chunks/LpCard-D9HVgX8Y.js";
 import { default as default2 } from "./components/LpChart.vue.js";
 import { backgroundOf, csvField, downloadFile, fileStem, inlineSvg, resolveCssColor, svgToPng, toCsv } from "./components/exportData.js";
 import { CHART_PALETTE, axisTicks, chartSummary, formatTick, markerIndex, niceScale, resolveSlices } from "./components/chart.js";
-import { _ as _14 } from "./chunks/LpCheckbox-B_C8sOoT.js";
-import { _ as _15 } from "./chunks/LpCodeBlock-D6zhp30a.js";
+import { _ as _14 } from "./chunks/LpCheckbox-DV9W6T3H.js";
+import { _ as _15 } from "./chunks/LpCodeBlock-t6MLA3fb.js";
 import { tokenizeLines } from "./components/codeHighlight.js";
-import { _ as _16 } from "./chunks/LpColorPicker-CVXwjEtX.js";
+import { _ as _16 } from "./chunks/LpColorPicker-BO1ZTY51.js";
 import { DEFAULT_SWATCHES, clampHsv, formatColor, hsvToHsl, hsvToRgb, isLight, normalizeHue, opaqueCss, parseColor, parseHex, rgbToHex, rgbToHsv } from "./components/color.js";
 import { default as default3 } from "./components/LpCommandPalette.vue.js";
 import { applyQueryFilters, highlightParts, parseCommandQuery, parsePaletteQuery, rankCommandItems } from "./components/commandSearch.js";
@@ -30,46 +30,46 @@ import { default as default6 } from "./components/LpPaletteStats.vue.js";
 import { default as default7 } from "./components/LpPaletteSwatches.vue.js";
 import { default as default8 } from "./components/LpKeys.vue.js";
 import { comboKeys, comboSteps } from "./components/keys.js";
-import { _ as _18 } from "./chunks/LpConfirmDialog-DkgIT-Xg.js";
-import { _ as _19 } from "./chunks/LpConfirmHost-CYzXWFOI.js";
+import { _ as _18 } from "./chunks/LpConfirmDialog-tkgyY3eu.js";
+import { _ as _19 } from "./chunks/LpConfirmHost-CoYIcUdl.js";
 import { confirm, useConfirm } from "./components/confirm.js";
-import { _ as _20 } from "./chunks/LpContextMenu-DRFd-iyc.js";
-import { _ as _21 } from "./chunks/LpDatePicker-B-VMHMgy.js";
-import { _ as _22 } from "./chunks/LpDateRangePicker-B68KPKPl.js";
-import { _ as _23 } from "./chunks/LpRangeCalendar-D5sDID9W.js";
+import { _ as _20 } from "./chunks/LpContextMenu-Cv_F2iCG.js";
+import { _ as _21 } from "./chunks/LpDatePicker-DxdrVNCG.js";
+import { _ as _22 } from "./chunks/LpDateRangePicker-DjeaqikC.js";
+import { _ as _23 } from "./chunks/LpRangeCalendar-COeOYF52.js";
 import { clampRange, defaultRangePresets, formatRange, normalizeRange, sameRange } from "./components/dateRange.js";
-import { _ as _24 } from "./chunks/LpDisclosure-Ct-VBHxt.js";
+import { _ as _24 } from "./chunks/LpDisclosure-s8cQ7KQq.js";
 import { _ as _25 } from "./chunks/LpDivider-CUX46KR0.js";
-import { _ as _26 } from "./chunks/LpDrawer-Rc6eAJrr.js";
-import { _ as _27 } from "./chunks/LpDropdownMenu-BoJQsjzt.js";
+import { _ as _26 } from "./chunks/LpDrawer-C97yoWmh.js";
+import { _ as _27 } from "./chunks/LpDropdownMenu-CbyYu4Rw.js";
 import { default as default9 } from "./components/LpDropzone.vue.js";
-import { _ as _28 } from "./chunks/LpEmptyState-CBwwkkdA.js";
-import { _ as _29 } from "./chunks/LpFileTree-Bs57DhVa.js";
+import { _ as _28 } from "./chunks/LpEmptyState-CX8fdGSU.js";
+import { _ as _29 } from "./chunks/LpFileTree-DTwUj0L-.js";
 import { ancestorIds, checkStateOf, checkedCount, computeStats, fileIcon, formatModified, formatSize, sortNodes, subtreeIds, subtreeSize } from "./components/fileTree.js";
-import { _ as _30 } from "./chunks/LpFieldNotice-9hH4ITZa.js";
-import { _ as _31 } from "./chunks/LpFormField-BpQ6WJPe.js";
-import { _ as _32 } from "./chunks/LpIcon-B5guGKrW.js";
-import { i, b, a, c } from "./chunks/icons-QqBscG5I.js";
+import { _ as _30 } from "./chunks/LpFieldNotice-B--RzKfj.js";
+import { _ as _31 } from "./chunks/LpFormField-DMPPL1jF.js";
+import { _ as _32 } from "./chunks/LpIcon-CTuDVTYv.js";
+import { i, b, a, c } from "./chunks/icons-CuO3W46H.js";
 import { default as default10 } from "./components/LpImageEditor.vue.js";
 import { _ as _33 } from "./chunks/LpInfraNode-Ds_8SZgN.js";
-import { _ as _34 } from "./chunks/LpInput-WvyP02ID.js";
-import { _ as _35 } from "./chunks/LpLightbox-Dq-e36uT.js";
+import { _ as _34 } from "./chunks/LpInput-C7FHxzj2.js";
+import { _ as _35 } from "./chunks/LpLightbox-DiksFa4L.js";
 import { fileNameOf } from "./components/lightbox.js";
 import { _ as _36 } from "./chunks/LpLink-Krkjhe_y.js";
-import { _ as _37 } from "./chunks/LpLogViewer-B92bAftG.js";
+import { _ as _37 } from "./chunks/LpLogViewer-D9UgNz2m.js";
 import { countLevels, matchPositions, matchesTerm, ringWindow, stepMatch } from "./components/logSearch.js";
-import { _ as _38 } from "./chunks/LpMediaGallery-B1kDypJ-.js";
-import { _ as _39 } from "./chunks/LpModal-DvGD6kEe.js";
-import { _ as _40 } from "./chunks/LpModalNav-B-_zRTS-.js";
-import { _ as _41 } from "./chunks/LpNotificationBell-63pvatBj.js";
-import { _ as _42 } from "./chunks/LpNumberField-CJPjmoDz.js";
-import { _ as _43 } from "./chunks/LpTimeField-DvGXgdES.js";
+import { _ as _38 } from "./chunks/LpMediaGallery-Cic9UHsa.js";
+import { _ as _39 } from "./chunks/LpModal-QFfctZsj.js";
+import { _ as _40 } from "./chunks/LpModalNav-D4rmflQn.js";
+import { _ as _41 } from "./chunks/LpNotificationBell-CyylOlZR.js";
+import { _ as _42 } from "./chunks/LpNumberField-BFSRVGkJ.js";
+import { _ as _43 } from "./chunks/LpTimeField-BTEt0kvL.js";
 import { _ as _44 } from "./chunks/LpNumberFlow-z4WPZcZu.js";
 import { _ as _45 } from "./chunks/LpOtpInput-PbeNJ5In.js";
-import { _ as _46 } from "./chunks/LpPagination-DehAaJLY.js";
-import { _ as _47 } from "./chunks/LpPasswordInput-BK25_vNG.js";
-import { _ as _48 } from "./chunks/LpPie-Coa2GMHt.js";
-import { _ as _49 } from "./chunks/LpPhoneInput-Bxg7a_qD.js";
+import { _ as _46 } from "./chunks/LpPagination-BFl0I7tL.js";
+import { _ as _47 } from "./chunks/LpPasswordInput-C1G4k_r0.js";
+import { _ as _48 } from "./chunks/LpPie-B2deu8CI.js";
+import { _ as _49 } from "./chunks/LpPhoneInput-CZrpVxla.js";
 import { filterCountries, flagEmoji, loadCountries, matchCountryByValue } from "./components/countries.js";
 import { _ as _50 } from "./chunks/LpPopover-DCKeqiVn.js";
 import { _ as _51 } from "./chunks/LpProgress-CBU1iI69.js";
@@ -77,41 +77,42 @@ import { _ as _52 } from "./chunks/LpRadio-CWA5Eb3M.js";
 import { _ as _53 } from "./chunks/LpRadioGroup-CCn-Q2_c.js";
 import { _ as _54 } from "./chunks/LpRollingText-DB7upf-5.js";
 import { _ as _55 } from "./chunks/LpScrollArea-Hz3-JWUG.js";
-import { _ as _56 } from "./chunks/LpSegmented-DbrUjuSA.js";
-import { _ as _57 } from "./chunks/LpSection-B19VPYmr.js";
-import { _ as _58 } from "./chunks/LpSelect-DynjWK1A.js";
+import { _ as _56 } from "./chunks/LpSegmented-DslFku0N.js";
+import { _ as _57 } from "./chunks/LpSection-BAkbf0OK.js";
+import { _ as _58 } from "./chunks/LpSelect-C4OXN_q3.js";
 import { _ as _59 } from "./chunks/LpServiceNode-D8uJ8sGk.js";
 import { _ as _60 } from "./chunks/LpShift-DXNsauQZ.js";
+import { _ as _61 } from "./chunks/LpSwap-D82jiecV.js";
 import { default as default11 } from "./components/LpShortcutsDialog.vue.js";
-import { _ as _61 } from "./chunks/LpSidebar-CKamWtPo.js";
-import { _ as _62 } from "./chunks/LpSkeleton-BB6XIV-w.js";
-import { _ as _63 } from "./chunks/LpSlider-Cuzmrd7p.js";
-import { _ as _64 } from "./chunks/LpRangeSlider-C1yF9-nP.js";
-import { _ as _65 } from "./chunks/LpVideoBackdrop-qWRYBOTQ.js";
+import { _ as _62 } from "./chunks/LpSidebar-D8tub3bt.js";
+import { _ as _63 } from "./chunks/LpSkeleton-BB6XIV-w.js";
+import { _ as _64 } from "./chunks/LpSlider-Cuzmrd7p.js";
+import { _ as _65 } from "./chunks/LpRangeSlider-C1yF9-nP.js";
+import { _ as _66 } from "./chunks/LpVideoBackdrop-qWRYBOTQ.js";
 import { formatClipTime, isNativeLoop, planLoop, seamProgress, seamReached } from "./components/videoBackdrop.js";
-import { _ as _66 } from "./chunks/LpSparkline-CB80N8SJ.js";
-import { _ as _67 } from "./chunks/LpStat-BS2TEXYK.js";
-import { _ as _68 } from "./chunks/LpStepper-BSglWF45.js";
-import { _ as _69 } from "./chunks/LpSwitch-DG2AhXIL.js";
+import { _ as _67 } from "./chunks/LpSparkline-CB80N8SJ.js";
+import { _ as _68 } from "./chunks/LpStat-oYk6V1LZ.js";
+import { _ as _69 } from "./chunks/LpStepper-YgHGzgfD.js";
+import { _ as _70 } from "./chunks/LpSwitch-DG2AhXIL.js";
 import { default as default12 } from "./components/LpTable.vue.js";
 import { compareValues } from "./components/tableSort.js";
-import { _ as _70 } from "./chunks/LpTableOfContents-DYuqkByy.js";
-import { _ as _71 } from "./chunks/LpTabs-D01b8jBI.js";
-import { _ as _72 } from "./chunks/LpTagsInput-CHbQoAAA.js";
+import { _ as _71 } from "./chunks/LpTableOfContents-DYuqkByy.js";
+import { _ as _72 } from "./chunks/LpTabs-00v3VQx4.js";
+import { _ as _73 } from "./chunks/LpTagsInput-Sc56iy_j.js";
 import { addTags, splitTags } from "./components/tags.js";
-import { _ as _73 } from "./chunks/LpTextarea-Bz2IWhTH.js";
-import { _ as _74 } from "./chunks/LpThemeSwitcher-CbzL6ipO.js";
-import { _ as _75 } from "./chunks/LpTilt-B7KHX1zH.js";
-import { _ as _76 } from "./chunks/LpToaster-C9EacEfR.js";
-import { _ as _77 } from "./chunks/LpTooltip-suFCM34F.js";
-import { _ as _78 } from "./chunks/LpTour-D7m9ZxNk.js";
+import { _ as _74 } from "./chunks/LpTextarea-CQZccQI3.js";
+import { _ as _75 } from "./chunks/LpThemeSwitcher-ZFFftBQn.js";
+import { _ as _76 } from "./chunks/LpTilt-B7KHX1zH.js";
+import { _ as _77 } from "./chunks/LpToaster-D3OisETH.js";
+import { _ as _78 } from "./chunks/LpTooltip-suFCM34F.js";
+import { _ as _79 } from "./chunks/LpTour-C29-1wha.js";
 import { holeOf, openContextMenu, panelsAround } from "./components/tour.js";
-import { _ as _79 } from "./chunks/LpHintLayer-B5-6FyEf.js";
-import { _ as _80 } from "./chunks/LpHints-BqoZXHZk.js";
-import { createHintSystem, hintKey, hintSummary, localHintStorage, provideHintSystem, useHintSystem } from "./composables/useHintSystem.js";
-import { _ as _81 } from "./chunks/LpTooltipProvider-CftjV7Xc.js";
-import { _ as _82 } from "./chunks/LpTopologyCanvas-6ozNrQKh.js";
-import { _ as _83 } from "./chunks/LpUptimeBar-B4ltCfno.js";
+import { _ as _80 } from "./chunks/LpHintLayer-DsclGYcD.js";
+import { _ as _81 } from "./chunks/LpHints-BTpvisgP.js";
+import { HINT_SIGNALS, contextMenuTip, createHintSystem, hintKey, hintSummary, localHintStorage, paletteTip, provideHintSystem, runningHintSystem, useHintSystem } from "./composables/useHintSystem.js";
+import { _ as _82 } from "./chunks/LpTooltipProvider-CftjV7Xc.js";
+import { _ as _83 } from "./chunks/LpTopologyCanvas-6ozNrQKh.js";
+import { _ as _84 } from "./chunks/LpUptimeBar-B4ltCfno.js";
 import { deserializeLayout, serializeLayout } from "./layout/tree.js";
 import { addLeaf, addTab, countBlocks, countLeaves, makeLayout, moveLeaf, removeBlock, removeLeaf, reorderTab, resizeAt, setActiveTab } from "./layout/tree.js";
 import { blockTitle, defineBlocks } from "./layout/registry.js";
@@ -145,7 +146,7 @@ import { useShift } from "./composables/useShift.js";
 import { useTilt } from "./composables/useTilt.js";
 import { useZoomPan } from "./composables/useZoomPan.js";
 import { useToast } from "./composables/useToast.js";
-import { _ as _84 } from "./chunks/LpThemeProvider-CQ2jC9TA.js";
+import { _ as _85 } from "./chunks/LpThemeProvider-CQ2jC9TA.js";
 import { isInternalHref, resolveLink } from "./components/link.js";
 function defineTheme(base, overrides = {}) {
   const src = typeof base === "string" ? presets[base] : base;
@@ -184,6 +185,7 @@ export {
   DEFAULT_SWATCHES,
   FIELD_NOTICE_MS,
   G as GLASS_BACKDROP_ATTR,
+  HINT_SIGNALS,
   LP_CONFIG,
   LP_FIELD,
   _ as LayoutCanvas,
@@ -217,8 +219,8 @@ export {
   _30 as LpFieldNotice,
   _29 as LpFileTree,
   _31 as LpFormField,
-  _79 as LpHintLayer,
-  _80 as LpHints,
+  _80 as LpHintLayer,
+  _81 as LpHints,
   _32 as LpIcon,
   default10 as LpImageEditor,
   _33 as LpInfraNode,
@@ -249,7 +251,7 @@ export {
   _52 as LpRadio,
   _53 as LpRadioGroup,
   _23 as LpRangeCalendar,
-  _64 as LpRangeSlider,
+  _65 as LpRangeSlider,
   _54 as LpRollingText,
   _55 as LpScrollArea,
   _57 as LpSection,
@@ -258,29 +260,30 @@ export {
   _59 as LpServiceNode,
   _60 as LpShift,
   default11 as LpShortcutsDialog,
-  _61 as LpSidebar,
-  _62 as LpSkeleton,
-  _63 as LpSlider,
-  _66 as LpSparkline,
-  _67 as LpStat,
-  _68 as LpStepper,
-  _69 as LpSwitch,
+  _62 as LpSidebar,
+  _63 as LpSkeleton,
+  _64 as LpSlider,
+  _67 as LpSparkline,
+  _68 as LpStat,
+  _69 as LpStepper,
+  _61 as LpSwap,
+  _70 as LpSwitch,
   default12 as LpTable,
-  _70 as LpTableOfContents,
-  _71 as LpTabs,
-  _72 as LpTagsInput,
-  _73 as LpTextarea,
-  _84 as LpThemeProvider,
-  _74 as LpThemeSwitcher,
-  _75 as LpTilt,
+  _71 as LpTableOfContents,
+  _72 as LpTabs,
+  _73 as LpTagsInput,
+  _74 as LpTextarea,
+  _85 as LpThemeProvider,
+  _75 as LpThemeSwitcher,
+  _76 as LpTilt,
   _43 as LpTimeField,
-  _76 as LpToaster,
-  _77 as LpTooltip,
-  _81 as LpTooltipProvider,
-  _82 as LpTopologyCanvas,
-  _78 as LpTour,
-  _83 as LpUptimeBar,
-  _65 as LpVideoBackdrop,
+  _77 as LpToaster,
+  _78 as LpTooltip,
+  _82 as LpTooltipProvider,
+  _83 as LpTopologyCanvas,
+  _79 as LpTour,
+  _84 as LpUptimeBar,
+  _66 as LpVideoBackdrop,
   N as NO_BACKDROP_ATTR,
   OSM_TILES,
   T as THEME_COOKIE,
@@ -314,6 +317,7 @@ export {
   compareValues,
   computeStats,
   confirm,
+  contextMenuTip,
   countBlocks,
   countLeaves,
   countLevels,
@@ -388,6 +392,7 @@ export {
   k as normalizeTheme,
   opaqueCss,
   openContextMenu,
+  paletteTip,
   panelsAround,
   parseColor,
   parseCommandQuery,
@@ -424,6 +429,7 @@ export {
   rgbToHsv,
   ringWindow,
   o as rose,
+  runningHintSystem,
   sameRange,
   scrollParent,
   scrollToElement,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leavepulse/ui",
-  "version": "0.59.0",
+  "version": "0.61.0",
   "type": "module",
   "description": "LeavePulse token-driven Vue component kit.",
   "repository": {
@@ -30,6 +30,7 @@
     "./css": "./src/index.css",
     "./tokens.css": "./src/tokens/tokens.css",
     "./scrollbar.css": "./src/tokens/scrollbar.css",
+    "./selection.css": "./src/tokens/selection.css",
     "./canvas.css": "./src/canvas.css",
     "./package.json": "./package.json",
     "./dist/*.js": {

package/src/component-names.ts

@@ -80,6 +80,7 @@ export const COMPONENT_NAMES = [
   "LpSparkline",
   "LpStat",
   "LpStepper",
+  "LpSwap",
   "LpSwitch",
   "LpTable",
   "LpTableOfContents",