@astra-kit/ui 0.0.0-stage → 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,71 @@
+/** Exposes shared UI without promoting server-safe exports into a client boundary. */
+export { useTheme } from "next-themes";
+export { Link, type LinkProps } from "./components/link.js";
+export { AstraUIProvider, type AstraUIProviderProps } from "./providers/native-provider.js";
+export type { AstraUIComponents, AstraImageProps, AstraLinkProps } from "./providers/astra-ui-provider.js";
+export * from "./components/action-button.js";
+export * from "./components/avatar.js";
+export * from "./components/badge.js";
+export * from "./components/button.js";
+export * from "./components/card.js";
+export * from "./components/carousel.js";
+export * from "./components/checkbox.js";
+export * from "./components/dialog.js";
+export * from "./components/dropdown-menu.js";
+export * from "./components/hover-card.js";
+export * from "./components/input.js";
+export * from "./components/pagination.js";
+export * from "./components/popover.js";
+export * from "./components/select.js";
+export * from "./components/separator.js";
+export * from "./components/sheet.js";
+export * from "./components/sidebar.js";
+export * from "./components/skeleton.js";
+export * from "./components/split-button.js";
+export * from "./components/switch.js";
+export * from "./components/table.js";
+export * from "./components/tabs.js";
+export * from "./components/textarea.js";
+export * from "./components/tooltip.js";
+export * from "./components/svgs/whatsappIcon.js";
+export * from "./lib/utils.js";
+export * from "./hooks/use-mobile.js";
+export * from "./constants/sidebar.js";
+export * from "./sonner.js";
+export * from "./components/alert.js";
+export * from "./components/animated-theme-toggler.js";
+export * from "./components/calendar.js";
+export * from "./components/data-table.js";
+export * from "./components/filter-query-bar.js";
+export * from "./components/filter-query-grammar.js";
+export * from "./components/form.js";
+export * from "./components/highlighter.js";
+export * from "./components/input-group.js";
+export * from "./components/label.js";
+export * from "./components/radio-group.js";
+export * from "./components/typing-animation.js";
+export * from "./components/themed-toaster.js";
+export * from "./theme.js";
+export * from "./lib/year-month-filter.js";
+export * from "./motion/tokens.js";
+export * from "./components/animated-collapse.js";
+export * from "./components/animated-count.js";
+export * from "./components/animated-list-item.js";
+export * from "./components/presence-swap.js";
+export * from "./components/progress-ring.js";
+export * from "./components/account-menu.js";
+export * from "./components/rich-text-content.js";
+export * from "./components/rich-markdown-content.js";
+export * from "./components/rich-link-editor.js";
+export * from "./components/reaction-button.js";
+export * from "./components/file-upload.js";
+export * from "./hooks/use-rich-link-editor.js";
+export * from "./lib/browser-clipboard.js";
+export * from "./lib/file-acceptance.js";
+export * from "./lib/format-file-size.js";
+export * from "./lib/fuzzy-search.js";
+export { parseRichTextSegments, normalizeMarkdownUrl, normalizeAutolinkUrl } from "./lib/rich-text/link-markdown.js";
+export { RICH_TEXT_SEGMENT_TYPE, RICH_LINK_KIND } from "./lib/rich-text/link-markdown-constants.js";
+export type { RichTextSegment, RichLink } from "./lib/rich-text/link-markdown-types.js";
+export * from "./lib/rich-text/rich-markdown.js";
+export * from "./components/filter-presets-bar.js";

package/dist/index.js

