nucleus-core-ts 0.9.883 → 0.9.885

package/dist/.build-ok

@@ -1 +1 @@
-0.9.883
+0.9.885

package/dist/fe/components/ChatPanel/components/ChatPanel.js

@@ -130,6 +130,7 @@ export function ChatPanel(props) {
                         currentUserId: props.currentUserId,
                         theme: theme,
                         isCreating: props.actions.createConversation.state.isPending,
+                        labels: props.labels,
                         onClose: ()=>setPickerOpen(false),
                         onStartDirect: handleStartDirect
                     }),

package/dist/fe/components/ChatPanel/components/NewConversationModal.d.ts

@@ -1,4 +1,5 @@
 import { type ReactElement } from 'react';
+import { type ChatPanelLabels } from '../labels';
 import type { ChatPanelTheme } from '../theme';
 import type { ChatDirectoryUser } from '../types';
 type NewConversationModalProps = {
@@ -7,11 +8,9 @@ type NewConversationModalProps = {
     currentUserId: string;
     theme: ChatPanelTheme;
     isCreating: boolean;
-    title?: string;
-    searchPlaceholder?: string;
-    emptyLabel?: string;
+    labels?: Partial<ChatPanelLabels>;
     onClose: () => void;
     onStartDirect: (userId: string) => void;
 };
-export declare function NewConversationModal({ open, directory, currentUserId, theme, isCreating, title, searchPlaceholder, emptyLabel, onClose, onStartDirect, }: NewConversationModalProps): ReactElement | null;
+export declare function NewConversationModal({ open, directory, currentUserId, theme, isCreating, labels: labelOverrides, onClose, onStartDirect, }: NewConversationModalProps): ReactElement | null;
 export {};

package/dist/fe/components/ChatPanel/components/NewConversationModal.js

@@ -2,18 +2,29 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useState } from 'react';
 import { cn } from '../../../utils/cn';
+import { matchesQuery } from '../../../utils/searchFold';
 import { initialsOf } from '../helpers';
