@leavepulse/ui 0.46.0 → 0.47.0

package/dist/components/LpPaletteFacts.vue.js

@@ -0,0 +1,85 @@
+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$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 = {
+  key: 0,
+  class: "lp-palette-facts__title"
+};
+const _hoisted_2 = { class: "lp-palette-facts__list" };
+const _hoisted_3 = ["aria-current"];
+const _hoisted_4 = { class: "lp-palette-facts__label" };
+const _hoisted_5 = { class: "lp-palette-facts__name" };
+const _hoisted_6 = {
+  key: 0,
+  class: "lp-palette-facts__hint"
+};
+const _sfc_main = /* @__PURE__ */ defineComponent({
+  __name: "LpPaletteFacts",
+  props: {
+    items: {},
+    title: {},
+    plain: { type: Boolean, default: false }
+  },
+  setup(__props) {
+    return (_ctx, _cache) => {
+      return openBlock(), createElementBlock("section", {
+        class: normalizeClass(["lp-palette-facts", { "lp-palette-facts--plain": __props.plain }])
+      }, [
+        __props.title ? (openBlock(), createElementBlock("p", _hoisted_1, toDisplayString(__props.title), 1)) : createCommentVNode("", true),
+        createElementVNode("ul", _hoisted_2, [
+          (openBlock(true), createElementBlock(Fragment, null, renderList(__props.items, (item, index) => {
+            return openBlock(), createElementBlock("li", {
+              key: index,
+              class: normalizeClass(["lp-palette-facts__row", { "is-current": item.current }]),
+              "aria-current": item.current || void 0
+            }, [
+              item.color ? (openBlock(), createElementBlock("span", {
+                key: 0,
+                class: "lp-palette-facts__dot",
+                style: normalizeStyle({ background: item.color })
+              }, null, 4)) : item.icon ? (openBlock(), createBlock(_sfc_main$1, {
+                key: 1,
+                name: item.icon,
+                size: 15,
+                class: "lp-palette-facts__icon"
+              }, null, 8, ["name"])) : createCommentVNode("", true),
+              createElementVNode("span", _hoisted_4, [
+                createElementVNode("span", _hoisted_5, [
+                  createVNode(_sfc_main$2, {
+                    text: item.label
+                  }, null, 8, ["text"])
+                ]),
+                item.hint?.length ? (openBlock(), createElementBlock("span", _hoisted_6, [
+                  createVNode(_sfc_main$2, {
+                    text: item.hint
+                  }, null, 8, ["text"])
+                ])) : createCommentVNode("", true)
+              ]),
+              item.value !== void 0 && item.value !== "" || _ctx.$slots.value ? (openBlock(), createElementBlock("span", {
+                key: 2,
+                class: normalizeClass(["lp-palette-facts__value", { "lp-palette-facts__value--mono": item.mono }])
+              }, [
+                renderSlot(_ctx.$slots, "value", {
+                  item,
+                  index
+                }, () => [
+                  item.value !== void 0 ? (openBlock(), createBlock(_sfc_main$3, {
+                    key: 0,
+                    value: item.value,
+                    align: "end"
+                  }, null, 8, ["value"])) : createCommentVNode("", true)
+                ], true)
+              ], 2)) : createCommentVNode("", true)
+            ], 10, _hoisted_3);
+          }), 128))
+        ])
+      ], 2);
+    };
+  }
+});
+const LpPaletteFacts = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-f1ab3788"]]);
+export {
+  LpPaletteFacts as default
+};

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

@@ -0,0 +1,32 @@
+import type { HighlightPart } from "./commandSearch";
+import type { CommandImage } from "./LpCommandPalette.vue";
+type __VLS_Props = {
+    eyebrow?: string;
+    /** Text, or the preview slot's `highlight(text)` to mark the query. */
+    title?: string | HighlightPart[];
+    subtitle?: string | HighlightPart[];
+    lead?: string | HighlightPart[];
+    /** Icon beside the title, on a soft tile. */
+    icon?: string;
+    /** Picture beside the title; wins over `icon`, which becomes its fallback. */
+    image?: string | CommandImage | null;
+};
+declare var __VLS_1: {}, __VLS_13: {}, __VLS_25: {}, __VLS_27: {};
+type __VLS_Slots = {} & {
+    media?: (props: typeof __VLS_1) => any;
+} & {
+    title?: (props: typeof __VLS_13) => any;
+} & {
+    default?: (props: typeof __VLS_25) => any;
+} & {
+    lead?: (props: typeof __VLS_27) => any;
+};
+declare const __VLS_base: 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 __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/LpPaletteHeader.vue.js