@@ -0,0 +1,69 @@
+/** Exposes shared UI without promoting server-safe exports into a client boundary. */
+export { useTheme } from "next-themes";
+export { Link } from "./components/link.js";
+export { AstraUIProvider } from "./providers/native-provider.js";
+export * from "./components/action-button.js";
+export * from "./components/avatar.js";
+export * from "./components/badge.js";
+export * from "./components/button.js";
+export * from "./components/card.js";
+export * from "./components/carousel.js";
+export * from "./components/checkbox.js";
+export * from "./components/dialog.js";
+export * from "./components/dropdown-menu.js";
+export * from "./components/hover-card.js";
+export * from "./components/input.js";
+export * from "./components/pagination.js";
+export * from "./components/popover.js";
+export * from "./components/select.js";
+export * from "./components/separator.js";
+export * from "./components/sheet.js";
+export * from "./components/sidebar.js";
+export * from "./components/skeleton.js";
+export * from "./components/split-button.js";
+export * from "./components/switch.js";
+export * from "./components/table.js";
+export * from "./components/tabs.js";
+export * from "./components/textarea.js";
+export * from "./components/tooltip.js";
+export * from "./components/svgs/whatsappIcon.js";
+export * from "./lib/utils.js";
+export * from "./hooks/use-mobile.js";
+export * from "./constants/sidebar.js";
+export * from "./sonner.js";
+export * from "./components/alert.js";
+export * from "./components/animated-theme-toggler.js";
+export * from "./components/calendar.js";
+export * from "./components/data-table.js";
+export * from "./components/filter-query-bar.js";
+export * from "./components/filter-query-grammar.js";
+export * from "./components/form.js";
+export * from "./components/highlighter.js";
+export * from "./components/input-group.js";
+export * from "./components/label.js";
+export * from "./components/radio-group.js";
+export * from "./components/typing-animation.js";
+export * from "./components/themed-toaster.js";
+export * from "./theme.js";
+export * from "./lib/year-month-filter.js";
+export * from "./motion/tokens.js";
+export * from "./components/animated-collapse.js";
+export * from "./components/animated-count.js";
+export * from "./components/animated-list-item.js";
+export * from "./components/presence-swap.js";
+export * from "./components/progress-ring.js";
+export * from "./components/account-menu.js";
+export * from "./components/rich-text-content.js";
+export * from "./components/rich-markdown-content.js";
+export * from "./components/rich-link-editor.js";
+export * from "./components/reaction-button.js";
+export * from "./components/file-upload.js";
+export * from "./hooks/use-rich-link-editor.js";
+export * from "./lib/browser-clipboard.js";
+export * from "./lib/file-acceptance.js";
+export * from "./lib/format-file-size.js";
+export * from "./lib/fuzzy-search.js";
+export { parseRichTextSegments, normalizeMarkdownUrl, normalizeAutolinkUrl } from "./lib/rich-text/link-markdown.js";
+export { RICH_TEXT_SEGMENT_TYPE, RICH_LINK_KIND } from "./lib/rich-text/link-markdown-constants.js";
+export * from "./lib/rich-text/rich-markdown.js";
+export * from "./components/filter-presets-bar.js";

package/dist/lib/browser-clipboard.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Browser clipboard adapter with feature detection. The async Clipboard API
+ * is preferred; when it is missing (older WebKit, insecure context) or
+ * rejects, a hidden textarea plus `document.execCommand("copy")` is tried,
+ * which WebKit still honours inside a user gesture.
+ */
+/**
+ * Copies text to the clipboard.
+ *
+ * @param text - Text to copy.
+ * @returns True when the text reached the clipboard.
+ */
+export declare function copyTextToClipboard(text: string): Promise<boolean>;

package/dist/lib/browser-clipboard.js

@@ -0,0 +1,48 @@
+/**
+* Browser clipboard adapter with feature detection. The async Clipboard API
+* is preferred; when it is missing (older WebKit, insecure context) or
+* rejects, a hidden textarea plus `document.execCommand("copy")` is tried,
+* which WebKit still honours inside a user gesture.
+*/
+const FALLBACK_COPY_COMMAND = "copy";
+const FALLBACK_TEXTAREA_TAG = "textarea";
+const FALLBACK_READONLY_ATTRIBUTE = "readonly";
+const OFFSCREEN_POSITION = "fixed";
+const OFFSCREEN_OFFSET = "-9999px";
+function copyWithSelectionFallback(text) {
+	if (typeof document.execCommand !== "function") {
+		return false;
+	}
+	const textarea = document.createElement(FALLBACK_TEXTAREA_TAG);
+	textarea.value = text;
+	textarea.setAttribute(FALLBACK_READONLY_ATTRIBUTE, "");
+	textarea.style.position = OFFSCREEN_POSITION;
+	textarea.style.top = OFFSCREEN_OFFSET;
+	document.body.appendChild(textarea);
+	textarea.select();
+	// iOS Safari needs an explicit range for read-only fields.
+	textarea.setSelectionRange(0, text.length);
+	try {
+		return document.execCommand(FALLBACK_COPY_COMMAND);
+	} catch {
+		// The legacy command can throw when copying is blocked; report failure.
+		return false;
+	} finally {
+		textarea.remove();
+	}
+}
+/**
+* Copies text to the clipboard.
+*
+* @param text - Text to copy.
+* @returns True when the text reached the clipboard.
+*/
+export async function copyTextToClipboard(text) {
+	if (typeof navigator !== "undefined" && navigator.clipboard?.writeText) {
+		try {
+			await navigator.clipboard.writeText(text);
+			return true;
+		} catch {}
+	}
+	return copyWithSelectionFallback(text);
+}

