najm-kit 2.11.20 → 2.11.22

package/CHANGELOG.md

@@ -1,4 +1,19 @@
-# Changelog
+# Changelog
+
+## 2.11.22 - 2026-09-11
+
+- Allowed destructive dialogs to render a caller-supplied title, wrap and
+  center long item names, and use a transparent destructive-outline cancel
+  action.
+- Made native calendar caption dropdowns follow the resolved light or dark
+  theme and clarified pointer feedback for enabled and disabled dates.
+
+## 2.11.21 - 2026-09-09
+
+- Added first-visit browser-language negotiation to `defineNajmPreferences`.
+  Applications can pass the raw `Accept-Language` header to `resolve`; explicit
+  cookies and account fallbacks retain priority, while quality weights and
+  regional language tags are matched against the configured catalog.
 
 ## 2.11.19 - 2026-09-06
 

package/README.md

@@ -1132,13 +1132,18 @@ field are the same `400`. Nothing from the request body reaches the response.
 
 ```tsx
 // src/app/layout.tsx
-import { cookies } from "next/headers";
+import { cookies, headers } from "next/headers";
 import { preferences } from "@/preferences";
 
 export default async function RootLayout({ children }: { children: React.ReactNode }) {
-  const [cookieStore, session] = await Promise.all([cookies(), getSession()]);
+  const [cookieStore, requestHeaders, session] = await Promise.all([
+    cookies(),
+    headers(),
+    getSession(),
+  ]);
   const { language, theme, timeZone } = preferences.resolve(cookieStore, {
     languageFallback: session?.user.language,
+    acceptLanguage: requestHeaders.get("accept-language"),
   });
 
   return (
@@ -1156,9 +1161,10 @@ export default async function RootLayout({ children }: { children: React.ReactNo
 ```
 
 `resolve` takes anything with `get(name)` — Next's cookie store, or a plain
-object in a test. Precedence is cookie, then `languageFallback`, then the
-catalog default; an invalid or dropped cookie language falls through to the
-fallback rather than pinning the UI.
+object in a test. Language precedence is cookie, then `languageFallback`, then
+the `acceptLanguage` request header, then the catalog default. Browser
+negotiation honors quality weights and regional tags; invalid stored values
+fall through rather than pinning the UI.
 
 ### Types
 

package/dist/server/index.d.ts

@@ -77,6 +77,12 @@ interface NajmPreferenceResolveOptions {
      * valid cookie: the cookie is what the user last chose in this browser.
      */
     languageFallback?: unknown;
+    /**
+     * The raw `Accept-Language` request header. Used only after the language
+     * cookie and `languageFallback`; quality weights and regional language tags
+     * are matched against the application's supported languages.
+     */
+    acceptLanguage?: string | null;
 }
 /** A route handler, ready to `export const POST = ...`. */
 type NajmPreferenceHandler = (request: Request) => Promise<Response>;

package/dist/server/index.mjs

@@ -44,6 +44,44 @@ function rejection(message) {
 function accepted(field, value, cookie) {
   return Response.json({ [field]: value }, { headers: { "Set-Cookie": cookie } });
 }
+var LANGUAGE_RANGE_PATTERN = /^(?:\*|[a-z]{1,8}(?:-[a-z0-9]{1,8})*)$/i;
+var LANGUAGE_QUALITY_PATTERN = /^q\s*=\s*(0(?:\.\d{0,3})?|1(?:\.0{0,3})?)$/i;
+function parseAcceptLanguage(value) {
+  if (!value) return [];
+  return value.split(",").map((entry, order) => {
+    const [rawRange, ...parameters] = entry.split(";");
+    const range = rawRange?.trim().toLowerCase() ?? "";
+    if (!LANGUAGE_RANGE_PATTERN.test(range)) return null;
+    let quality = 1;
+    for (const rawParameter of parameters) {
+      const match = LANGUAGE_QUALITY_PATTERN.exec(rawParameter.trim());
+      if (!match) return null;
+      quality = Number(match[1]);
+    }
+    return { range, quality, order };
+  }).filter((entry) => entry !== null).sort((left, right) => right.quality - left.quality || left.order - right.order);
+}
+function lookupAcceptedLanguage(value, supportedLanguages, defaultLanguage) {
+  const supported = supportedLanguages.map((language) => ({
+    language,
+    normalized: language.toLowerCase()
+  }));
+  for (const preference of parseAcceptLanguage(value)) {
+    if (preference.quality === 0) continue;
+    if (preference.range === "*") return defaultLanguage;
+    let candidate = preference.range;
+    while (candidate) {
+      const match = supported.find(
+        (entry) => entry.normalized === candidate || entry.normalized.startsWith(`${candidate}-`)
+      );
+      if (match) return match.language;
+      const separator = candidate.lastIndexOf("-");
+      if (separator === -1) break;
+      candidate = candidate.slice(0, separator);
+    }
+  }
+  return void 0;
+}
 function defineNajmPreferences(config) {
   const { i18n } = config;
   const timeZones = Object.freeze([
@@ -81,7 +119,11 @@ function defineNajmPreferences(config) {
   const isLanguage = (value) => typeof value === "string" && i18n.supportedLanguages.includes(value);
   function resolve(cookies, options = {}) {
     const languageCookie = cookies.get(cookieNames.language)?.value;
-    const language = isLanguage(languageCookie) ? languageCookie : i18n.normalizeLanguage(options.languageFallback);
+    const language = isLanguage(languageCookie) ? languageCookie : isLanguage(options.languageFallback) ? options.languageFallback : lookupAcceptedLanguage(
+      options.acceptLanguage,
+      i18n.supportedLanguages,
+      i18n.defaultLanguage
+    ) ?? i18n.defaultLanguage;
     const themeCookie = cookies.get(cookieNames.theme)?.value;
     const timeZoneCookie = cookies.get(cookieNames.timeZone)?.value;
     return {

package/dist/theme.css

@@ -317,10 +317,10 @@ input:autofill {
   overflow-x: auto;
   scrollbar-width: none;
 }
-.najm-overlay-scroll-x::-webkit-scrollbar {
-  display: none;
-}
-
+.najm-overlay-scroll-x::-webkit-scrollbar {
+  display: none;
+}
+
 /* Responsive table actions stay discoverable on touch and tablet layouts.
    Fine-pointer desktops may keep the quieter hover/focus reveal treatment. */
 .ntable-card-action {
@@ -377,7 +377,7 @@ input:autofill {
   .nimage-input-compact-overlay:focus-visible {
     opacity: 1;
   }
-}
+}
 
 /* OverlayScrollbars theme used by the <NajmScroll> component — a thin,
    translucent slate bar that floats over content with no reserved space.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "najm-kit",
-  "version": "2.11.20",
+  "version": "2.11.22",
   "license": "MIT",
   "type": "module",
   "description": "Reusable React UI component package for Najm framework",