@@ -0,0 +1,103 @@
+import { defineComponent, computed, openBlock, createElementBlock, createElementVNode, renderSlot, createBlock, createVNode, createCommentVNode, toDisplayString } from "vue";
+import { _ as _sfc_main$1 } from "../chunks/LpAvatar-Cb1jtOVv.js";
+import { _ as _sfc_main$2 } from "../chunks/LpIcon-DYtaid0K.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" };
+const _hoisted_2 = { class: "lp-palette-header__row" };
+const _hoisted_3 = {
+  key: 1,
+  class: "lp-palette-header__tile"
+};
+const _hoisted_4 = { class: "lp-palette-header__text" };
+const _hoisted_5 = {
+  key: 0,
+  class: "lp-palette-header__eyebrow"
+};
+const _hoisted_6 = {
+  key: 1,
+  class: "lp-palette-header__title"
+};
+const _hoisted_7 = {
+  key: 2,
+  class: "lp-palette-header__subtitle"
+};
+const _hoisted_8 = {
+  key: 0,
+  class: "lp-palette-header__extra"
+};
+const _hoisted_9 = {
+  key: 1,
+  class: "lp-palette-header__lead"
+};
+const _sfc_main = /* @__PURE__ */ defineComponent({
+  __name: "LpPaletteHeader",
+  props: {
+    eyebrow: {},
+    title: {},
+    subtitle: {},
+    lead: {},
+    icon: {},
+    image: {}
+  },
+  setup(__props) {
+    const props = __props;
+    const picture = computed(() => {
+      if (!props.image) return null;
+      const image = typeof props.image === "string" ? { src: props.image } : props.image;
+      return { ...image, icon: image.icon ?? props.icon };
+    });
+    return (_ctx, _cache) => {
+      return openBlock(), createElementBlock("header", _hoisted_1, [
+        createElementVNode("div", _hoisted_2, [
+          renderSlot(_ctx.$slots, "media", {}, () => [
+            picture.value ? (openBlock(), createBlock(_sfc_main$1, {
+              key: 0,
+              src: picture.value.src ?? void 0,
+              alt: picture.value.alt ?? "",
+              fallback: picture.value.fallback,
+              icon: picture.value.icon,
+              shape: picture.value.shape ?? "soft",
+              "pixel-size": 44,
+              class: "lp-palette-header__media"
+            }, null, 8, ["src", "alt", "fallback", "icon", "shape"])) : __props.icon ? (openBlock(), createElementBlock("span", _hoisted_3, [
+              createVNode(_sfc_main$2, {
+                name: __props.icon,
+                size: 18
+              }, null, 8, ["name"])
+            ])) : createCommentVNode("", true)
+          ], true),
+          createElementVNode("div", _hoisted_4, [
+            __props.eyebrow ? (openBlock(), createElementBlock("p", _hoisted_5, toDisplayString(__props.eyebrow), 1)) : createCommentVNode("", true),
+            __props.title?.length || _ctx.$slots.title ? (openBlock(), createElementBlock("h3", _hoisted_6, [
+              renderSlot(_ctx.$slots, "title", {}, () => [
+                __props.title ? (openBlock(), createBlock(_sfc_main$3, {
+                  key: 0,
+                  text: __props.title
+                }, null, 8, ["text"])) : createCommentVNode("", true)
+              ], true)
+            ])) : createCommentVNode("", true),
+            __props.subtitle?.length ? (openBlock(), createElementBlock("p", _hoisted_7, [
+              createVNode(_sfc_main$3, { text: __props.subtitle }, null, 8, ["text"])
+            ])) : createCommentVNode("", true)
+          ])
+        ]),
+        _ctx.$slots.default ? (openBlock(), createElementBlock("div", _hoisted_8, [
+          renderSlot(_ctx.$slots, "default", {}, void 0, true)
+        ])) : createCommentVNode("", true),
+        __props.lead?.length || _ctx.$slots.lead ? (openBlock(), createElementBlock("p", _hoisted_9, [
+          renderSlot(_ctx.$slots, "lead", {}, () => [
+            __props.lead ? (openBlock(), createBlock(_sfc_main$3, {
+              key: 0,
+              text: __props.lead
+            }, null, 8, ["text"])) : createCommentVNode("", true)
+          ], true)
+        ])) : createCommentVNode("", true)
+      ]);
+    };
+  }
+});
+const LpPaletteHeader = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-68065cf8"]]);
+export {
+  LpPaletteHeader as default
+};

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