package/dist/lib/column-filter-value.d.ts

@@ -0,0 +1,12 @@
+/** Normalizes text for accent- and case-insensitive comparisons. */
+export declare function normalizeFilterToken(value: string): string;
+/**
+ * Evalúa el valor de una celda contra un filtro de columna de la barra de filtros.
+ * Entiende los valores estructurados (`numberRange`, `enum`, `presence`, `yearMonthRange`)
+ * y, para texto plano, busca coincidencias parciales sin distinguir acentos ni mayúsculas.
+ * Una celda sin valor comparable no cumple los rangos; un filtro vacío deja pasar la fila.
+ * @param cellValue - Valor de la celda tal como lo devuelve el accessor de la columna.
+ * @param filterValue - Valor activo del filtro de esa columna.
+ * @returns `true` cuando la fila debe mostrarse.
+ */
+export declare function matchesColumnFilterValue(cellValue: unknown, filterValue: unknown): boolean;

package/dist/lib/column-filter-value.js

@@ -0,0 +1,52 @@
+import { matchesAdvancedYearMonthRangeFilter } from "./year-month-filter.js";
+const DIACRITICS_PATTERN = /[̀-ͯ]/g;
+/** Normalizes text for accent- and case-insensitive comparisons. */
+export function normalizeFilterToken(value) {
+	return value.normalize("NFD").replace(DIACRITICS_PATTERN, "").toLocaleLowerCase().trim();
+}
+/** Distinguishes the grammar's structured values from plain text written by the search input. */
+function isColumnFilterValue(value) {
+	return typeof value === "object" && value !== null && typeof value.kind === "string";
+}
+/** Reads numbers and numeric strings; anything else has no comparable value. */
+function toFiniteNumber(value) {
+	if (typeof value === "number") return Number.isFinite(value) ? value : null;
+	if (typeof value === "string" && value.trim() !== "") {
+		const parsed = Number(value);
+		return Number.isFinite(parsed) ? parsed : null;
+	}
+	return null;
+}
+/** Treats `null`, `undefined`, blank strings and empty lists as a missing value. */
+function isMissingValue(value) {
+	if (value == null) return true;
+	if (typeof value === "string") return value.trim() === "";
+	if (Array.isArray(value)) return value.length === 0;
+	return false;
+}
+/**
+* Evalúa el valor de una celda contra un filtro de columna de la barra de filtros.
+* Entiende los valores estructurados (`numberRange`, `enum`, `presence`, `yearMonthRange`)
+* y, para texto plano, busca coincidencias parciales sin distinguir acentos ni mayúsculas.
+* Una celda sin valor comparable no cumple los rangos; un filtro vacío deja pasar la fila.
+* @param cellValue - Valor de la celda tal como lo devuelve el accessor de la columna.
+* @param filterValue - Valor activo del filtro de esa columna.
+* @returns `true` cuando la fila debe mostrarse.
+*/
+export function matchesColumnFilterValue(cellValue, filterValue) {
+	if (!isColumnFilterValue(filterValue)) {
+		const query = normalizeFilterToken(String(filterValue ?? ""));
+		return query === "" || normalizeFilterToken(String(cellValue ?? "")).includes(query);
+	}
+	switch (filterValue.kind) {
+		case "numberRange": {
+			const value = toFiniteNumber(cellValue);
+			if (value == null) return false;
+			if (filterValue.min != null && value < filterValue.min) return false;
+			return filterValue.max == null || value <= filterValue.max;
+		}
+		case "enum": return Array.isArray(cellValue) ? cellValue.some((item) => String(item) === filterValue.value) : String(cellValue ?? "") === filterValue.value;
+		case "presence": return filterValue.value === "hasValue" ? !isMissingValue(cellValue) : isMissingValue(cellValue);
+		case "yearMonthRange": return matchesAdvancedYearMonthRangeFilter(filterValue, toFiniteNumber(cellValue));
+	}
+}

