@karibsen/eponyme 0.1.1 → 0.3.0

package/dist/runtime/components/editor/EponymeSidebar.vue

@@ -6,6 +6,8 @@ import EponymeNavigationLink from "./EponymeNavigationLink.vue";
 import EponymeSidebarTree from "./EponymeSidebarTree.vue";
 import { useEponymeConfig } from "../../composables/useEponymeConfig";
 import { getEponymeCollections, getEponymeForms, getEponymeSchemas } from "../../utils/get-eponyme-schemas";
+import { buildEponymeNavigationTree } from "../../utils/build-navigation-tree";
+import { filterEponymeNavigationTree } from "../../utils/filter-navigation-tree";
 import { useEponymeAuth } from "../../composables/useEponymeAuth";
 import EPAvatar from "../ui/EPAvatar.vue";
 import EPButton from "../ui/EPButton.vue";
@@ -55,6 +57,12 @@ onKeyStroke("k", (event) => {
   if (!event.metaKey && !event.ctrlKey) return;
   event.preventDefault();
   searchInput.value?.$el?.focus();
+  searchInput.value?.$el?.select();
+});
+onKeyStroke("Escape", () => {
+  if (!isFiltering.value) return;
+  searchQuery.value = "";
+  searchInput.value?.$el?.blur();
 });
 const navigation = computed(() => {
   const items = [];
@@ -86,38 +94,15 @@ const navigation = computed(() => {
   }
   return items;
 });
-const navigationTree = computed(() => {
-  const root = [];
-  function addPath(pathValue, finalKind, configuredLabel) {
-    const parts = pathValue.split("/");
-    let children = root;
-    for (let index = 0; index < parts.length; index++) {
-      const part = parts[index];
-      const path = parts.slice(0, index + 1).join("/");
-      const kind = index === parts.length - 1 ? finalKind : "folder";
-      let node = children.find((item) => item.path === path);
-      if (!node) {
-        node = { kind, path, label: index === parts.length - 1 && configuredLabel ? configuredLabel : label(part), children: [] };
-        children.push(node);
-      } else if (index === parts.length - 1) {
-        node.kind = finalKind;
-        if (configuredLabel) node.label = configuredLabel;
-      }
-      children = node.children;
-    }
-  }
-  for (const entry of Object.keys(getEponymeSchemas(config))) addPath(entry, "entry");
-  for (const [name, definition] of Object.entries(collections)) {
-    addPath(name, "collection", definition.label);
-    for (const entry of collectionEntries.value[name] ?? []) addPath(`${name}/${entry.slug}`, "entry", entry.title);
-  }
-  for (const [name, definition] of Object.entries(forms)) addPath(name, "form", definition.label);
-  return root;
-});
+const navigationTree = computed(() => buildEponymeNavigationTree({
+  schemas: getEponymeSchemas(config),
+  collections,
+  forms,
+  collectionEntries: collectionEntries.value
+}));
+const isFiltering = computed(() => searchQuery.value.trim().length > 0);
+const filteredTree = computed(() => filterEponymeNavigationTree(navigationTree.value, searchQuery.value));
 const openFolders = useState(`eponyme:open-folders:${normalizedBasePath.value}`, () => navigation.value.filter((item) => item.kind === "folder").map((item) => item.path));
-function label(name) {
-  return name.replace(/[-_]/g, " ").replace(/\b\w/g, (char) => char.toUpperCase());
-}
 function entryPath(name) {
   return `${normalizedBasePath.value}/${name}`;
 }
@@ -204,14 +189,21 @@ watch(() => route.path, () => {
         Editables
       </div>
       <EponymeSidebarTree
-        :nodes="navigationTree"
+        :nodes="filteredTree"
         :base-path="normalizedBasePath"
         :current-path="route.path"
         :statuses="statuses"
         :open-folders="openFolders"
+        :force-open="isFiltering"
         :can-edit="auth.canEdit.value"
         @update:open-folders="openFolders = $event"
       />
+      <p
+        v-if="isFiltering && !filteredTree.length"
+        class="ep:m-0 ep:px-3 ep:py-2 ep:text-xs ep:text-muted-ep"
+      >
+        No match for “{{ searchQuery }}”.
+      </p>
     </nav>
     <div
       v-if="!collapsed && auth.user.value"

package/dist/runtime/components/editor/EponymeSidebarTree.d.vue.ts

@@ -6,6 +6,8 @@ type __VLS_Props = {
     currentPath: string;
     statuses: Record<string, EponymeStatus>;
     openFolders: string[];
+    /** Reveals every folder while a search is active, without touching `openFolders`. */
+    forceOpen?: boolean;
     canEdit?: boolean;
     depth?: number;
 };

package/dist/runtime/components/editor/EponymeSidebarTree.vue

@@ -8,6 +8,7 @@ const props = defineProps({
   currentPath: { type: String, required: true },
   statuses: { type: Object, required: true },
   openFolders: { type: Array, required: true },
+  forceOpen: { type: Boolean, required: false, default: false },
   canEdit: { type: Boolean, required: false, default: false },
   depth: { type: Number, required: false, default: 0 }
 });
@@ -16,7 +17,7 @@ function entryPath(path) {
   return `${props.basePath}/${path}`;
 }
 function isOpen(path) {
-  return props.openFolders.includes(path);
+  return props.forceOpen || props.openFolders.includes(path);
 }
 function setOpen(path, open) {
   const next = new Set(props.openFolders);
@@ -66,6 +67,7 @@ function setOpen(path, open) {
           :current-path="currentPath"
           :statuses="statuses"
           :open-folders="openFolders"
+          :force-open="forceOpen"
           :can-edit="canEdit"
           :depth="depth + 1"
           @update:open-folders="emit('update:openFolders', $event)"

package/dist/runtime/components/editor/EponymeSidebarTree.vue.d.ts

@@ -6,6 +6,8 @@ type __VLS_Props = {
     currentPath: string;
     statuses: Record<string, EponymeStatus>;
     openFolders: string[];
+    /** Reveals every folder while a search is active, without touching `openFolders`. */
+    forceOpen?: boolean;
     canEdit?: boolean;
     depth?: number;
 };

package/dist/runtime/components/fields/RichTextField.vue

@@ -2,11 +2,27 @@
 import Image from "@tiptap/extension-image";
 import Placeholder from "@tiptap/extension-placeholder";
 import StarterKit from "@tiptap/starter-kit";
-import { EditorContent, useEditor } from "@tiptap/vue-3";
+import { EditorContent, Extension, useEditor } from "@tiptap/vue-3";
 import { computed, ref, watch } from "vue";
-import EPFormField from "../ui/EPFormField.vue";
-import EPDropdownMenu from "../ui/EPDropdownMenu.vue";
 import { useEponymeVariables } from "../../composables/useEponymeVariables";
+import EPDropdownMenu from "../ui/EPDropdownMenu.vue";
+import EPFormField from "../ui/EPFormField.vue";
+import EPLinkDialog from "../ui/EPLinkDialog.vue";
+const DownloadableLinkAttribute = Extension.create({
+  name: "downloadableLinkAttribute",
+  addGlobalAttributes() {
+    return [{
+      types: ["link"],
+      attributes: {
+        download: {
+          default: null,
+          parseHTML: (element) => element.hasAttribute("download"),
+          renderHTML: (attributes) => attributes.download ? { download: "" } : {}
+        }
+      }
+    }];
+  }
+});
 const props = defineProps({
   id: { type: String, required: true },
   modelValue: { type: null, required: false },
@@ -22,6 +38,8 @@ const props = defineProps({
 });
 const emit = defineEmits(["update:modelValue"]);
 const revision = ref(0);
+const linkDialogOpen = ref(false);
+const linkValue = ref({ href: "", type: "external", openInNewTab: false, download: false });
 const initialContent = typeof props.modelValue === "string" ? props.modelValue : "";
 const editor = useEditor({
   content: initialContent,
@@ -36,6 +54,7 @@ const editor = useEditor({
         HTMLAttributes: { rel: "noopener noreferrer" }
       }
     }),
+    DownloadableLinkAttribute,
     Placeholder.configure({ placeholder: props.placeholder }),
     Image.configure({ HTMLAttributes: { class: "eponyme-rich-text-image" } })
   ],
@@ -61,17 +80,33 @@ function isActive(name, attributes = {}) {
   trackEditorRevision();
   return editor.value?.isActive(name, attributes) ?? false;
 }
-function setLink() {
+function openLinkDialog() {
+  const instance = editor.value;
+  if (!instance) return;
+  const attributes = instance.getAttributes("link");
+  const href = String(attributes.href ?? "");
+  linkValue.value = {
+    href,
+    type: href.startsWith("/") || href.startsWith("#") ? "internal" : "external",
+    openInNewTab: attributes.target === "_blank",
+    download: attributes.download === true
+  };
+  linkDialogOpen.value = true;
+}
+function applyLink(value) {
   const instance = editor.value;
   if (!instance) return;
-  const current = String(instance.getAttributes("link").href ?? "");
-  const href = window.prompt("Link URL", current || "https://");
-  if (href === null) return;
-  if (!href.trim()) {
+  if (!value.href) {
     instance.chain().focus().extendMarkRange("link").unsetLink().run();
     return;
   }
-  instance.chain().focus().extendMarkRange("link").setLink({ href: href.trim() }).run();
+  const attributes = {
+    href: value.href,
+    target: value.openInNewTab ? "_blank" : null,
+    rel: "noopener noreferrer",
+    download: value.download ? true : null
+  };
+  instance.chain().focus().extendMarkRange("link").setLink(attributes).run();
 }
 function setImage() {
   const instance = editor.value;
@@ -104,7 +139,7 @@ const tools = computed(() => {
     { icon: "mingcute:bold-line", title: "Bold", active: isActive("bold"), separated: true, run: () => instance.chain().focus().toggleBold().run() },
     { icon: "mingcute:italic-line", title: "Italic", active: isActive("italic"), run: () => instance.chain().focus().toggleItalic().run() },
     { icon: "mingcute:strikethrough-line", title: "Strikethrough", active: isActive("strike"), run: () => instance.chain().focus().toggleStrike().run() },
-    { icon: "mingcute:link-line", title: "Link", active: isActive("link"), run: setLink },
+    { icon: "mingcute:link-line", title: "Link", active: isActive("link"), run: openLinkDialog },
     { icon: "mingcute:pic-line", title: "Image", active: isActive("image"), run: setImage },
     { icon: "mingcute:list-check-line", title: "Bullet list", active: isActive("bulletList"), separated: true, run: () => instance.chain().focus().toggleBulletList().run() },
     { icon: "mingcute:list-ordered-line", title: "Numbered list", active: isActive("orderedList"), run: () => instance.chain().focus().toggleOrderedList().run() },
@@ -199,6 +234,12 @@ const tools = computed(() => {
     >
       {{ characterCount }} / {{ maxLength }}
     </p>
+    <EPLinkDialog
+      :open="linkDialogOpen"
+      :model-value="linkValue"
+      @update:open="linkDialogOpen = $event"
+      @update:model-value="applyLink"
+    />
   </EPFormField>
 </template>
 

package/dist/runtime/components/ui/EPLinkDialog.d.vue.ts

@@ -0,0 +1,15 @@
+import type { UrlValue } from '../../types/index.js';
+type __VLS_Props = {
+    open: boolean;
+    modelValue?: unknown;
+    placeholder?: string;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: UrlValue) => any;
+    "update:open": (value: boolean) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: UrlValue) => any) | undefined;
+    "onUpdate:open"?: ((value: boolean) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/runtime/components/ui/EPLinkDialog.vue

@@ -0,0 +1,142 @@
+<script setup>
+import { computed, ref, watch } from "vue";
+import EPButton from "./EPButton.vue";
+import EPDialog from "./EPDialog.vue";
+import EPInputText from "./EPInputText.vue";
+import EPRadioButton from "./EPRadioButton.vue";
+import EPSwitch from "./EPSwitch.vue";
+import { getDownloadableExtension } from "../../utils/downloadable-link";
+const props = defineProps({
+  open: { type: Boolean, required: true },
+  modelValue: { type: null, required: false },
+  placeholder: { type: String, required: false }
+});
+const emit = defineEmits(["update:open", "update:modelValue"]);
+const draftHref = ref("");
+const draftType = ref("external");
+const draftOpenInNewTab = ref(false);
+const draftDownload = ref(false);
+const value = computed(() => {
+  if (props.modelValue && typeof props.modelValue === "object" && !Array.isArray(props.modelValue)) {
+    const link = props.modelValue;
+    return {
+      href: typeof link.href === "string" ? link.href : "",
+      type: link.type === "internal" ? "internal" : "external",
+      openInNewTab: link.openInNewTab === true,
+      download: link.download === true
+    };
+  }
+  return { href: "", type: "external", openInNewTab: false, download: false };
+});
+const downloadableExtension = computed(() => getDownloadableExtension(draftHref.value));
+const typeOptions = [
+  { label: "Internal link", value: "internal" },
+  { label: "External link", value: "external" }
+];
+watch(() => props.open, (open) => {
+  if (!open) return;
+  draftHref.value = value.value.href;
+  draftType.value = value.value.type;
+  draftOpenInNewTab.value = value.value.openInNewTab;
+  draftDownload.value = value.value.download === true;
+});
+function updateType(type) {
+  draftType.value = type === "internal" ? "internal" : "external";
+}
+function updateHref(href) {
+  draftHref.value = String(href);
+  if (!getDownloadableExtension(draftHref.value)) draftDownload.value = false;
+}
+function apply() {
+  emit("update:modelValue", {
+    href: draftHref.value.trim(),
+    type: draftType.value,
+    openInNewTab: draftOpenInNewTab.value,
+    download: Boolean(downloadableExtension.value && draftDownload.value)
+  });
+  emit("update:open", false);
+}
+</script>
+
+<template>
+  <EPDialog
+    :open="open"
+    title="Configure link"
+    description="Choose where the link points and how it should open."
+    @update:open="emit('update:open', $event)"
+  >
+    <div class="ep:grid ep:gap-5">
+      <div>
+        <p class="ep:mt-0 ep:mb-2 ep:text-sm ep:font-medium ep:text-white">
+          Link type
+        </p>
+        <EPRadioButton
+          :model-value="draftType"
+          :options="typeOptions"
+          @update:model-value="updateType"
+        />
+      </div>
+
+      <label class="ep:block">
+        <span class="ep:mb-2 ep:block ep:text-sm ep:font-medium ep:text-white">Destination</span>
+        <EPInputText
+          :model-value="draftHref"
+          :type="draftType === 'external' ? 'url' : 'text'"
+          :placeholder="draftType === 'internal' ? '/contact' : placeholder || 'https://example.com'"
+          @update:model-value="updateHref"
+        />
+        <span class="ep:mt-1.5 ep:block ep:text-xs ep:text-muted-ep">
+          {{ draftType === "internal" ? "Use a path beginning with / or an anchor beginning with #." : "Use a complete HTTP(S) address." }}
+        </span>
+      </label>
+
+      <div
+        v-if="downloadableExtension"
+        class="ep:flex ep:items-center ep:justify-between ep:gap-4 ep:rounded-xl ep:bg-selected-ep/40 ep:px-4 ep:py-3"
+      >
+        <div>
+          <p class="ep:m-0 ep:text-sm ep:font-medium ep:text-white">
+            Download file
+          </p>
+          <p class="ep:mt-1 ep:mb-0 ep:text-xs ep:text-muted-ep">
+            A .{{ downloadableExtension }} file was detected. Ask the browser to download it instead of opening it.
+          </p>
+        </div>
+        <EPSwitch
+          :model-value="draftDownload"
+          @update:model-value="draftDownload = $event"
+        />
+      </div>
+
+      <div class="ep:flex ep:items-center ep:justify-between ep:gap-4 ep:rounded-xl ep:bg-selected-ep/40 ep:px-4 ep:py-3">
+        <div>
+          <p class="ep:m-0 ep:text-sm ep:font-medium ep:text-white">
+            Open in new tab
+          </p>
+          <p class="ep:mt-1 ep:mb-0 ep:text-xs ep:text-muted-ep">
+            Keep the current page open when visitors follow this link.
+          </p>
+        </div>
+        <EPSwitch
+          :model-value="draftOpenInNewTab"
+          @update:model-value="draftOpenInNewTab = $event"
+        />
+      </div>
+
+      <div class="ep:flex ep:justify-end ep:gap-2">
+        <EPButton
+          variant="ghost"
+          @click="emit('update:open', false)"
+        >
+          Cancel
+        </EPButton>
+        <EPButton
+          variant="primary"
+          @click="apply"
+        >
+          Apply link
+        </EPButton>
+      </div>
+    </div>
+  </EPDialog>
+</template>

package/dist/runtime/components/ui/EPLinkDialog.vue.d.ts

@@ -0,0 +1,15 @@
+import type { UrlValue } from '../../types/index.js';
+type __VLS_Props = {
+    open: boolean;
+    modelValue?: unknown;
+    placeholder?: string;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: UrlValue) => any;
+    "update:open": (value: boolean) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: UrlValue) => any) | undefined;
+    "onUpdate:open"?: ((value: boolean) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/runtime/components/ui/EPLinkEditor.vue

@@ -1,10 +1,7 @@
 <script setup>
 import { computed, ref } from "vue";
 import EPButton from "./EPButton.vue";
-import EPDialog from "./EPDialog.vue";
-import EPInputText from "./EPInputText.vue";
-import EPRadioButton from "./EPRadioButton.vue";
-import EPSwitch from "./EPSwitch.vue";
+import EPLinkDialog from "./EPLinkDialog.vue";
 import EPTooltip from "./EPTooltip.vue";
 const props = defineProps({
   id: { type: String, required: true },
@@ -16,47 +13,24 @@ const props = defineProps({
 });
 const emit = defineEmits(["update:modelValue"]);
 const dialogOpen = ref(false);
-const draftHref = ref("");
-const draftType = ref("external");
-const draftOpenInNewTab = ref(false);
 const value = computed(() => {
   if (props.modelValue && typeof props.modelValue === "object" && !Array.isArray(props.modelValue)) {
     const link = props.modelValue;
     return {
       href: typeof link.href === "string" ? link.href : "",
       type: link.type === "internal" ? "internal" : "external",
-      openInNewTab: link.openInNewTab === true
+      openInNewTab: link.openInNewTab === true,
+      download: link.download === true
     };
   }
-  return { href: "", type: "external", openInNewTab: false };
+  return { href: "", type: "external", openInNewTab: false, download: false };
 });
-const typeOptions = [
-  { label: "Internal link", value: "internal" },
-  { label: "External link", value: "external" }
-];
 function openDialog() {
-  draftHref.value = value.value.href;
-  draftType.value = value.value.type;
-  draftOpenInNewTab.value = value.value.openInNewTab;
   dialogOpen.value = true;
 }
 function updateDialogOpen(open) {
   dialogOpen.value = open;
 }
-function updateType(type) {
-  draftType.value = type === "internal" ? "internal" : "external";
-}
-function updateHref(href) {
-  draftHref.value = String(href);
-}
-function save() {
-  emit("update:modelValue", {
-    href: draftHref.value.trim(),
-    type: draftType.value,
-    openInNewTab: draftOpenInNewTab.value
-  });
-  dialogOpen.value = false;
-}
 function openLink() {
   if (!value.value.href || typeof window === "undefined") return;
   const href = value.value.type === "internal" ? new URL(value.value.href, window.location.origin).href : value.value.href;
@@ -80,7 +54,7 @@ function openLink() {
         {{ value.href || "No link configured" }}
       </p>
       <p class="ep:mt-0.5 ep:mb-0 ep:text-[11px] ep:text-muted-ep">
-        {{ value.type === "internal" ? "Internal" : "External" }} · {{ value.openInNewTab ? "New tab" : "Same tab" }}
+        {{ value.type === "internal" ? "Internal" : "External" }} · {{ value.download ? "Download" : value.openInNewTab ? "New tab" : "Same tab" }}
       </p>
     </div>
     <EPTooltip content="Open link">
@@ -104,66 +78,11 @@ function openLink() {
     </EPTooltip>
   </div>
 
-  <EPDialog
+  <EPLinkDialog
     :open="dialogOpen"
-    title="Configure link"
-    description="Choose where the link points and how it should open."
+    :model-value="value"
+    :placeholder="placeholder"
     @update:open="updateDialogOpen"
-  >
-    <div class="ep:grid ep:gap-5">
-      <div>
-        <p class="ep:mt-0 ep:mb-2 ep:text-sm ep:font-medium ep:text-white">
-          Link type
-        </p>
-        <EPRadioButton
-          :model-value="draftType"
-          :options="typeOptions"
-          @update:model-value="updateType"
-        />
-      </div>
-
-      <label class="ep:block">
-        <span class="ep:mb-2 ep:block ep:text-sm ep:font-medium ep:text-white">Destination</span>
-        <EPInputText
-          :model-value="draftHref"
-          :type="draftType === 'external' ? 'url' : 'text'"
-          :placeholder="draftType === 'internal' ? '/contact' : placeholder || 'https://example.com'"
-          @update:model-value="updateHref"
-        />
-        <span class="ep:mt-1.5 ep:block ep:text-xs ep:text-muted-ep">
-          {{ draftType === "internal" ? "Use a path beginning with / or an anchor beginning with #." : "Use a complete HTTP(S) address." }}
-        </span>
-      </label>
-
-      <div class="ep:flex ep:items-center ep:justify-between ep:gap-4 ep:rounded-xl ep:bg-selected-ep/40 ep:px-4 ep:py-3">
-        <div>
-          <p class="ep:m-0 ep:text-sm ep:font-medium ep:text-white">
-            Open in new tab
-          </p>
-          <p class="ep:mt-1 ep:mb-0 ep:text-xs ep:text-muted-ep">
-            Keep the current page open when visitors follow this link.
-          </p>
-        </div>
-        <EPSwitch
-          :model-value="draftOpenInNewTab"
-          @update:model-value="draftOpenInNewTab = $event"
-        />
-      </div>
-
-      <div class="ep:flex ep:justify-end ep:gap-2">
-        <EPButton
-          variant="ghost"
-          @click="dialogOpen = false"
-        >
-          Cancel
-        </EPButton>
-        <EPButton
-          variant="primary"
-          @click="save"
-        >
-          Apply link
-        </EPButton>
-      </div>
-    </div>
-  </EPDialog>
+    @update:model-value="emit('update:modelValue', $event)"
+  />
 </template>

package/dist/runtime/composables/useEponyme.js

@@ -1,6 +1,7 @@
 import { clearNuxtData, useAsyncData, useRequestFetch, useRoute } from "#app";
 import { computed, ref } from "vue";
 import { readPreviewQuery, readPreviewVersion } from "../utils/preview.js";
+import { cacheDuringHydrationOnly } from "../utils/hydration-cache.js";
 export function useEponyme(name, options = {}) {
   const route = useRoute();
   const preview = readPreviewQuery(route.query);
@@ -8,10 +9,11 @@ export function useEponyme(name, options = {}) {
   const errors = ref({});
   const saving = ref(false);
   const requestFetch = useRequestFetch();
+  const cacheKey = `eponyme:${name}:${version}${options.raw ? ":raw" : ""}`;
   const { data: response, pending: loading, error, refresh: load } = useAsyncData(
-    `eponyme:${name}:${version}${options.raw ? ":raw" : ""}`,
+    cacheKey,
     () => requestFetch(`/api/eponyme/${name}`, { query: { version, raw: options.raw ? 1 : void 0 }, cache: "no-store" }),
-    { getCachedData: () => void 0 }
+    { getCachedData: cacheDuringHydrationOnly }
   );
   const data = computed(() => response.value?.data);
   const status = computed(() => response.value?.status ?? "published");
@@ -31,7 +33,7 @@ export function useEponyme(name, options = {}) {
       });
       response.value = next;
       if (action === "publish") {
-        clearNuxtData((key) => key.startsWith(`eponyme:${name}:`) && key !== `eponyme:${name}:${version}`);
+        clearNuxtData((key) => key.startsWith(`eponyme:${name}:`) && key !== cacheKey);
         const parts = String(name).split("/");
         const slug = parts.pop();
         const collectionName = parts.join("/");

package/dist/runtime/composables/useEponymeCollection.js

@@ -2,6 +2,7 @@ import { useAsyncData, useRequestFetch, useRoute } from "#app";
 import { useEventListener } from "@vueuse/core";
 import { computed } from "vue";
 import { readPreviewQuery, readPreviewVersion } from "../utils/preview.js";
+import { cacheDuringHydrationOnly } from "../utils/hydration-cache.js";
 export function useEponymeCollection(name, options = {}) {
   const requestFetch = useRequestFetch();
   const query = {
@@ -15,7 +16,7 @@ export function useEponymeCollection(name, options = {}) {
     // same collection would share one cache entry.
     `eponyme:collection:public:${name}:${options.take ?? ""}:${options.skip ?? ""}:${options.orderBy ?? ""}:${options.order ?? ""}`,
     () => requestFetch(`/api/eponyme-collections/${name}`, { query, cache: "no-store" }),
-    { getCachedData: () => void 0 }
+    { getCachedData: cacheDuringHydrationOnly }
   );
   const entries = computed(() => result.data.value?.entries ?? []);
   if (import.meta.client) useEventListener(window, "focus", () => void result.refresh());
@@ -37,7 +38,7 @@ export function useEponymeCollectionEntry(name, slug, options = {}) {
   const result = useAsyncData(
     `eponyme:collection-entry:${name}:${slug}:${version}`,
     () => requestFetch(`/api/eponyme/${name}/${encodeURIComponent(slug)}`, { query: { version }, cache: "no-store" }),
-    { getCachedData: () => void 0 }
+    { getCachedData: cacheDuringHydrationOnly }
   );
   if (import.meta.client) useEventListener(window, "focus", () => void result.refresh());
   return {

package/dist/runtime/composables/useEponymeForm.d.ts

@@ -24,6 +24,10 @@ export interface UseEponymeFormResult<Data extends Record<string, unknown>> {
     submitted: Ref<boolean>;
     /** Name of the trap field to render hidden, or `false` when disabled. */
     honeypot: string | false;
+    /** True when the form declares `captcha: true`; render a widget and fill `captchaToken`. */
+    requiresCaptcha: boolean;
+    /** Bind this to the captcha widget, for example `<NuxtTurnstile v-model="captchaToken" />`. */
+    captchaToken: Ref<string>;
     submit: () => Promise<boolean>;
     reset: () => void;
 }