@@ -0,0 +1,19 @@
+type __VLS_Props = {
+    /** Space between blocks. */
+    gap?: "sm" | "md" | "lg";
+};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    gap: "sm" | "md" | "lg";
+}, {}, {}, {}, 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/LpPalettePreview.vue.js

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

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

@@ -0,0 +1,11 @@
+import type { PaletteStat } from "./commandPalette";
+type __VLS_Props = {
+    items: PaletteStat[];
+    /** Tiles per row. */
+    columns?: 2 | 3 | 4;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    columns: 2 | 3 | 4;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/LpPaletteStats.vue.js

@@ -0,0 +1,47 @@
+import { defineComponent, openBlock, createElementBlock, normalizeStyle, Fragment, renderList, createElementVNode, toDisplayString, createBlock } from "vue";
+import { _ as _sfc_main$1 } from "../chunks/LpNumberFlow-z4WPZcZu.js";
+import { _ as _sfc_main$2 } from "../chunks/LpRollingText-DB7upf-5.js";
+import { _ as _export_sfc } from "../chunks/_plugin-vue_export-helper-1tPrXgE0.js";
+import '../assets/LpPaletteStats-ClE-37MK.css';const _sfc_main = /* @__PURE__ */ defineComponent({
+  __name: "LpPaletteStats",
+  props: {
+    items: {},
+    columns: { default: 2 }
+  },
+  setup(__props) {
+    return (_ctx, _cache) => {
+      return openBlock(), createElementBlock("dl", {
+        class: "lp-palette-stats",
+        style: normalizeStyle({ gridTemplateColumns: `repeat(${__props.columns}, minmax(0, 1fr))` })
+      }, [
+        (openBlock(true), createElementBlock(Fragment, null, renderList(__props.items, (item, index) => {
+          return openBlock(), createElementBlock("div", {
+            key: `${item.label}-${index}`,
+            class: "lp-palette-stats__tile"
+          }, [
+            createElementVNode("dt", null, toDisplayString(item.label), 1),
+            createElementVNode("dd", null, [
+              typeof item.value === "number" ? (openBlock(), createBlock(_sfc_main$1, {
+                key: 0,
+                value: item.value,
+                compact: item.compact,
+                suffix: item.suffix,
+                format: item.format,
+                "animate-on-mount": false,
+                grouped: ""
+              }, null, 8, ["value", "compact", "suffix", "format"])) : (openBlock(), createBlock(_sfc_main$2, {
+                key: 1,
+                value: item.value,
+                align: "start"
+              }, null, 8, ["value"]))
+            ])
+          ]);
+        }), 128))
+      ], 4);
+    };
+  }
+});
+const LpPaletteStats = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-dc30a10e"]]);
+export {
+  LpPaletteStats as default
+};

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

@@ -0,0 +1,10 @@
+type __VLS_Props = {
+    colors: string[];
+    /** The surface the swatches sit on, usually the theme's own. */
+    background?: string;
+    /** Accessible name of the strip, e.g. the theme's name. */
+    label?: 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/LpPaletteSwatches.vue.js

@@ -0,0 +1,34 @@
+import { defineComponent, openBlock, createElementBlock, normalizeStyle, Fragment, renderList } from "vue";
+import { _ as _export_sfc } from "../chunks/_plugin-vue_export-helper-1tPrXgE0.js";
+import '../assets/LpPaletteSwatches-CA0B8y2E.css';const _hoisted_1 = ["aria-label"];
+const _hoisted_2 = ["title"];
+const _sfc_main = /* @__PURE__ */ defineComponent({
+  __name: "LpPaletteSwatches",
+  props: {
+    colors: {},
+    background: {},
+    label: {}
+  },
+  setup(__props) {
+    return (_ctx, _cache) => {
+      return openBlock(), createElementBlock("div", {
+        class: "lp-palette-swatches",
+        role: "img",
+        "aria-label": __props.label,
+        style: normalizeStyle({ background: __props.background, gridTemplateColumns: `repeat(${Math.max(__props.colors.length, 1)}, minmax(0, 1fr))` })
+      }, [
+        (openBlock(true), createElementBlock(Fragment, null, renderList(__props.colors, (color, index) => {
+          return openBlock(), createElementBlock("span", {
+            key: index,
+            title: color,
+            style: normalizeStyle({ background: color })
+          }, null, 12, _hoisted_2);
+        }), 128))
+      ], 12, _hoisted_1);
+    };
+  }
+});
+const LpPaletteSwatches = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-7c6934b1"]]);
+export {
+  LpPaletteSwatches as default
+};

package/dist/components/LpShortcutsDialog.vue.js

@@ -1,14 +1,11 @@
-import { defineComponent, computed, openBlock, createBlock, unref, withCtx, createElementVNode, createElementBlock, Fragment, renderList, toDisplayString, createTextVNode, createCommentVNode } from "vue";
+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 { useAppleKeyboard, mergeShortcutGroups, activeShortcuts, useHotkeys, appleModifierLabel } from "../composables/useHotkeys.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";
-import '../assets/LpShortcutsDialog-CqYX3yy6.css';const _hoisted_1 = { class: "shortcut-groups" };
+import '../assets/LpShortcutsDialog-BUp_BX4s.css';const _hoisted_1 = { class: "shortcut-groups" };
 const _hoisted_2 = ["aria-label", "title"];
-const _hoisted_3 = {
-  key: 0,
-  class: "shortcut-then"
-};
 const _sfc_main = /* @__PURE__ */ defineComponent({
   __name: "LpShortcutsDialog",
   props: {
@@ -25,17 +22,9 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
     const props = __props;
     const text = useLabels("shortcuts", {
       title: "Keyboard shortcuts",
-      then: "then",
       conflict: "Also bound elsewhere: only one of them runs",
       group: "General"
     });
-    const apple = useAppleKeyboard();
-    function keysOf(chord) {
-      return chord.split(/\+(?!$)/);
-    }
-    function stepsOf(combo) {
-      return combo.trim().split(/\s+/);
-    }
     const shown = computed(() => props.live ? mergeShortcutGroups(props.groups, activeShortcuts.value) : props.groups);
     const emit = __emit;
     useHotkeys(
@@ -84,18 +73,9 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
                         }, "!", 8, _hoisted_2)) : createCommentVNode("", true)
                       ]),
                       createElementVNode("dd", null, [
-                        (openBlock(true), createElementBlock(Fragment, null, renderList(stepsOf(entry.combo), (step, stepIndex) => {
-                          return openBlock(), createElementBlock(Fragment, {
-                            key: `${step}-${stepIndex}`
-                          }, [
-                            stepIndex ? (openBlock(), createElementBlock("span", _hoisted_3, toDisplayString(unref(text).then), 1)) : createCommentVNode("", true),
-                            (openBlock(true), createElementBlock(Fragment, null, renderList(keysOf(step), (key, index) => {
-                              return openBlock(), createElementBlock("kbd", {
-                                key: `${key}-${index}`
-                              }, toDisplayString(unref(appleModifierLabel)(key.trim(), unref(apple))), 1);
-                            }), 128))
-                          ], 64);
-                        }), 128))
+                        createVNode(LpKeys, {
+                          combo: entry.combo
+                        }, null, 8, ["combo"])
                       ])
                     ]);
                   }), 128))