package/dist/lib/file-acceptance.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Validates picked or dropped files against an `accept` list and a size limit, mirroring the
+ * native `<input accept>` syntax. Files without a MIME type (common on some Android pickers and
+ * drag sources) fall back to their extension.
+ */
+/** File metadata the checks need; a `File` satisfies it. */
+export interface AcceptableFile {
+    name: string;
+    type: string;
+    size: number;
+}
+/**
+ * Extracts the lowercase extension from a file name.
+ * @param fileName - The file name.
+ * @returns The extension with its leading dot, or null when there is none.
+ */
+export declare function getFileExtension(fileName: string): string | null;
+/**
+ * Tells whether a file matches an `accept` list such as `"image/*,.pdf"`.
+ * @param file - File to check.
+ * @param accept - Comma-separated extensions, exact MIME types or `type/*` wildcards; empty accepts all.
+ * @returns Whether the file is accepted.
+ */
+export declare function isFileTypeAccepted(file: AcceptableFile, accept?: string): boolean;
+export interface ClassifyFilesOptions {
+    accept?: string;
+    /** Maximum size in bytes; checked before the type. */
+    maxSize?: number;
+    /** When false, only the first file is considered. */
+    allowsMultiple?: boolean;
+}
+export interface ClassifiedFiles<TFile extends AcceptableFile> {
+    accepted: TFile[];
+    unaccepted: TFile[];
+    oversized: TFile[];
+}
+/**
+ * Splits files into accepted, wrong-type and oversized groups.
+ * @param files - Picked or dropped files.
+ * @param options - Accept list, size limit and multiplicity.
+ * @returns The three groups, preserving input order.
+ */
+export declare function classifyFiles<TFile extends AcceptableFile>(files: readonly TFile[], { accept, maxSize, allowsMultiple }?: ClassifyFilesOptions): ClassifiedFiles<TFile>;

package/dist/lib/file-acceptance.js

@@ -0,0 +1,107 @@
+/**
+* Validates picked or dropped files against an `accept` list and a size limit, mirroring the
+* native `<input accept>` syntax. Files without a MIME type (common on some Android pickers and
+* drag sources) fall back to their extension.
+*/
+const MIME_TYPE_EXTENSION_FALLBACKS = {
+	"application/pdf": [".pdf"],
+	"audio/mpeg": [".mp3"],
+	"image/gif": [".gif"],
+	"image/heic": [".heic"],
+	"image/heif": [".heif"],
+	"image/jpeg": [".jpg", ".jpeg"],
+	"image/png": [".png"],
+	"image/webp": [".webp"],
+	"text/plain": [".txt"],
+	"video/mp4": [".mp4"]
+};
+const WILDCARD_MIME_PREFIX_EXTENSION_FALLBACKS = {
+	audio: [
+		".aac",
+		".flac",
+		".m4a",
+		".mp3",
+		".ogg",
+		".wav"
+	],
+	image: [
+		".avif",
+		".bmp",
+		".gif",
+		".heic",
+		".heif",
+		".jpeg",
+		".jpg",
+		".png",
+		".svg",
+		".webp"
+	],
+	text: [
+		".csv",
+		".md",
+		".txt"
+	],
+	video: [
+		".avi",
+		".m4v",
+		".mov",
+		".mp4",
+		".mkv",
+		".webm"
+	]
+};
+const ACCEPT_LIST_SEPARATOR = ",";
+const EXTENSION_PREFIX = ".";
+const MIME_WILDCARD_SUFFIX = "/*";
+const MIME_TYPE_SEPARATOR = "/";
+/**
+* Extracts the lowercase extension from a file name.
+* @param fileName - The file name.
+* @returns The extension with its leading dot, or null when there is none.
+*/
+export function getFileExtension(fileName) {
+	const fileNameParts = fileName.split(EXTENSION_PREFIX);
+	const extension = fileNameParts.length > 1 ? fileNameParts.pop() : null;
+	return extension ? `${EXTENSION_PREFIX}${extension.toLowerCase()}` : null;
+}
+/**
+* Tells whether a file matches an `accept` list such as `"image/*,.pdf"`.
+* @param file - File to check.
+* @param accept - Comma-separated extensions, exact MIME types or `type/*` wildcards; empty accepts all.
+* @returns Whether the file is accepted.
+*/
+export function isFileTypeAccepted(file, accept) {
+	if (!accept) return true;
+	const fileExtension = getFileExtension(file.name);
+	const normalizedFileType = file.type.toLowerCase();
+	const hasMimeType = normalizedFileType.length > 0;
+	const extensionMatches = (candidateExtensions) => Boolean(fileExtension && candidateExtensions?.includes(fileExtension));
+	return accept.split(ACCEPT_LIST_SEPARATOR).map((acceptedType) => acceptedType.trim().toLowerCase()).filter(Boolean).some((acceptedType) => {
+		if (acceptedType.startsWith(EXTENSION_PREFIX)) return fileExtension === acceptedType;
+		if (acceptedType.endsWith(MIME_WILDCARD_SUFFIX)) {
+			const typePrefix = acceptedType.split(MIME_TYPE_SEPARATOR)[0];
+			return hasMimeType ? normalizedFileType.startsWith(`${typePrefix}${MIME_TYPE_SEPARATOR}`) : extensionMatches(WILDCARD_MIME_PREFIX_EXTENSION_FALLBACKS[typePrefix]);
+		}
+		return hasMimeType && normalizedFileType === acceptedType || extensionMatches(MIME_TYPE_EXTENSION_FALLBACKS[acceptedType]);
+	});
+}
+/**
+* Splits files into accepted, wrong-type and oversized groups.
+* @param files - Picked or dropped files.
+* @param options - Accept list, size limit and multiplicity.
+* @returns The three groups, preserving input order.
+*/
+export function classifyFiles(files, { accept, maxSize, allowsMultiple = true } = {}) {
+	const classifiedFiles = {
+		accepted: [],
+		unaccepted: [],
+		oversized: []
+	};
+	const filesToProcess = allowsMultiple ? files : files.slice(0, 1);
+	for (const file of filesToProcess) {
+		if (maxSize !== undefined && file.size > maxSize) classifiedFiles.oversized.push(file);
+		else if (isFileTypeAccepted(file, accept)) classifiedFiles.accepted.push(file);
+		else classifiedFiles.unaccepted.push(file);
+	}
+	return classifiedFiles;
+}

