vitepress-velonor 0.1.0

package/README.md

@@ -0,0 +1,9 @@
+# vitepress-velonor
+
+Lightweight blog micro-engine for VitePress themes.
+
+## Install
+
+```bash
+npm i vitepress-velonor
+```

package/dist/chunk-BCwAaXi7.cjs

@@ -0,0 +1,31 @@
+"use strict";
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+
+Object.defineProperty(exports, '__toESM', {
+  enumerable: true,
+  get: function () {
+    return __toESM;
+  }
+});

package/dist/client.cjs

@@ -0,0 +1,261 @@
+"use strict";
+const require_chunk = require('./chunk-BCwAaXi7.cjs');
+const require_constants = require('./constants-CnBvTOWr.cjs');
+const require_date = require('./date-ygOc7hIU.cjs');
+const vue = require_chunk.__toESM(require("vue"));
+const vitepress_client = require_chunk.__toESM(require("vitepress/client"));
+
+//#region src/utils/url.ts
+const isClient = typeof window !== "undefined";
+const getQueryParam = (key) => {
+	if (!isClient) return null;
+	const url = new URL(window.location.href);
+	return url.searchParams.get(key);
+};
+const setQueryParam = (key, value, options) => {
+	if (!isClient) return;
+	const url = new URL(window.location.href);
+	if (value === null || value === "") url.searchParams.delete(key);
+	else url.searchParams.set(key, value);
+	const replace = options?.replace ?? true;
+	if (replace) window.history.replaceState(null, "", url.toString());
+	else window.history.pushState(null, "", url.toString());
+};
+
+//#endregion
+//#region src/composables/useQueryParam.ts
+const useSyncedQueryParam = (options) => {
+	const { key, defaultValue, parse, serialize } = options;
+	const route = (0, vitepress_client.useRoute)();
+	const state = (0, vue.ref)(defaultValue);
+	const read = () => {
+		const raw = getQueryParam(key);
+		const next = parse ? parse(raw) : raw ?? defaultValue;
+		state.value = next;
+	};
+	const write = (value) => {
+		const current = getQueryParam(key);
+		const next = serialize ? serialize(value) : value === defaultValue ? null : String(value);
+		if (next === current || next === null && current === null) return;
+		setQueryParam(key, next, { replace: true });
+	};
+	const canUseDom = typeof window !== "undefined";
+	if (canUseDom) read();
+	(0, vue.watch)(() => route.path, () => {
+		if (canUseDom) read();
+	});
+	(0, vue.watch)(state, (value) => {
+		if (canUseDom) write(value);
+	}, { deep: false });
+	(0, vue.onMounted)(() => {
+		if (!canUseDom) return;
+		window.addEventListener("popstate", read, { passive: true });
+	});
+	(0, vue.onUnmounted)(() => {
+		if (!canUseDom) return;
+		window.removeEventListener("popstate", read);
+	});
+	return state;
+};
+
+//#endregion
+//#region src/composables/useTags.ts
+const createTagsState = (posts) => {
+	const activeTag = useSyncedQueryParam({
+		key: "tag",
+		defaultValue: "",
+		parse: (raw) => raw || "",
+		serialize: (value) => value ? value : null
+	});
+	const tagsMap = (0, vue.computed)(() => {
+		const map = { "": posts.length };
+		posts.forEach((post) => {
+			const tags = post.frontmatter.tags;
+			if (tags) tags.forEach((tag) => {
+				map[tag] = (map[tag] || 0) + 1;
+			});
+		});
+		return map;
+	});
+	const getTagArray = () => {
+		const arr = Object.entries(tagsMap.value);
+		arr.sort((a, b) => b[1] - a[1]);
+		return arr;
+	};
+	const uniqueTagCount = (0, vue.computed)(() => {
+		const set = new Set();
+		Object.keys(tagsMap.value).forEach((k) => {
+			if (k) set.add(k);
+		});
+		return set.size;
+	});
+	const filterPostsByActiveTag = (tag) => {
+		const t = tag ?? activeTag.value;
+		if (!t) return posts;
+		return posts.filter((item) => item.frontmatter.tags && item.frontmatter.tags.includes(t));
+	};
+	return {
+		tagsMap,
+		activeTag,
+		getTagArray,
+		uniqueTagCount,
+		filterPostsByActiveTag
+	};
+};
+const createTagsStore = (posts) => {
+	let sharedState = null;
+	return () => {
+		if (!sharedState) sharedState = createTagsState(posts);
+		return sharedState;
+	};
+};
+
+//#endregion
+//#region src/composables/useCategories.ts
+const extractCategoryFromUrl = (url, otherLabel) => {
+	const match = url.match(/^\/posts\/([^/]+)\//);
+	if (match && match[1]) return match[1];
+	if (url.startsWith("/posts/") && /^\/posts\/[^/]+(\.html)?$/.test(url)) return otherLabel;
+	return "";
+};
+const createCategoriesState = (posts, otherLabel) => {
+	const otherLabelRef = (0, vue.ref)(otherLabel);
+	const activeCategory = useSyncedQueryParam({
+		key: "category",
+		defaultValue: "",
+		parse: (raw) => raw || "",
+		serialize: (value) => value ? value : null
+	});
+	const getPostCategory = (post) => {
+		const fmCategory = post.frontmatter?.category;
+		if (fmCategory) return fmCategory;
+		return extractCategoryFromUrl(post.url, otherLabelRef.value);
+	};
+	const categoriesMap = (0, vue.computed)(() => {
+		const map = { "": posts.length };
+		posts.forEach((post) => {
+			const category = getPostCategory(post);
+			if (category) map[category] = (map[category] || 0) + 1;
+		});
+		return map;
+	});
+	const getCategoryArray = () => {
+		const arr = Object.entries(categoriesMap.value);
+		arr.sort((a, b) => {
+			if (a[0] === "") return -1;
+			if (b[0] === "") return 1;
+			return b[1] - a[1];
+		});
+		return arr;
+	};
+	const uniqueCategoryCount = (0, vue.computed)(() => {
+		const set = new Set();
+		Object.keys(categoriesMap.value).forEach((k) => {
+			if (k) set.add(k);
+		});
+		return set.size;
+	});
+	const filterPostsByActiveCategory = (category) => {
+		const c = category ?? activeCategory.value;
+		if (!c) return posts;
+		return posts.filter((item) => getPostCategory(item) === c);
+	};
+	return {
+		categoriesMap,
+		activeCategory,
+		getCategoryArray,
+		uniqueCategoryCount,
+		filterPostsByActiveCategory,
+		getCategoryFromUrl: (url) => extractCategoryFromUrl(url, otherLabelRef.value),
+		updateOtherLabel: (label) => {
+			otherLabelRef.value = label;
+		}
+	};
+};
+const createCategoriesStore = (posts) => {
+	let sharedState = null;
+	return (options) => {
+		const otherLabel = options?.otherLabel || "Other";
+		if (!sharedState) sharedState = createCategoriesState(posts, otherLabel);
+		else if (options?.otherLabel) sharedState.updateOtherLabel(options.otherLabel);
+		return sharedState;
+	};
+};
+
+//#endregion
+//#region src/composables/usePagination.ts
+const usePagination = (items, options) => {
+	const pageParam = options.pageParam ?? "page";
+	const pageSize = (0, vue.computed)(() => typeof options.pageSize === "number" ? options.pageSize : options.pageSize.value);
+	const currentPage = useSyncedQueryParam({
+		key: pageParam,
+		defaultValue: 1,
+		parse: (raw) => {
+			const n = Number.parseInt(raw || "1", 10);
+			return Number.isFinite(n) && n > 0 ? n : 1;
+		},
+		serialize: (value) => value <= 1 ? null : String(value)
+	});
+	const totalPages = (0, vue.computed)(() => {
+		if (!items.value.length) return 0;
+		return Math.ceil(items.value.length / pageSize.value);
+	});
+	(0, vue.watch)(totalPages, (count) => {
+		if (count === 0) currentPage.value = 1;
+		else if (currentPage.value > count) currentPage.value = count;
+	}, { immediate: true });
+	const paginatedItems = (0, vue.computed)(() => {
+		const start = (currentPage.value - 1) * pageSize.value;
+		const end = start + pageSize.value;
+		return items.value.slice(start, end);
+	});
+	const pageRange = (0, vue.computed)(() => {
+		const count = totalPages.value;
+		if (count <= 1) return [];
+		const groupSize = Math.max(3, options.pageGroupSize || require_constants.DEFAULT_PAGE_GROUP_SIZE);
+		const half = Math.floor(groupSize / 2);
+		let start = Math.max(1, currentPage.value - half);
+		let end = Math.min(count, start + groupSize - 1);
+		start = Math.max(1, end - groupSize + 1);
+		const pages = [];
+		for (let i = start; i <= end; i++) pages.push(i);
+		return pages;
+	});
+	const setPage = (page) => {
+		const count = totalPages.value || 1;
+		const target = Math.min(Math.max(page, 1), count);
+		currentPage.value = target;
+	};
+	const nextPage = () => setPage(currentPage.value + 1);
+	const prevPage = () => setPage(currentPage.value - 1);
+	const jumpInput = (0, vue.ref)("");
+	const jumpToInput = () => {
+		const n = Number.parseInt(jumpInput.value, 10);
+		if (!Number.isFinite(n)) return;
+		setPage(n);
+	};
+	return {
+		currentPage,
+		totalPages,
+		pageRange,
+		paginatedItems,
+		setPage,
+		nextPage,
+		prevPage,
+		jumpInput,
+		jumpToInput
+	};
+};
+
+//#endregion
+exports.DEFAULT_PAGE_GROUP_SIZE = require_constants.DEFAULT_PAGE_GROUP_SIZE
+exports.DEFAULT_PAGE_SIZE = require_constants.DEFAULT_PAGE_SIZE
+exports.LOCALIZED_STRINGS = require_constants.LOCALIZED_STRINGS
+exports.MAX_DISPLAYED_TAGS = require_constants.MAX_DISPLAYED_TAGS
+exports.createCategoriesStore = createCategoriesStore
+exports.createTagsStore = createTagsStore
+exports.formatDate = require_date.formatDate
+exports.getLocalizedString = require_constants.getLocalizedString
+exports.parseDateValue = require_date.parseDateValue
+exports.usePagination = usePagination
+exports.useSyncedQueryParam = useSyncedQueryParam

package/dist/client.d.cts

@@ -0,0 +1,72 @@
+import { BlogFrontmatter, BlogPost, DEFAULT_PAGE_GROUP_SIZE, DEFAULT_PAGE_SIZE, LOCALIZED_STRINGS, MAX_DISPLAYED_TAGS, SupportedLanguage, formatDate, getLocalizedString, parseDateValue } from "./date-CCP55OAZ.cjs";
+import * as vue2 from "vue";
+import * as vue3 from "vue";
+import * as vue4 from "vue";
+import * as vue5 from "vue";
+import * as vue1 from "vue";
+import { ComputedRef } from "vue";
+
+//#region src/composables/useQueryParam.d.ts
+type Parser<T> = (raw: string | null) => T;
+type Serializer<T> = (value: T) => string | null;
+interface SyncedQueryParamOptions<T> {
+  key: string;
+  defaultValue: T;
+  parse?: Parser<T>;
+  serialize?: Serializer<T>;
+}
+declare const useSyncedQueryParam: <T>(options: SyncedQueryParamOptions<T>) => {
+  value: T;
+};
+
+//#endregion
+//#region src/composables/useTags.d.ts
+declare const createTagsStore: (posts: BlogPost[]) => () => {
+  readonly tagsMap: vue2.ComputedRef<Record<string, number>>;
+  readonly activeTag: {
+    value: string;
+  };
+  readonly getTagArray: () => [string, number][];
+  readonly uniqueTagCount: vue3.ComputedRef<number>;
+  readonly filterPostsByActiveTag: (tag?: string) => BlogPost[];
+};
+
+//#endregion
+//#region src/composables/useCategories.d.ts
+declare const createCategoriesStore: (posts: BlogPost[]) => (options?: {
+  otherLabel?: string;
+}) => {
+  readonly categoriesMap: vue4.ComputedRef<Record<string, number>>;
+  readonly activeCategory: {
+    value: string;
+  };
+  readonly getCategoryArray: () => [string, number][];
+  readonly uniqueCategoryCount: vue5.ComputedRef<number>;
+  readonly filterPostsByActiveCategory: (category?: string) => BlogPost[];
+  readonly getCategoryFromUrl: (url: string) => string;
+  readonly updateOtherLabel: (label: string) => void;
+};
+
+//#endregion
+//#region src/composables/usePagination.d.ts
+interface PaginationOptions {
+  pageSize: number | ComputedRef<number>;
+  pageGroupSize?: number;
+  pageParam?: string;
+}
+declare const usePagination: <T>(items: ComputedRef<T[]>, options: PaginationOptions) => {
+  readonly currentPage: {
+    value: number;
+  };
+  readonly totalPages: ComputedRef<number>;
+  readonly pageRange: ComputedRef<number[]>;
+  readonly paginatedItems: ComputedRef<T[]>;
+  readonly setPage: (page: number) => void;
+  readonly nextPage: () => void;
+  readonly prevPage: () => void;
+  readonly jumpInput: vue1.Ref<string, string>;
+  readonly jumpToInput: () => void;
+};
+
+//#endregion
+export { BlogFrontmatter, BlogPost, DEFAULT_PAGE_GROUP_SIZE, DEFAULT_PAGE_SIZE, LOCALIZED_STRINGS, MAX_DISPLAYED_TAGS, SupportedLanguage, createCategoriesStore, createTagsStore, formatDate, getLocalizedString, parseDateValue, usePagination, useSyncedQueryParam };

package/dist/client.d.ts

@@ -0,0 +1,72 @@
+import { BlogFrontmatter, BlogPost, DEFAULT_PAGE_GROUP_SIZE$1 as DEFAULT_PAGE_GROUP_SIZE, DEFAULT_PAGE_SIZE$1 as DEFAULT_PAGE_SIZE, LOCALIZED_STRINGS$1 as LOCALIZED_STRINGS, MAX_DISPLAYED_TAGS$1 as MAX_DISPLAYED_TAGS, SupportedLanguage, formatDate$1 as formatDate, getLocalizedString$1 as getLocalizedString, parseDateValue$1 as parseDateValue } from "./date-BySfVUhd.js";
+import * as vue1 from "vue";
+import * as vue2 from "vue";
+import * as vue4 from "vue";
+import * as vue5 from "vue";
+import * as vue3 from "vue";
+import { ComputedRef } from "vue";
+
+//#region src/composables/useQueryParam.d.ts
+type Parser<T> = (raw: string | null) => T;
+type Serializer<T> = (value: T) => string | null;
+interface SyncedQueryParamOptions<T> {
+  key: string;
+  defaultValue: T;
+  parse?: Parser<T>;
+  serialize?: Serializer<T>;
+}
+declare const useSyncedQueryParam: <T>(options: SyncedQueryParamOptions<T>) => {
+  value: T;
+};
+
+//#endregion
+//#region src/composables/useTags.d.ts
+declare const createTagsStore: (posts: BlogPost[]) => () => {
+  readonly tagsMap: vue1.ComputedRef<Record<string, number>>;
+  readonly activeTag: {
+    value: string;
+  };
+  readonly getTagArray: () => [string, number][];
+  readonly uniqueTagCount: vue2.ComputedRef<number>;
+  readonly filterPostsByActiveTag: (tag?: string) => BlogPost[];
+};
+
+//#endregion
+//#region src/composables/useCategories.d.ts
+declare const createCategoriesStore: (posts: BlogPost[]) => (options?: {
+  otherLabel?: string;
+}) => {
+  readonly categoriesMap: vue4.ComputedRef<Record<string, number>>;
+  readonly activeCategory: {
+    value: string;
+  };
+  readonly getCategoryArray: () => [string, number][];
+  readonly uniqueCategoryCount: vue5.ComputedRef<number>;
+  readonly filterPostsByActiveCategory: (category?: string) => BlogPost[];
+  readonly getCategoryFromUrl: (url: string) => string;
+  readonly updateOtherLabel: (label: string) => void;
+};
+
+//#endregion
+//#region src/composables/usePagination.d.ts
+interface PaginationOptions {
+  pageSize: number | ComputedRef<number>;
+  pageGroupSize?: number;
+  pageParam?: string;
+}
+declare const usePagination: <T>(items: ComputedRef<T[]>, options: PaginationOptions) => {
+  readonly currentPage: {
+    value: number;
+  };
+  readonly totalPages: ComputedRef<number>;
+  readonly pageRange: ComputedRef<number[]>;
+  readonly paginatedItems: ComputedRef<T[]>;
+  readonly setPage: (page: number) => void;
+  readonly nextPage: () => void;
+  readonly prevPage: () => void;
+  readonly jumpInput: vue3.Ref<string, string>;
+  readonly jumpToInput: () => void;
+};
+
+//#endregion
+export { BlogFrontmatter, BlogPost, DEFAULT_PAGE_GROUP_SIZE, DEFAULT_PAGE_SIZE, LOCALIZED_STRINGS, MAX_DISPLAYED_TAGS, SupportedLanguage, createCategoriesStore, createTagsStore, formatDate, getLocalizedString, parseDateValue, usePagination, useSyncedQueryParam };

package/dist/client.js

@@ -0,0 +1,249 @@
+import { DEFAULT_PAGE_GROUP_SIZE, DEFAULT_PAGE_SIZE, LOCALIZED_STRINGS, MAX_DISPLAYED_TAGS, getLocalizedString } from "./constants-Dc4Co5gF.js";
+import { formatDate, parseDateValue } from "./date-DAUKykKr.js";
+import { computed, onMounted, onUnmounted, ref, watch } from "vue";
+import { useRoute } from "vitepress/client";
+
+//#region src/utils/url.ts
+const isClient = typeof window !== "undefined";
+const getQueryParam = (key) => {
+	if (!isClient) return null;
+	const url = new URL(window.location.href);
+	return url.searchParams.get(key);
+};
+const setQueryParam = (key, value, options) => {
+	if (!isClient) return;
+	const url = new URL(window.location.href);
+	if (value === null || value === "") url.searchParams.delete(key);
+	else url.searchParams.set(key, value);
+	const replace = options?.replace ?? true;
+	if (replace) window.history.replaceState(null, "", url.toString());
+	else window.history.pushState(null, "", url.toString());
+};
+
+//#endregion
+//#region src/composables/useQueryParam.ts
+const useSyncedQueryParam = (options) => {
+	const { key, defaultValue, parse, serialize } = options;
+	const route = useRoute();
+	const state = ref(defaultValue);
+	const read = () => {
+		const raw = getQueryParam(key);
+		const next = parse ? parse(raw) : raw ?? defaultValue;
+		state.value = next;
+	};
+	const write = (value) => {
+		const current = getQueryParam(key);
+		const next = serialize ? serialize(value) : value === defaultValue ? null : String(value);
+		if (next === current || next === null && current === null) return;
+		setQueryParam(key, next, { replace: true });
+	};
+	const canUseDom = typeof window !== "undefined";
+	if (canUseDom) read();
+	watch(() => route.path, () => {
+		if (canUseDom) read();
+	});
+	watch(state, (value) => {
+		if (canUseDom) write(value);
+	}, { deep: false });
+	onMounted(() => {
+		if (!canUseDom) return;
+		window.addEventListener("popstate", read, { passive: true });
+	});
+	onUnmounted(() => {
+		if (!canUseDom) return;
+		window.removeEventListener("popstate", read);
+	});
+	return state;
+};
+
+//#endregion
+//#region src/composables/useTags.ts
+const createTagsState = (posts) => {
+	const activeTag = useSyncedQueryParam({
+		key: "tag",
+		defaultValue: "",
+		parse: (raw) => raw || "",
+		serialize: (value) => value ? value : null
+	});
+	const tagsMap = computed(() => {
+		const map = { "": posts.length };
+		posts.forEach((post) => {
+			const tags = post.frontmatter.tags;
+			if (tags) tags.forEach((tag) => {
+				map[tag] = (map[tag] || 0) + 1;
+			});
+		});
+		return map;
+	});
+	const getTagArray = () => {
+		const arr = Object.entries(tagsMap.value);
+		arr.sort((a, b) => b[1] - a[1]);
+		return arr;
+	};
+	const uniqueTagCount = computed(() => {
+		const set = new Set();
+		Object.keys(tagsMap.value).forEach((k) => {
+			if (k) set.add(k);
+		});
+		return set.size;
+	});
+	const filterPostsByActiveTag = (tag) => {
+		const t = tag ?? activeTag.value;
+		if (!t) return posts;
+		return posts.filter((item) => item.frontmatter.tags && item.frontmatter.tags.includes(t));
+	};
+	return {
+		tagsMap,
+		activeTag,
+		getTagArray,
+		uniqueTagCount,
+		filterPostsByActiveTag
+	};
+};
+const createTagsStore = (posts) => {
+	let sharedState = null;
+	return () => {
+		if (!sharedState) sharedState = createTagsState(posts);
+		return sharedState;
+	};
+};
+
+//#endregion
+//#region src/composables/useCategories.ts
+const extractCategoryFromUrl = (url, otherLabel) => {
+	const match = url.match(/^\/posts\/([^/]+)\//);
+	if (match && match[1]) return match[1];
+	if (url.startsWith("/posts/") && /^\/posts\/[^/]+(\.html)?$/.test(url)) return otherLabel;
+	return "";
+};
+const createCategoriesState = (posts, otherLabel) => {
+	const otherLabelRef = ref(otherLabel);
+	const activeCategory = useSyncedQueryParam({
+		key: "category",
+		defaultValue: "",
+		parse: (raw) => raw || "",
+		serialize: (value) => value ? value : null
+	});
+	const getPostCategory = (post) => {
+		const fmCategory = post.frontmatter?.category;
+		if (fmCategory) return fmCategory;
+		return extractCategoryFromUrl(post.url, otherLabelRef.value);
+	};
+	const categoriesMap = computed(() => {
+		const map = { "": posts.length };
+		posts.forEach((post) => {
+			const category = getPostCategory(post);
+			if (category) map[category] = (map[category] || 0) + 1;
+		});
+		return map;
+	});
+	const getCategoryArray = () => {
+		const arr = Object.entries(categoriesMap.value);
+		arr.sort((a, b) => {
+			if (a[0] === "") return -1;
+			if (b[0] === "") return 1;
+			return b[1] - a[1];
+		});
+		return arr;
+	};
+	const uniqueCategoryCount = computed(() => {
+		const set = new Set();
+		Object.keys(categoriesMap.value).forEach((k) => {
+			if (k) set.add(k);
+		});
+		return set.size;
+	});
+	const filterPostsByActiveCategory = (category) => {
+		const c = category ?? activeCategory.value;
+		if (!c) return posts;
+		return posts.filter((item) => getPostCategory(item) === c);
+	};
+	return {
+		categoriesMap,
+		activeCategory,
+		getCategoryArray,
+		uniqueCategoryCount,
+		filterPostsByActiveCategory,
+		getCategoryFromUrl: (url) => extractCategoryFromUrl(url, otherLabelRef.value),
+		updateOtherLabel: (label) => {
+			otherLabelRef.value = label;
+		}
+	};
+};
+const createCategoriesStore = (posts) => {
+	let sharedState = null;
+	return (options) => {
+		const otherLabel = options?.otherLabel || "Other";
+		if (!sharedState) sharedState = createCategoriesState(posts, otherLabel);
+		else if (options?.otherLabel) sharedState.updateOtherLabel(options.otherLabel);
+		return sharedState;
+	};
+};
+
+//#endregion
+//#region src/composables/usePagination.ts
+const usePagination = (items, options) => {
+	const pageParam = options.pageParam ?? "page";
+	const pageSize = computed(() => typeof options.pageSize === "number" ? options.pageSize : options.pageSize.value);
+	const currentPage = useSyncedQueryParam({
+		key: pageParam,
+		defaultValue: 1,
+		parse: (raw) => {
+			const n = Number.parseInt(raw || "1", 10);
+			return Number.isFinite(n) && n > 0 ? n : 1;
+		},
+		serialize: (value) => value <= 1 ? null : String(value)
+	});
+	const totalPages = computed(() => {
+		if (!items.value.length) return 0;
+		return Math.ceil(items.value.length / pageSize.value);
+	});
+	watch(totalPages, (count) => {
+		if (count === 0) currentPage.value = 1;
+		else if (currentPage.value > count) currentPage.value = count;
+	}, { immediate: true });
+	const paginatedItems = computed(() => {
+		const start = (currentPage.value - 1) * pageSize.value;
+		const end = start + pageSize.value;
+		return items.value.slice(start, end);
+	});
+	const pageRange = computed(() => {
+		const count = totalPages.value;
+		if (count <= 1) return [];
+		const groupSize = Math.max(3, options.pageGroupSize || DEFAULT_PAGE_GROUP_SIZE);
+		const half = Math.floor(groupSize / 2);
+		let start = Math.max(1, currentPage.value - half);
+		let end = Math.min(count, start + groupSize - 1);
+		start = Math.max(1, end - groupSize + 1);
+		const pages = [];
+		for (let i = start; i <= end; i++) pages.push(i);
+		return pages;
+	});
+	const setPage = (page) => {
+		const count = totalPages.value || 1;
+		const target = Math.min(Math.max(page, 1), count);
+		currentPage.value = target;
+	};
+	const nextPage = () => setPage(currentPage.value + 1);
+	const prevPage = () => setPage(currentPage.value - 1);
+	const jumpInput = ref("");
+	const jumpToInput = () => {
+		const n = Number.parseInt(jumpInput.value, 10);
+		if (!Number.isFinite(n)) return;
+		setPage(n);
+	};
+	return {
+		currentPage,
+		totalPages,
+		pageRange,
+		paginatedItems,
+		setPage,
+		nextPage,
+		prevPage,
+		jumpInput,
+		jumpToInput
+	};
+};
+
+//#endregion
+export { DEFAULT_PAGE_GROUP_SIZE, DEFAULT_PAGE_SIZE, LOCALIZED_STRINGS, MAX_DISPLAYED_TAGS, createCategoriesStore, createTagsStore, formatDate, getLocalizedString, parseDateValue, usePagination, useSyncedQueryParam };