@@ -109,7 +89,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
     };
   }
 });
-const LpShortcutsDialog = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-1c4cf3fa"]]);
+const LpShortcutsDialog = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-611c415f"]]);
 export {
   LpShortcutsDialog as default
 };

package/dist/components/LpTable.vue.js

@@ -18,7 +18,7 @@ import { _ as _sfc_main$1 } from "../chunks/LpButton-CKSwC6Mu.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";
-import '../assets/LpTable-BoeA_TgK.css';const _hoisted_1 = {
+import '../assets/LpTable-xWwI4KPZ.css';const _hoisted_1 = {
   key: 0,
   class: "flex justify-end"
 };
@@ -544,7 +544,9 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
       }
       return t.rowsTotal.replace("{total}", String(props.rows.length));
     });
-    const showBar = computed(() => props.summary || !!props.selectable || activeFilters.value.length > 0);
+    const showBar = computed(
+      () => props.summary || !!props.selectable && props.selected.length > 0 || activeFilters.value.length > 0
+    );
     const filteredOut = computed(() => {
       if (loading.value || failed.value || displayRows.value.length) return false;
       if (props.load) return Object.values(hiddenValues.value).some((set) => set.size);
@@ -924,7 +926,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
     };
   }
 });
-const LpTable = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-7fc0998d"]]);
+const LpTable = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-4fa70e89"]]);
 export {
   LpTable as default
 };