package/dist/lib/format-file-size.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Pure file-size formatting helper shared by attachment and upload UIs. Framework-safe:
+ * no React, no platform APIs beyond `Intl`, so it runs on the server and the client alike.
+ */
+export interface FormatFileSizeOptions {
+    /** BCP 47 locale used for the decimal separator. Defaults to `es-AR`. */
+    locale?: string;
+}
+/**
+ * Formats a byte count as a short human-readable size, e.g. `12,3 MB`, `850 KB`, `25 MB`.
+ *
+ * @param bytes - Raw size in bytes. Non-finite or negative values render as `0 B`.
+ * @param options - Optional locale for the number format.
+ * @returns The formatted size with its unit, separated by a space.
+ */
+export declare function formatFileSize(bytes: number, { locale }?: FormatFileSizeOptions): string;

package/dist/lib/format-file-size.js

@@ -0,0 +1,34 @@
+/**
+* Pure file-size formatting helper shared by attachment and upload UIs. Framework-safe:
+* no React, no platform APIs beyond `Intl`, so it runs on the server and the client alike.
+*/
+const BYTES_PER_UNIT_STEP = 1024;
+const FILE_SIZE_UNIT_LABELS = [
+	"B",
+	"KB",
+	"MB",
+	"GB",
+	"TB"
+];
+/** Spanish (Argentina) keeps the comma decimal separator of the original product copy. */
+const DEFAULT_FILE_SIZE_LOCALE = "es-AR";
+const SUB_UNIT_FRACTION_DIGITS = 0;
+const SCALED_UNIT_FRACTION_DIGITS = 1;
+/**
+* Formats a byte count as a short human-readable size, e.g. `12,3 MB`, `850 KB`, `25 MB`.
+*
+* @param bytes - Raw size in bytes. Non-finite or negative values render as `0 B`.
+* @param options - Optional locale for the number format.
+* @returns The formatted size with its unit, separated by a space.
+*/
+export function formatFileSize(bytes, { locale = DEFAULT_FILE_SIZE_LOCALE } = {}) {
+	const safeBytes = Number.isFinite(bytes) && bytes > 0 ? bytes : 0;
+	let scaledValue = safeBytes;
+	let unitIndex = 0;
+	while (scaledValue >= BYTES_PER_UNIT_STEP && unitIndex < FILE_SIZE_UNIT_LABELS.length - 1) {
+		scaledValue /= BYTES_PER_UNIT_STEP;
+		unitIndex += 1;
+	}
+	const formattedValue = new Intl.NumberFormat(locale, { maximumFractionDigits: unitIndex === 0 ? SUB_UNIT_FRACTION_DIGITS : SCALED_UNIT_FRACTION_DIGITS }).format(scaledValue);
+	return `${formattedValue} ${FILE_SIZE_UNIT_LABELS[unitIndex]}`;
+}

