@karibsen/eponyme 0.1.0 → 0.2.0

package/dist/runtime/utils/downloadable-link.js

@@ -0,0 +1,35 @@
+const DOWNLOADABLE_EXTENSIONS = /* @__PURE__ */ new Set([
+  "7z",
+  "apk",
+  "bz2",
+  "csv",
+  "dmg",
+  "doc",
+  "docx",
+  "epub",
+  "gz",
+  "json",
+  "odg",
+  "odp",
+  "ods",
+  "odt",
+  "pdf",
+  "ppt",
+  "pptx",
+  "rar",
+  "rtf",
+  "tar",
+  "txt",
+  "xls",
+  "xlsx",
+  "xml",
+  "zip"
+]);
+export function getDownloadableExtension(href) {
+  const path = href.trim().split(/[?#]/, 1)[0] ?? "";
+  const extension = path.match(/\.([a-z0-9]+)$/i)?.[1]?.toLowerCase();
+  return extension && DOWNLOADABLE_EXTENSIONS.has(extension) ? extension : void 0;
+}
+export function isDownloadableLink(href) {
+  return getDownloadableExtension(href) !== void 0;
+}

package/dist/runtime/utils/empty-variables.d.ts

@@ -0,0 +1,2 @@
+declare const _default: {};
+export default _default;

package/dist/runtime/utils/empty-variables.js

@@ -0,0 +1 @@
+export default {};

package/dist/runtime/utils/filter-navigation-tree.d.ts

@@ -0,0 +1,7 @@
+import type { EponymeNavigationNode } from '../types/eponyme-navigation.js';
+/**
+ * Keeps the nodes matching `query`, along with every ancestor needed to reach them.
+ * A node matched on its own label keeps all of its children, so selecting a folder
+ * shows what it holds. An empty query returns the tree untouched.
+ */
+export declare function filterEponymeNavigationTree(nodes: EponymeNavigationNode[], query: string): EponymeNavigationNode[];

package/dist/runtime/utils/filter-navigation-tree.js

@@ -0,0 +1,39 @@
+import Fuse from "fuse.js";
+function normalize(value) {
+  return value.normalize("NFD").replace(/\p{Diacritic}/gu, "").toLowerCase();
+}
+function collect(nodes, items) {
+  for (const node of nodes) {
+    items.push({ path: node.path, label: normalize(node.label), searchPath: normalize(node.path) });
+    collect(node.children, items);
+  }
+}
+const indexes = /* @__PURE__ */ new WeakMap();
+function indexOf(nodes) {
+  const cached = indexes.get(nodes);
+  if (cached) return cached;
+  const items = [];
+  collect(nodes, items);
+  const fuse = new Fuse(items, {
+    keys: ["label", "searchPath"],
+    // Tolerant enough for a typo, strict enough that a short query does not match everything.
+    threshold: 0.35,
+    // Without this a match near the end of a long label is penalised into irrelevance.
+    ignoreLocation: true
+  });
+  indexes.set(nodes, fuse);
+  return fuse;
+}
+export function filterEponymeNavigationTree(nodes, query) {
+  const term = normalize(query.trim());
+  if (!term) return nodes;
+  const matched = new Set(indexOf(nodes).search(term).map((result) => result.item.path));
+  function keep(list) {
+    return list.flatMap((node) => {
+      if (matched.has(node.path)) return [node];
+      const children = keep(node.children);
+      return children.length ? [{ ...node, children }] : [];
+    });
+  }
+  return keep(nodes);
+}

package/dist/runtime/utils/get-field-default-value.js

@@ -31,7 +31,7 @@ export function getFieldDefaultValue(definition) {
     case "number":
       return 0;
     case "url":
-      return { href: "", type: "external", openInNewTab: false };
+      return { href: "", type: "external", openInNewTab: false, download: false };
     case "boolean":
       return false;
     default:

package/dist/runtime/utils/hydration-cache.d.ts

@@ -0,0 +1,11 @@
+import type { NuxtApp } from '#app';
+/**
+ * `getCachedData` for reads that must never serve a stale value.
+ *
+ * Returning `undefined` unconditionally looks like the obvious way to always refetch,
+ * but it also discards the payload the server rendered from: the first client render
+ * then has no data and disagrees with the HTML, which Vue reports as a hydration
+ * mismatch. Reusing the payload while hydrating, and nothing afterwards, keeps the
+ * first paint faithful and still refetches on every later navigation.
+ */
+export declare function cacheDuringHydrationOnly<T>(key: string, nuxtApp: NuxtApp): T | undefined;

package/dist/runtime/utils/hydration-cache.js

@@ -0,0 +1,3 @@
+export function cacheDuringHydrationOnly(key, nuxtApp) {
+  return nuxtApp.isHydrating ? nuxtApp.payload.data[key] : void 0;
+}

package/dist/runtime/utils/validate-eponyme-data.js

@@ -127,7 +127,7 @@ function validateFieldRules(name, definition, value, errors, mode, _context) {
       return;
     }
     const link = value;
-    if (typeof link.href !== "string" || !["internal", "external"].includes(String(link.type)) || typeof link.openInNewTab !== "boolean") {
+    if (typeof link.href !== "string" || !["internal", "external"].includes(String(link.type)) || typeof link.openInNewTab !== "boolean" || link.download !== void 0 && typeof link.download !== "boolean") {
       addError(errors, name, "Must be a valid link.");
       return;
     }

package/dist/runtime/utils/variables.d.ts

@@ -0,0 +1,18 @@
+import type { EponymeVariableDefinition, EponymeVariables } from '../types/variables.js';
+/** Always available, whatever the host application configures. */
+export declare function builtinEponymeVariables(now?: Date): Record<string, EponymeVariableDefinition>;
+/** Host variables win, so an application can override a built-in for its own wording. */
+export declare function resolveEponymeVariables(custom?: EponymeVariables, now?: Date): Record<string, string>;
+export declare function summariseEponymeVariables(custom?: EponymeVariables): Array<{
+    name: string;
+    label: string;
+    description?: string;
+    preview: string;
+}>;
+/**
+ * Replaces every `{{ name }}` occurrence. An unknown name is left untouched rather
+ * than blanked, so a typo shows up on the page instead of silently deleting text.
+ */
+export declare function interpolateEponymeText(text: string, variables: Record<string, string>): string;
+/** Walks strings nested in objects and arrays, leaving every other value alone. */
+export declare function interpolateEponymeValue<T>(value: T, variables: Record<string, string>): T;

package/dist/runtime/utils/variables.js

@@ -0,0 +1,52 @@
+const VARIABLE_PATTERN = /\{\{\s*([A-Z_]\w*)\s*\}\}/gi;
+export function builtinEponymeVariables(now = /* @__PURE__ */ new Date()) {
+  return {
+    currentYear: { label: "Current year", description: "The year at the time the page is served.", value: () => now.getFullYear() },
+    nextYear: { label: "Next year", description: "Useful for a season spanning two years.", value: () => now.getFullYear() + 1 },
+    previousYear: { label: "Previous year", value: () => now.getFullYear() - 1 },
+    currentMonth: { label: "Current month", value: () => now.toLocaleDateString(void 0, { month: "long" }) },
+    currentDay: { label: "Current day", value: () => String(now.getDate()) },
+    today: { label: "Today", description: "Localised date, for example 29 July 2026.", value: () => now.toLocaleDateString(void 0, { dateStyle: "long" }) },
+    currentDate: { label: "Today (ISO)", description: "Machine-readable date, for example 2026-07-29.", value: () => now.toISOString().slice(0, 10) }
+  };
+}
+function toDefinition(entry) {
+  return typeof entry === "object" && entry !== null && "value" in entry ? entry : { value: entry };
+}
+export function resolveEponymeVariables(custom = {}, now) {
+  const merged = { ...builtinEponymeVariables(now) };
+  for (const [name, entry] of Object.entries(custom)) merged[name] = toDefinition(entry);
+  return Object.fromEntries(Object.entries(merged).map(([name, definition]) => {
+    try {
+      const value = typeof definition.value === "function" ? definition.value() : definition.value;
+      return [name, String(value)];
+    } catch {
+      return [name, ""];
+    }
+  }));
+}
+export function summariseEponymeVariables(custom = {}) {
+  const merged = { ...builtinEponymeVariables() };
+  for (const [name, entry] of Object.entries(custom)) merged[name] = toDefinition(entry);
+  const resolved = resolveEponymeVariables(custom);
+  return Object.entries(merged).map(([name, definition]) => ({
+    name,
+    label: definition.label ?? name,
+    description: definition.description,
+    preview: resolved[name] ?? ""
+  }));
+}
+export function interpolateEponymeText(text, variables) {
+  if (!text.includes("{{")) return text;
+  return text.replace(VARIABLE_PATTERN, (match, name) => variables[name] ?? match);
+}
+export function interpolateEponymeValue(value, variables) {
+  if (typeof value === "string") return interpolateEponymeText(value, variables);
+  if (Array.isArray(value)) return value.map((item) => interpolateEponymeValue(item, variables));
+  if (value && typeof value === "object") {
+    return Object.fromEntries(
+      Object.entries(value).map(([key, nested]) => [key, interpolateEponymeValue(nested, variables)])
+    );
+  }
+  return value;
+}

package/dist/types.d.mts

@@ -1,10 +1,10 @@
-export { type collection, type defineEponymeConfig, type form } from './eponyme.mjs'
+export { type collection, type defineEponymeConfig, type defineEponymeVariables, type form } from './eponyme.mjs'
 
 export { type field, type today } from '../dist/runtime/fields/index.js'
 
 export { type EPONYME_ROLES, type canEditEponyme, type isEponymeRole } from '../dist/runtime/types/auth.js'
 
-export { type ArrayFieldDefinition, type ArrayFieldOptions, type ArrayItemDefinition, type ArrayItemFieldDefinition, type ArrayItemSchema, type ArrayItemValue, type BooleanFieldDefinition, type BooleanFieldOptions, type CheckboxGroupFieldDefinition, type CheckboxGroupFieldOptions, type CollectionSlugField, type ColorFieldDefinition, type ColorFieldOptions, type DateFieldDefinition, type DateFieldOptions, type EmailFieldDefinition, type EmailFieldOptions, type EponymeAuthSession, type EponymeAuthUser, type EponymeCollectionDataByName, type EponymeCollectionDefinition, type EponymeCollectionDefinitionBase, type EponymeCollectionName, type EponymeCollectionOptions, type EponymeConfig, type EponymeData, type EponymeDataByName, type EponymeFormDataByName, type EponymeFormDefinition, type EponymeFormDefinitionBase, type EponymeFormFieldDefinition, type EponymeFormMode, type EponymeFormName, type EponymeFormOptions, type EponymeFormSchema, type EponymeManagedUserResult, type EponymeName, type EponymeRole, type EponymeSchema, type FieldDefinition, type FieldValidationResult, type FieldValidator, type FieldVisibilityCondition, type ImageFieldDefinition, type ImageFieldOptions, type NumberFieldDefinition, type NumberFieldOptions, type RadioFieldDefinition, type RadioFieldOptions, type RichTextFieldDefinition, type RichTextFieldOptions, type SectionFieldDefinition, type SectionFieldOptions, type SectionItemFieldDefinition, type SectionItemValue, type SectionSchema, type SectionValue, type SelectFieldDefinition, type SelectFieldOptions, type SelectOption, type SlugFieldDefinition, type SlugFieldOptions, type StringFieldDefinition, type StringFieldOptions, type TabDefinition, type TabFieldDefinition, type TabFieldOptions, type TabsSchema, type TabsValue, type TextareaFieldDefinition, type TextareaFieldOptions, type TodayDateDefault, type UrlFieldDefinition, type UrlFieldOptions, type UrlType, type UrlValue } from '../dist/runtime/types/index.js'
+export { type ArrayFieldDefinition, type ArrayFieldOptions, type ArrayItemDefinition, type ArrayItemFieldDefinition, type ArrayItemSchema, type ArrayItemValue, type BooleanFieldDefinition, type BooleanFieldOptions, type CheckboxGroupFieldDefinition, type CheckboxGroupFieldOptions, type CollectionSlugField, type ColorFieldDefinition, type ColorFieldOptions, type DateFieldDefinition, type DateFieldOptions, type EmailFieldDefinition, type EmailFieldOptions, type EponymeAuthSession, type EponymeAuthUser, type EponymeCollectionDataByName, type EponymeCollectionDefinition, type EponymeCollectionDefinitionBase, type EponymeCollectionName, type EponymeCollectionOptions, type EponymeConfig, type EponymeData, type EponymeDataByName, type EponymeFormDataByName, type EponymeFormDefinition, type EponymeFormDefinitionBase, type EponymeFormFieldDefinition, type EponymeFormMode, type EponymeFormName, type EponymeFormOptions, type EponymeFormSchema, type EponymeManagedUserResult, type EponymeName, type EponymeRole, type EponymeSchema, type EponymeVariableDefinition, type EponymeVariableSummary, type EponymeVariableValue, type EponymeVariables, type FieldDefinition, type FieldValidationResult, type FieldValidator, type FieldVisibilityCondition, type ImageFieldDefinition, type ImageFieldOptions, type NumberFieldDefinition, type NumberFieldOptions, type RadioFieldDefinition, type RadioFieldOptions, type RichTextFieldDefinition, type RichTextFieldOptions, type SectionFieldDefinition, type SectionFieldOptions, type SectionItemFieldDefinition, type SectionItemValue, type SectionSchema, type SectionValue, type SelectFieldDefinition, type SelectFieldOptions, type SelectOption, type SlugFieldDefinition, type SlugFieldOptions, type StringFieldDefinition, type StringFieldOptions, type TabDefinition, type TabFieldDefinition, type TabFieldOptions, type TabsSchema, type TabsValue, type TextareaFieldDefinition, type TextareaFieldOptions, type TodayDateDefault, type UrlFieldDefinition, type UrlFieldOptions, type UrlType, type UrlValue } from '../dist/runtime/types/index.js'
 
 export { default } from './module.mjs'
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@karibsen/eponyme",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "A lightweight, type-safe content manager for Nuxt.",
   "license": "MIT",
   "type": "module",
@@ -62,6 +62,7 @@
     "@iconify-json/mingcute": "^1.2.7",
     "@nuxt/icon": "^2.3.1",
     "@nuxt/kit": "^4.4.8",
+    "@karibsen/ui": "latest",
     "@tailwindcss/vite": "^4.1.12",
     "@tanstack/vue-table": "^8.21.3",
     "@tiptap/extension-image": "^3.29.2",
@@ -70,6 +71,7 @@
     "@tiptap/vue-3": "^3.28.0",
     "@vueuse/core": "^14.3.0",
     "@vueuse/integrations": "^14.3.0",
+    "fuse.js": "^7.5.0",
     "picocolors": "^1.1.1",
     "reka-ui": "^2.10.1",
     "slugify": "^1.6.9",