package/dist/components/commandPalette.d.ts

@@ -0,0 +1,157 @@
+import { type CommandSearchTerms, type HighlightPart, type SearchableCommand } from "./commandSearch";
+/** The fields of a command that decide whether the preview pane opens for it. */
+export interface PreviewableCommand {
+    preview?: string;
+    excerpt?: string;
+    noPreview?: boolean;
+}
+/**
+ * Whether the pane has something to show for a row. `noPreview` on the row
+ * wins, then the app's `hasPreview`; without either, a row qualifies when the
+ * app supplied a `#preview` slot or the row carries text of its own.
+ */
+export declare function commandHasPreview<T extends PreviewableCommand>(command: T | undefined, options: {
+    slot: boolean;
+    hasPreview?: (command: T) => boolean;
+}): boolean;
+/** One line of LpPaletteFacts: what it is, and what it is set to now. */
+export interface PaletteFact {
+    /** Text, or the preview slot's `highlight(text)` to mark the query. */
+    label: string | HighlightPart[];
+    /** Right-aligned value; a change rolls in rather than swapping. */
+    value?: string | number;
+    /** A second, quieter line under the label. */
+    hint?: string | HighlightPart[];
+    icon?: string;
+    /** A colour dot in place of the icon: a role colour, a status. */
+    color?: string;
+    /** Marks the row that is in effect now: the current theme, the open tab. */
+    current?: boolean;
+    /** Draw the value in the monospace face: ids, paths, versions. */
+    mono?: boolean;
+}
+/** One tile of LpPaletteStats. */
+export interface PaletteStat {
+    label: string;
+    /** A number counts to its new value; text rolls. */
+    value: number | string;
+    /** Abbreviate a number: 1.2k, 3.4M. */
+    compact?: boolean;
+    suffix?: string;
+    format?: (value: number) => string;
+}
+/** The fields of a command that let typing enter its mode. */
+export interface PrefixedCommand {
+    prefix?: string;
+    children?: unknown;
+    disabled?: boolean;
+}
+/**
+ * The mode a query opens by its prefix, and the query left after it. Only a
+ * command with `children` and a non-empty `prefix` qualifies; letters match
+ * in any case, and the longest prefix wins, so "mr " and "m" can live side by
+ * side. Leading spaces are ignored: they are never what someone meant.
+ */
+export declare function matchModePrefix<T extends PrefixedCommand>(query: string, commands: readonly T[]): {
+    command: T;
+    rest: string;
+} | null;
+/** The fields of a command that make it a "search elsewhere" row. */
+export interface FallbackCommand extends SearchableCommand {
+    fallback?: boolean;
+    hidden?: boolean;
+}
+/**
+ * The fallback rows to show for a query, with their labels filled in. They
+ * appear only while positive words are typed, whatever those words are: the
+ * row offers to search somewhere else for them, so matching it against them
+ * would hide it exactly when it is needed. Exclusions and `in:` scopes still
+ * apply, to the row's own label, keywords and group. `{query}` in the label
+ * becomes the positive words, without the operators.
+ */
+export declare function fallbackRows<T extends FallbackCommand>(items: readonly T[], raw: string): {
+    command: T;
+    label: string;
+}[];
+/**
+ * A remembered pick that is not a root command: one chosen inside a mode, or
+ * a result a search fetched. It keeps what the row needs to be drawn again
+ * and where it was found, so the palette can find the live command next time
+ * (`path` through static children, or the app's `resolveRecent`), and fall
+ * back to its `href` when neither can.
+ */
+export interface RecentEntry {
+    id: string;
+    label: string;
+    description?: string;
+    icon?: string;
+    image?: string | {
+        src?: string | null;
+        alt?: string;
+        fallback?: string;
+        icon?: string;
+        shape?: "circle" | "soft" | "square";
+    };
+    href?: string;
+    /** Ids of the modes it was picked in, outermost first. */
+    path: string[];
+    /** The command's `recentData`, kept as given for `resolveRecent`. */
+    data?: unknown;
+}
+/** A stored history item: a root command id (the old format), or an entry. */
+export type RecentItem = string | RecentEntry;
+/** The fields of a command a history entry is built from and resolved to. */
+export interface RecentSource {
+    id: string;
+    label: string;
+    description?: string;
+    icon?: string;
+    image?: RecentEntry["image"];
+    href?: string;
+    recentData?: unknown;
+    disabled?: boolean;
+    children?: unknown;
+}
+/** Stored history, with anything malformed dropped rather than trusted. */
+export declare function readRecent(stored: unknown): RecentItem[];
+/**
+ * The history item for a pick. A root pick stays a bare id, the format older
+ * versions wrote and still read; anything deeper becomes an entry with only
+ * the fields that survive JSON.
+ */
+export declare function toRecentItem(command: RecentSource, path: readonly string[]): RecentItem;
+/** The history with `item` first and any earlier copy of it dropped. */
+export declare function pushRecent(list: readonly RecentItem[], item: RecentItem, keep: number): RecentItem[];
+/**
+ * The live commands a history stands for, newest first. A bare id is looked
+ * up among the root commands; an entry is followed down its path through
+ * static children, then offered to `resolve` (for results a fetcher found),
+ * and last rebuilt from its own fields when it has an `href` to follow.
+ * Whatever none of these can find is skipped, so a stored history never
+ * resurrects something that cannot run.
+ */
+export declare function resolveRecentItems<T extends RecentSource>(items: readonly RecentItem[], commands: readonly T[], options: {
+    limit: number;
+    resolve?: (entry: RecentEntry) => T | null | undefined;
+    fromEntry: (entry: RecentEntry) => T;
+}): {
+    command: T;
+    path: string[];
+}[];
+/**
+ * Whether a recent row survives the operators typed so far. Recent rows show
+ * while no positive words are typed, so "-theme" or "in:recent" filters them
+ * like any other row; an `in:` scope matches the row's own group or the
+ * Recent heading it sits under.
+ */
+export declare function recentVisible(command: SearchableCommand, terms: CommandSearchTerms, recentLabel: string): boolean;
+/**
+ * The name a mode's chip shows. `modeLabel` when given; otherwise the label,
+ * with a `{query}` placeholder and the quotes around it taken out, since the
+ * words it stood for are in the box now ("Search mods for "{query}"" reads
+ * "Search mods").
+ */
+export declare function modeChipLabel(command: {
+    label: string;
+    modeLabel?: string;
+}): string;