package/dist/lib/fuzzy-search.d.ts

@@ -0,0 +1,17 @@
+/** Ranks and highlights fuzzy text matches, ignoring case and diacritics, for pickers and search lists. */
+import type { ReactNode } from "react";
+export interface FuzzyMatchRank {
+    contiguousPairCount: number;
+    gapCount: number;
+    longestRun: number;
+    matchedChars: number;
+    maxGap: number;
+    span: number;
+    startIndex: number;
+}
+export declare function compareFuzzyMatchRank(leftRank: FuzzyMatchRank, rightRank: FuzzyMatchRank): number;
+export declare function normalizeSearchValue(value: string): string;
+export declare function getExactMatchIndices(value: string, query: string): number[] | null;
+export declare function getFuzzyMatchIndices(value: string, query: string): number[] | null;
+export declare function getFuzzyMatchRank(value: string, query: string): FuzzyMatchRank | null;
+export declare function renderHighlightedText(value: string, matchedIndices: number[], highlightClassName: string, keyPrefix: string): ReactNode;

package/dist/lib/fuzzy-search.js

@@ -0,0 +1,183 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+const DIACRITICS_PATTERN = /[\u0300-\u036f]/g;
+export function compareFuzzyMatchRank(leftRank, rightRank) {
+	if (leftRank.longestRun !== rightRank.longestRun) {
+		return rightRank.longestRun - leftRank.longestRun;
+	}
+	if (leftRank.contiguousPairCount !== rightRank.contiguousPairCount) {
+		return rightRank.contiguousPairCount - leftRank.contiguousPairCount;
+	}
+	if (leftRank.gapCount !== rightRank.gapCount) {
+		return leftRank.gapCount - rightRank.gapCount;
+	}
+	if (leftRank.maxGap !== rightRank.maxGap) {
+		return leftRank.maxGap - rightRank.maxGap;
+	}
+	if (leftRank.span !== rightRank.span) {
+		return leftRank.span - rightRank.span;
+	}
+	if (leftRank.startIndex !== rightRank.startIndex) {
+		return leftRank.startIndex - rightRank.startIndex;
+	}
+	return 0;
+}
+export function normalizeSearchValue(value) {
+	return value.normalize("NFD").replace(DIACRITICS_PATTERN, "").toLocaleLowerCase();
+}
+function getSearchCharsWithSourceIndices(value) {
+	const chars = [];
+	for (let index = 0; index < value.length; index += 1) {
+		const normalizedChar = normalizeSearchValue(value[index]);
+		if (!normalizedChar) {
+			continue;
+		}
+		for (const char of normalizedChar) {
+			chars.push({
+				char,
+				sourceIndex: index
+			});
+		}
+	}
+	return chars;
+}
+export function getExactMatchIndices(value, query) {
+	const normalizedQuery = normalizeSearchValue(query).trim();
+	if (!normalizedQuery) {
+		return [];
+	}
+	const valueChars = getSearchCharsWithSourceIndices(value);
+	const queryChars = Array.from(normalizedQuery);
+	if (queryChars.length > valueChars.length) {
+		return null;
+	}
+	for (let valueIndex = 0; valueIndex <= valueChars.length - queryChars.length; valueIndex += 1) {
+		let isExactMatch = true;
+		for (let queryIndex = 0; queryIndex < queryChars.length; queryIndex += 1) {
+			if (valueChars[valueIndex + queryIndex].char !== queryChars[queryIndex]) {
+				isExactMatch = false;
+				break;
+			}
+		}
+		if (!isExactMatch) {
+			continue;
+		}
+		const matchStartSourceIndex = valueChars[valueIndex].sourceIndex;
+		const matchEndSourceIndex = valueChars[valueIndex + queryChars.length - 1].sourceIndex;
+		return Array.from({ length: matchEndSourceIndex - matchStartSourceIndex + 1 }, (_, index) => matchStartSourceIndex + index);
+	}
+	return null;
+}
+export function getFuzzyMatchIndices(value, query) {
+	const normalizedQuery = normalizeSearchValue(query).trim();
+	if (!normalizedQuery) {
+		return [];
+	}
+	const valueChars = getSearchCharsWithSourceIndices(value);
+	const queryChars = Array.from(normalizedQuery);
+	const matchedIndices = [];
+	let valueCursor = 0;
+	for (const queryChar of queryChars) {
+		let foundAt = -1;
+		for (let index = valueCursor; index < valueChars.length; index += 1) {
+			if (valueChars[index].char === queryChar) {
+				foundAt = index;
+				break;
+			}
+		}
+		if (foundAt === -1) {
+			return null;
+		}
+		matchedIndices.push(valueChars[foundAt].sourceIndex);
+		valueCursor = foundAt + 1;
+	}
+	return Array.from(new Set(matchedIndices));
+}
+export function getFuzzyMatchRank(value, query) {
+	const normalizedQuery = normalizeSearchValue(query).trim();
+	if (!normalizedQuery) {
+		return null;
+	}
+	const valueChars = getSearchCharsWithSourceIndices(value);
+	const queryChars = Array.from(normalizedQuery);
+	const matchedSourceIndices = [];
+	let valueCursor = 0;
+	for (const queryChar of queryChars) {
+		let foundAt = -1;
+		for (let index = valueCursor; index < valueChars.length; index += 1) {
+			if (valueChars[index].char === queryChar) {
+				foundAt = index;
+				break;
+			}
+		}
+		if (foundAt === -1) {
+			return null;
+		}
+		matchedSourceIndices.push(valueChars[foundAt].sourceIndex);
+		valueCursor = foundAt + 1;
+	}
+	const startIndex = matchedSourceIndices[0] ?? 0;
+	const endIndex = matchedSourceIndices[matchedSourceIndices.length - 1] ?? startIndex;
+	let contiguousPairCount = 0;
+	let gapCount = 0;
+	let longestRun = matchedSourceIndices.length > 0 ? 1 : 0;
+	let maxGap = 0;
+	let currentRun = matchedSourceIndices.length > 0 ? 1 : 0;
+	for (let index = 1; index < matchedSourceIndices.length; index += 1) {
+		if (matchedSourceIndices[index] === matchedSourceIndices[index - 1] + 1) {
+			contiguousPairCount += 1;
+			currentRun += 1;
+		} else {
+			currentRun = 1;
+		}
+		if (currentRun > longestRun) {
+			longestRun = currentRun;
+		}
+		const gap = Math.max(matchedSourceIndices[index] - matchedSourceIndices[index - 1] - 1, 0);
+		gapCount += gap;
+		if (gap > maxGap) {
+			maxGap = gap;
+		}
+	}
+	return {
+		contiguousPairCount,
+		gapCount,
+		longestRun,
+		matchedChars: queryChars.length,
+		maxGap,
+		span: Math.max(endIndex - startIndex, 0),
+		startIndex
+	};
+}
+export function renderHighlightedText(value, matchedIndices, highlightClassName, keyPrefix) {
+	if (matchedIndices.length === 0) {
+		return value;
+	}
+	const matchedIndexSet = new Set(matchedIndices);
+	const highlightedParts = [];
+	let currentStart = 0;
+	let partIndex = 0;
+	for (let index = 0; index < value.length; index += 1) {
+		if (!matchedIndexSet.has(index)) {
+			continue;
+		}
+		if (currentStart < index) {
+			highlightedParts.push(/* @__PURE__ */ _jsx("span", { children: value.slice(currentStart, index) }, `${keyPrefix}-text-${partIndex}`));
+			partIndex += 1;
+		}
+		let matchEnd = index + 1;
+		while (matchEnd < value.length && matchedIndexSet.has(matchEnd)) {
+			matchEnd += 1;
+		}
+		highlightedParts.push(/* @__PURE__ */ _jsx("mark", {
+			className: highlightClassName,
+			children: value.slice(index, matchEnd)
+		}, `${keyPrefix}-match-${partIndex}`));
+		partIndex += 1;
+		currentStart = matchEnd;
+		index = matchEnd - 1;
+	}
+	if (currentStart < value.length) {
+		highlightedParts.push(/* @__PURE__ */ _jsx("span", { children: value.slice(currentStart) }, `${keyPrefix}-text-${partIndex}`));
+	}
+	return /* @__PURE__ */ _jsx("span", { children: highlightedParts }, `${keyPrefix}-highlighted`);
+}