-export function NewConversationModal({ open, directory, currentUserId, theme, isCreating, title = 'New message', searchPlaceholder = 'Search people...', emptyLabel = 'No people found', onClose, onStartDirect }) {
+import { DEFAULT_CHAT_LABELS } from '../labels';
+export function NewConversationModal({ open, directory, currentUserId, theme, isCreating, labels: labelOverrides, onClose, onStartDirect }) {
     const [query, setQuery] = useState('');
+    const labels = {
+        ...DEFAULT_CHAT_LABELS,
+        ...labelOverrides
+    };
     if (!open) return null;
-    const normalized = query.trim().toLowerCase();
-    const people = directory.filter((person)=>person.userId !== currentUserId).filter((person)=>normalized ? person.name.toLowerCase().includes(normalized) || (person.subtitle?.toLowerCase().includes(normalized) ?? false) : true);
+    // Folded, not lower-cased. A directory exported from a personnel system
+    // arrives in capitals, and `İSMAİL`.toLowerCase() is an `i` followed by a
+    // combining dot — so typing `ismail` used to find nobody at all.
+    const people = directory.filter((person)=>person.userId !== currentUserId).filter((person)=>matchesQuery(query, [
+            person.name,
+            person.subtitle
+        ]));
     return /*#__PURE__*/ _jsxs("div", {
         className: theme.picker.overlay,
         children: [
             /*#__PURE__*/ _jsx("button", {
                 type: "button",
-                "aria-label": "Close",
+                "aria-label": labels.close,
                 className: "absolute inset-0 h-full w-full cursor-default",
                 onClick: onClose
             }),
@@ -21,20 +32,20 @@ export function NewConversationModal({ open, directory, currentUserId, theme, is
                 className: cn('relative', theme.picker.panel),
                 role: "dialog",
                 "aria-modal": "true",
-                "aria-label": title,
+                "aria-label": labels.newMessageTitle,
                 children: [
                     /*#__PURE__*/ _jsxs("div", {
                         className: theme.picker.header,
                         children: [
                             /*#__PURE__*/ _jsx("span", {
                                 className: theme.picker.title,
-                                children: title
+                                children: labels.newMessageTitle
                             }),
                             /*#__PURE__*/ _jsx("button", {
                                 type: "button",
                                 className: theme.picker.closeButton,
                                 onClick: onClose,
-                                "aria-label": "Close",
+                                "aria-label": labels.close,
                                 children: /*#__PURE__*/ _jsxs("svg", {
                                     className: "h-4 w-4",
                                     fill: "none",
@@ -42,7 +53,7 @@ export function NewConversationModal({ open, directory, currentUserId, theme, is
                                     stroke: "currentColor",
                                     children: [
                                         /*#__PURE__*/ _jsx("title", {
-                                            children: "Close"
+                                            children: labels.close
                                         }),
                                         /*#__PURE__*/ _jsx("path", {
                                             strokeLinecap: "round",
@@ -60,7 +71,7 @@ export function NewConversationModal({ open, directory, currentUserId, theme, is
                         children: /*#__PURE__*/ _jsx("input", {
                             type: "text",
                             className: theme.picker.search,
-                            placeholder: searchPlaceholder,
+                            placeholder: labels.searchPeople,
                             value: query,
                             onChange: (event)=>setQuery(event.target.value)
                         })
@@ -69,7 +80,7 @@ export function NewConversationModal({ open, directory, currentUserId, theme, is
                         className: theme.picker.list,
                         children: people.length === 0 ? /*#__PURE__*/ _jsx("div", {
                             className: theme.picker.empty,
-                            children: emptyLabel
+                            children: labels.noPeopleFound
                         }) : people.map((person)=>/*#__PURE__*/ _jsxs("button", {
                                 type: "button",
                                 className: theme.picker.item,

package/dist/fe/components/ChatPanel/labels.d.ts

@@ -28,5 +28,13 @@ export type ChatPanelLabels = {
     removeFile: string;
     newConversation: string;
     close: string;
+    /**
+     * The people-picker that opens from `newConversation`. Its three strings were
+     * props on the modal and on nothing else, so a portal could translate the
+     * button that opens it and not a word inside it.
+     */
+    newMessageTitle: string;
+    searchPeople: string;
+    noPeopleFound: string;
 };
 export declare const DEFAULT_CHAT_LABELS: ChatPanelLabels;

package/dist/fe/components/ChatPanel/labels.js

@@ -20,5 +20,8 @@
     attachFiles: 'Attach files',
     removeFile: 'Remove file',
     newConversation: 'New conversation',
-    close: 'Close'
+    close: 'Close',
+    newMessageTitle: 'New message',
+    searchPeople: 'Search people...',
+    noPeopleFound: 'No people found'
 };

package/dist/fe/components/ForgotPasswordPage/components/ForgotPasswordForm.js

@@ -56,7 +56,7 @@ export function ForgotPasswordForm({ labels, forgotPasswordAction, onBackToLogin
     const handleSubmit = contextSafe((e)=>{
         e.preventDefault();
         if (!store.email) {
-            store.setError('Please enter your email address');
+            store.setError(say.emailRequired);
             shakeForm();
             return;
         }
@@ -197,7 +197,7 @@ export function ForgotPasswordForm({ labels, forgotPasswordAction, onBackToLogin
                             fullWidth: true,
                             loading: isLoading,
                             disabled: isLoading,
-                            children: "Send Reset Link"
+                            children: say.submit
                         })
                     }),
                     /*#__PURE__*/ _jsx("div", {

package/dist/fe/components/ForgotPasswordPage/labels.d.ts

@@ -15,5 +15,9 @@ export type ForgotPasswordLabels = {
     sentTo: string;
     backToLogin: string;
     pageLabel: string;
+    /** The button that sends the link. */
+    submit: string;
+    /** Said when the box is empty. */
+    emailRequired: string;
 };
 export declare const DEFAULT_FORGOT_PASSWORD_LABELS: ForgotPasswordLabels;

package/dist/fe/components/ForgotPasswordPage/labels.js

@@ -12,5 +12,7 @@
     checkYourEmail: 'Check your email',
     sentTo: "We've sent a password reset link to {email}. Please check your inbox and follow the instructions.",
     backToLogin: 'Back to login',
-    pageLabel: 'Forgot password page'
+    pageLabel: 'Forgot password page',
+    submit: 'Send Reset Link',
+    emailRequired: 'Please enter your email address'
 };

package/dist/fe/components/ResetPasswordPage/components/ResetPasswordForm.js

@@ -95,28 +95,28 @@ export function ResetPasswordForm({ labels, token, resetPasswordAction, onBackTo
         if (policy.requireUppercase) {
             reqs.push({
                 key: 'uppercase',
-                label: 'One uppercase letter',
+                label: say.ruleUppercase,
                 test: (p)=>/[A-Z]/.test(p)
             });
         }
         if (policy.requireLowercase) {
             reqs.push({
                 key: 'lowercase',
-                label: 'One lowercase letter',
+                label: say.ruleLowercase,
                 test: (p)=>/[a-z]/.test(p)
             });
         }
         if (policy.requireNumber) {
             reqs.push({
                 key: 'number',
-                label: 'One number',
+                label: say.ruleNumber,
                 test: (p)=>/\d/.test(p)
             });
         }
         if (policy.requireSpecialChar) {
             reqs.push({
                 key: 'special',
-                label: 'One special character',
+                label: say.ruleSpecial,
                 test: (p)=>{
                     const escapedChars = policy.specialChars.replace(/[-[\]{}()*+?.,\\^$|#\s]/g, '\\$&');
                     return new RegExp(`[${escapedChars}]`).test(p);
@@ -139,18 +139,18 @@ export function ResetPasswordForm({ labels, token, resetPasswordAction, onBackTo
     const handleSubmit = contextSafe((e)=>{
         e.preventDefault();
         if (!store.newPassword || !store.confirmPassword) {
-            store.setError('Please fill in all fields');
+            store.setError(say.fillAllFields);
             shakeForm();
             return;
         }
         if (store.newPassword !== store.confirmPassword) {
-            store.setError('Passwords do not match');
+            store.setError(say.passwordsDoNotMatch);
             shakeForm();
             return;
         }
         const allRequirementsMet = passwordRequirements.every((req)=>req.test(store.newPassword));
         if (!allRequirementsMet) {
-            store.setError('Password does not meet all requirements');
+            store.setError(say.requirementsNotMet);
             shakeForm();
             return;
         }

package/dist/fe/components/ResetPasswordPage/labels.d.ts

@@ -10,5 +10,14 @@ export type ResetPasswordLabels = {
     success: string;
     backToLogin: string;
     pageLabel: string;
+    /** The rules listed under the box, one line each. */
+    ruleUppercase: string;
+    ruleLowercase: string;
+    ruleNumber: string;
+    ruleSpecial: string;
+    /** Said when something is wrong, at the moment it is wrong. */
+    fillAllFields: string;
+    passwordsDoNotMatch: string;
+    requirementsNotMet: string;
 };
 export declare const DEFAULT_RESET_PASSWORD_LABELS: ResetPasswordLabels;

package/dist/fe/components/ResetPasswordPage/labels.js

@@ -8,5 +8,12 @@
     passwordRequirements: 'Password requirements:',
     success: 'Password Reset Successful',
     backToLogin: 'Back to login',
-    pageLabel: 'Reset password page'
+    pageLabel: 'Reset password page',
+    ruleUppercase: 'One uppercase letter',
+    ruleLowercase: 'One lowercase letter',
+    ruleNumber: 'One number',
+    ruleSpecial: 'One special character',
+    fillAllFields: 'Please fill in all fields',
+    passwordsDoNotMatch: 'Passwords do not match',
+    requirementsNotMet: 'Password does not meet all requirements'
 };

package/dist/fe/components/SelectBox/components/SelectBox.js

@@ -3,6 +3,7 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
 import { useGSAP } from '@gsap/react';
 import gsap from 'gsap';
 import { useEffect, useRef, useState } from 'react';
+import { matchesQuery } from '../../../utils/searchFold';
 import { selectBoxTheme } from '../theme';
 import { cn } from '../utils/cn';
 import { SelectDropdown } from './SelectDropdown';
@@ -23,7 +24,13 @@ export function SelectBox({ options, value: controlledValue, defaultValue, place
     const value = controlledValue !== undefined ? controlledValue : internalValue;
     const isControlled = controlledValue !== undefined;
     const selectedOption = options.find((opt)=>opt.value === value);
-    const filteredOptions = searchable && searchQuery ? options.filter((opt)=>opt.label.toLowerCase().includes(searchQuery.toLowerCase())) : options;
+    // Folded rather than lower-cased: the labels in these dropdowns are whatever
+    // language the install runs in, and a plain `toLowerCase()` cannot match
+    // `Şube` to `sube` or `İzmir` to `izmir` — which is every second option in a
+    // Turkish portal.
+    const filteredOptions = searchable && searchQuery ? options.filter((opt)=>matchesQuery(searchQuery, [
+            opt.label
+        ])) : options;
     const calculatePosition = ()=>{
         if (position !== 'auto') {
             setDropdownPosition(position);

package/dist/fe/components/SetPasswordPage/components/SetPasswordForm.js

@@ -19,7 +19,7 @@ export function SetPasswordForm({ labels, passwordChangeAction, passwordSetActio
     const activeAction = isInvite && passwordSetAction ? passwordSetAction : passwordChangeAction;
     const validateForm = ()=>{
         if (!store.newPassword) {
-            return 'Password is required';
+            return say.passwordRequired;
         }
         if (store.newPassword.length < policy.minLength) {
             return `Password must be at least ${policy.minLength} characters`;
@@ -34,7 +34,7 @@ export function SetPasswordForm({ labels, passwordChangeAction, passwordSetActio
             return 'Password must contain at least one lowercase letter';
         }
         if (policy.requireNumber && !/[0-9]/.test(store.newPassword)) {
-            return 'Password must contain at least one number';
+            return say.passwordNeedsNumber;
         }
         if (policy.requireSpecialChar) {
             const specialCharsRegex = new RegExp(`[${policy.specialChars.replace(/[-[\]{}()*+?.,\\^$|#\s]/g, '\\$&')}]`);
@@ -43,10 +43,10 @@ export function SetPasswordForm({ labels, passwordChangeAction, passwordSetActio
             }
         }
         if (!store.confirmPassword) {
-            return 'Please confirm your password';
+            return say.confirmRequired;
         }
         if (store.newPassword !== store.confirmPassword) {
-            return 'Passwords do not match';
+            return say.passwordsDoNotMatch;
         }
         return null;
     };
@@ -59,7 +59,7 @@ export function SetPasswordForm({ labels, passwordChangeAction, passwordSetActio
         }
         store.setError(null);
         if (!activeAction) {
-            store.setError('No action configured');
+            store.setError(say.noActionConfigured);
             return;
         }
         const onAfterHandle = ()=>{
@@ -71,7 +71,7 @@ export function SetPasswordForm({ labels, passwordChangeAction, passwordSetActio
             }
         };
         const onErrorHandle = (error)=>{
-            store.setError(error?.message || 'Failed to set password');
+            store.setError(error?.message || say.failed);
         };
         if (isInvite && passwordSetAction && store.userId) {
             passwordSetAction.start({

package/dist/fe/components/SetPasswordPage/labels.d.ts

@@ -21,5 +21,12 @@ export type SetPasswordLabels = {
     passwordStrength: string;
     passwordRequirements: string;
     pageLabel: string;
+    /** Said when something is wrong, at the moment it is wrong. */
+    passwordRequired: string;
+    passwordNeedsNumber: string;
+    confirmRequired: string;
+    passwordsDoNotMatch: string;
+    noActionConfigured: string;
+    failed: string;
 };
 export declare const DEFAULT_SET_PASSWORD_LABELS: SetPasswordLabels;

package/dist/fe/components/SetPasswordPage/labels.js

@@ -19,5 +19,11 @@
     confirmPasswordPlaceholder: 'Confirm your new password',
     passwordStrength: 'Password strength',
     passwordRequirements: 'Password requirements',
-    pageLabel: 'Set password page'
+    pageLabel: 'Set password page',
+    passwordRequired: 'Password is required',
+    passwordNeedsNumber: 'Password must contain at least one number',
+    confirmRequired: 'Please confirm your password',
+    passwordsDoNotMatch: 'Passwords do not match',
+    noActionConfigured: 'No action configured',
+    failed: 'Failed to set password'
 };

package/dist/fe/components/UsersPage/components/RoleAssignmentModal.js

@@ -3,6 +3,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useEffect, useRef, useState } from 'react';
 import { createPortal } from 'react-dom';
 import { cn } from '../../../utils/cn';
+import { matchesQuery } from '../../../utils/searchFold';
 export function RoleAssignmentModal({ isOpen, roles, userRoles, userId, onClose, onAssignRole, onRemoveRole }) {
     const modalRef = useRef(null);
     const [searchQuery, setSearchQuery] = useState('');
@@ -37,7 +38,11 @@ export function RoleAssignmentModal({ isOpen, roles, userRoles, userId, onClose,
     ]);
     if (!isOpen || !mounted) return null;
     const assignedRoleIds = userRoles.filter((ur)=>ur.userId === userId).map((ur)=>ur.roleId);
-    const filteredRoles = roles.filter((role)=>role.name.toLowerCase().includes(searchQuery.toLowerCase()));
+    // Role names are written in the portal's own language, so the query is
+    // folded rather than lower-cased.
+    const filteredRoles = roles.filter((role)=>matchesQuery(searchQuery, [
+            role.name
+        ]));
     const handleToggleRole = (role)=>{
         const isAssigned = assignedRoleIds.includes(role.id);
         if (isAssigned) {

package/dist/fe/components/UsersPage/components/UsersPage.js

@@ -4,6 +4,7 @@ import { useGSAP } from '@gsap/react';
 import gsap from 'gsap';
 import { useEffect, useEffectEvent, useRef, useState } from 'react';
 import { cn } from '../../../utils/cn';
+import { matchesQuery } from '../../../utils/searchFold';
 import { Button } from '../../Button';
 import { useUsersStore } from '../store';
 import { usersPageTheme } from '../theme';
@@ -353,8 +354,13 @@ export function UsersPage({ title = 'User Management', subtitle, className, them
     };
     const filteredUsers = store.users.filter((user)=>{
         const profile = store.profiles.find((p)=>p.userId === user.id);
-        const displayName = profile?.firstName || profile?.lastName ? `${profile.firstName || ''} ${profile.lastName || ''}`.toLowerCase() : '';
-        const matchesSearch = store.searchQuery === '' || (user.email ?? '').toLowerCase().includes(store.searchQuery.toLowerCase()) || displayName.includes(store.searchQuery.toLowerCase());
+        // People's names, so the comparison is folded: a roster written `İSMAİL`
+        // has to answer to `ismail`, which lower-casing alone never manages.
+        const matchesSearch = matchesQuery(store.searchQuery, [
+            user.email,
+            profile?.firstName,
+            profile?.lastName
+        ]);
         const matchesStatus = store.statusFilter === 'all' || store.statusFilter === 'locked' && user.isLocked || store.statusFilter === 'active' && !user.isLocked && user.verifiedAt || store.statusFilter === 'unverified' && !user.verifiedAt;
         const matchesRole = store.roleFilter === 'all' || store.userRoles.some((ur)=>ur.userId === user.id && ur.roleId === store.roleFilter);
         return matchesSearch && matchesStatus && matchesRole;

package/dist/fe/index.d.ts

@@ -60,5 +60,6 @@ export type { PubSubConfig, PubSubConnectionState, PubSubEvent } from './hooks/u
 export { usePubSub, usePubSubStore } from './hooks/usePubSub';
 export type { BulkDeleteResponse, ColumnConfig, ColumnEnum, ColumnReference, ColumnType, ColumnValidation, DeleteResponse, FieldConfig, FilterCondition, ListResponse, MutationResponse, NucleusColumn, NucleusEntity, NucleusEntityShowcaseProps, PaginationMeta, QueryParams, SingleResponse, SortCondition, SortDirection, UseNucleusEntityOptions, UseNucleusEntityReturn, } from './types';
 export { cn } from './utils/cn';
+export { foldForSearch, matchesQuery } from './utils/searchFold';
 export { formatLabel, getColumnType, getDefaultValue, isArrayColumn, isJsonColumn, isReferenceColumn, shouldExcludeColumn, shouldExcludeFromForm, } from './utils/columnUtils';
 export { generateBulkEndpointKey, generateDistinctEndpointKey, generateEntityEndpointKey, generateGetByIdEndpointKey, singularize, toUpperSnakeCase, } from './utils/endpointKeys';

package/dist/fe/index.js

@@ -36,5 +36,9 @@ export { useVerifyEmailStore, VerifyEmailPage } from './components/VerifyEmailPa
 export { useNucleusEntity } from './hooks/useNucleusEntity';
 export { usePubSub, usePubSubStore } from './hooks/usePubSub';
 export { cn } from './utils/cn';
+// Exported because every portal that lists people needs it and none of them
+// should write it twice: matching a typed query to a name is not a lower-case
+// comparison in any alphabet with marks in it.
+export { foldForSearch, matchesQuery } from './utils/searchFold';
 export { formatLabel, getColumnType, getDefaultValue, isArrayColumn, isJsonColumn, isReferenceColumn, shouldExcludeColumn, shouldExcludeFromForm } from './utils/columnUtils';
 export { generateBulkEndpointKey, generateDistinctEndpointKey, generateEntityEndpointKey, generateGetByIdEndpointKey, singularize, toUpperSnakeCase } from './utils/endpointKeys';

package/dist/fe/utils/searchFold.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Folding a string down to what a person typing into a search box meant.
+ *
+ * A search box that compares `toLowerCase()` to `toLowerCase()` only works for
+ * the alphabet it was written in. Everywhere else it fails in two directions at
+ * once, and the dotted i is the clearest case: `İSMAİL`.toLowerCase() is not
+ * `ismail` but `i̇smai̇l` — an `i` followed by a combining dot, which is a
+ * character nobody's keyboard produces. Type `ismail` into a directory of eight
+ * hundred people exported in capitals and it finds none of them. The same box
+ * cannot find `Şafak` from `safak`, or `Café` from `cafe`, which is how people
+ * search when the marks are a keystroke away rather than a key.
+ *
+ * The fold is three passes and no per-language table:
+ *
+ * 1. Lower-case with the INVARIANT rules. Turkish's own casing would send `I`
+ *    to `ı`, which is right for writing and wrong here — a search box wants
+ *    `I`, `İ`, `ı` and `i` to end up as the same letter, and they do once the
+ *    marks come off.
+ * 2. Decompose (NFD) and drop the combining marks. This is what turns the
+ *    stray dot above into nothing, and `é`, `ş`, `ğ`, `ü`, `ö`, `ç` into their
+ *    plain letters, for every script that composes that way.
+ * 3. Map the few letters that are their own character rather than a letter
+ *    plus a mark, so NFD has nothing to strip: the dotless `ı`, and `ø`, `ł`,
+ *    `đ`, `ß`, `æ`, `œ`.
+ *
+ * Language-neutral by construction, which is the point: the kit ships to
+ * whoever installs it.
+ */
+export declare function foldForSearch(value: string): string;
+/**
+ * True when every word typed appears somewhere in the given fields.
+ *
+ * Word by word rather than as one string, because the reader should not have to
+ * guess the order a row prints its parts in: `yalgi genel` finds the general
+ * manager whether the list renders the name before the post or after it.
+ *
+ * An empty query matches everything, so a caller can hand the raw input over
+ * without checking it first.
+ */
+export declare function matchesQuery(query: string, fields: readonly (string | null | undefined)[]): boolean;

package/dist/fe/utils/searchFold.js

@@ -0,0 +1,60 @@
+/**
+ * Folding a string down to what a person typing into a search box meant.
+ *
+ * A search box that compares `toLowerCase()` to `toLowerCase()` only works for
+ * the alphabet it was written in. Everywhere else it fails in two directions at
+ * once, and the dotted i is the clearest case: `İSMAİL`.toLowerCase() is not
+ * `ismail` but `i̇smai̇l` — an `i` followed by a combining dot, which is a
+ * character nobody's keyboard produces. Type `ismail` into a directory of eight
+ * hundred people exported in capitals and it finds none of them. The same box
+ * cannot find `Şafak` from `safak`, or `Café` from `cafe`, which is how people
+ * search when the marks are a keystroke away rather than a key.
+ *
+ * The fold is three passes and no per-language table:
+ *
+ * 1. Lower-case with the INVARIANT rules. Turkish's own casing would send `I`
+ *    to `ı`, which is right for writing and wrong here — a search box wants
+ *    `I`, `İ`, `ı` and `i` to end up as the same letter, and they do once the
+ *    marks come off.
+ * 2. Decompose (NFD) and drop the combining marks. This is what turns the
+ *    stray dot above into nothing, and `é`, `ş`, `ğ`, `ü`, `ö`, `ç` into their
+ *    plain letters, for every script that composes that way.
+ * 3. Map the few letters that are their own character rather than a letter
+ *    plus a mark, so NFD has nothing to strip: the dotless `ı`, and `ø`, `ł`,
+ *    `đ`, `ß`, `æ`, `œ`.
+ *
+ * Language-neutral by construction, which is the point: the kit ships to
+ * whoever installs it.
+ */ /** Letters with no decomposition, so step 2 cannot reach them. */ const STANDALONE = {
+    ı: 'i',
+    ø: 'o',
+    ł: 'l',
+    đ: 'd',
+    ð: 'd',
+    þ: 'th',
+    ß: 'ss',
+    æ: 'ae',
+    œ: 'oe'
+};
+const COMBINING_MARKS = /\p{M}/gu;
+export function foldForSearch(value) {
+    const lowered = value.toLowerCase().normalize('NFD').replace(COMBINING_MARKS, '');
+    let out = '';
+    for (const char of lowered)out += STANDALONE[char] ?? char;
+    return out;
+}
+/**
+ * True when every word typed appears somewhere in the given fields.
+ *
+ * Word by word rather than as one string, because the reader should not have to
+ * guess the order a row prints its parts in: `yalgi genel` finds the general
+ * manager whether the list renders the name before the post or after it.
+ *
+ * An empty query matches everything, so a caller can hand the raw input over
+ * without checking it first.
+ */ export function matchesQuery(query, fields) {
+    const words = foldForSearch(query).split(/\s+/).filter(Boolean);
+    if (words.length === 0) return true;
+    const haystack = foldForSearch(fields.filter(Boolean).join(' '));
+    return words.every((word)=>haystack.includes(word));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "nucleus-core-ts",
-	"version": "0.9.883",
+	"version": "0.9.885",
 	"description": "Production-ready, enterprise-grade TypeScript framework for building multi-tenant APIs",
 	"author": "Hidayet Can Özcan <hidayetcan@gmail.com>",
 	"license": "SEE LICENSE IN LICENSE",