najm-kit 2.11.12 → 2.11.13

package/CHANGELOG.md

@@ -1,19 +1,29 @@
-# Changelog
-
-## 2.11.10 - 2026-09-03
-
-- Fixed the selected numbered `NTable` pagination button inheriting the regular
-  foreground colour over its filled primary style. The active page now keeps
-  the primary button foreground token, which is white in the light theme.
-- Fixed focused invalid inputs combining a destructive border with the normal
-  theme focus colour. `BaseInput` now keeps the visible keyboard-focus ring but
-  colours it from the destructive token for both directly focused composite
-  controls and wrappers whose child has `:focus-visible`.
-- Made the desktop and mobile sidebar use logical inline edges, spacing, border
-  utilities, chevrons, and drag direction so the complete rail behaves
-  correctly in both LTR and RTL layouts.
-
-## 2.11.9 - 2026-08-30
+# Changelog
+
+## 2.11.13 - 2026-09-04
+
+- Fixed the documented `common.feedback.<field>` convention so all shared
+  loading, empty, error, forbidden, and not-found states resolve localized
+  labels without an application-owned `feedbackDefaults` key map. Missing
+  convention keys still fall back to the packaged English labels.
+- Forwarded Najm i18n's missing-key fallback and language-direction resolver
+  through `NajmAppProvider`, keeping language changes reactive for partial
+  catalogs and non-Arabic RTL languages.
+
+## 2.11.10 - 2026-09-03
+
+- Fixed the selected numbered `NTable` pagination button inheriting the regular
+  foreground colour over its filled primary style. The active page now keeps
+  the primary button foreground token, which is white in the light theme.
+- Fixed focused invalid inputs combining a destructive border with the normal
+  theme focus colour. `BaseInput` now keeps the visible keyboard-focus ring but
+  colours it from the destructive token for both directly focused composite
+  controls and wrappers whose child has `:focus-visible`.
+- Made the desktop and mobile sidebar use logical inline edges, spacing, border
+  utilities, chevrons, and drag direction so the complete rail behaves
+  correctly in both LTR and RTL layouts.
+
+## 2.11.9 - 2026-08-30
 
 - Fixed card grids that paginate client-side rendering their entire dataset on
   one page. `useTable` pinned an uncontrolled paged card list to `data.length`,

package/README.md

@@ -352,7 +352,40 @@ Resolution order, most specific first:
 2. A literal in `feedbackDefaults.labels`.
 3. A translated `feedbackDefaults.labelKeys` value resolved through the
    provider's existing structural `t` function.
-4. The current packaged English fallback, when that field has one.
+4. `` `<prefix>.<field>` `` resolved through the same `t`, where `prefix`
+   defaults to `common.feedback`.
+5. The current packaged English fallback, when that field has one.
+
+#### The prefix convention
+
+Step 4 is the reason most applications need no `feedbackDefaults` at all. Name
+the nine catalog entries after the fields — `common.feedback.emptyTitle`,
+`common.feedback.retryLabel`, and so on — and a provider that already has a
+translator resolves every feedback state with no mapping object to write or
+memoize:
+
+```tsx
+<NajmAppProvider translations={translations} initialLanguage="fr">
+  <App />
+</NajmAppProvider>
+```
+
+Use `prefix` to point at a different branch, and `FeedbackKey<Prefix>` to type
+a translator against exactly those nine keys:
+
+```tsx
+import type { FeedbackKey } from 'najm-kit';
+
+<NajmAppProvider feedbackDefaults={{ prefix: 'app.states' }}>
+```
+
+Unlike `buildToolbarLabels` and `buildPaginationLabels`, a translator result
+equal to the key it was handed is treated as *missing* here rather than
+rendered. The prefix is a convention an application may never have adopted, so
+an unanswered key falls through to packaged English instead of painting
+`common.feedback.emptyTitle` across an empty state. The same rule applies to an
+explicit `labelKeys` entry, which makes a typo in the mapping degrade to English
+rather than to visible key text.
 
 Generic `NErrorState.message` and `NEmptyState.description` deliberately have
 no packaged fallback — the no-provider render must look the same as it did

package/dist/{NajmUIProvider-DSjvh4x2.d.ts → NajmUIProvider-DTyRrukg.d.ts}

@@ -217,11 +217,24 @@ interface NFeedbackDefaults {
      */
     labelKeys?: NFeedbackLabelKeys;
     /**
-     * Catalog prefix for translated keys. Keys are read as `<prefix>.<field>`.
-     * Defaults to `"common.feedback"`.
+     * Catalog prefix for translated keys, read as `<prefix>.<field>` for every
+     * field `labelKeys` does not name explicitly. Defaults to
+     * `"common.feedback"`, so an application whose catalog follows the
+     * convention supplies no `feedbackDefaults` at all.
+     *
+     * A prefix key the catalog does not answer falls through to packaged
+     * English rather than rendering the key.
      */
     prefix?: string;
 }
+declare const DEFAULT_FEEDBACK_KEY_PREFIX = "common.feedback";
+type DefaultFeedbackPrefix = typeof DEFAULT_FEEDBACK_KEY_PREFIX;
+/**
+ * The nine catalog keys the feedback states read under `Prefix`, matching the
+ * `ToolbarKey` and `CardPaginationKey` conventions — same prefix, same
+ * key-per-field naming.
+ */
+type FeedbackKey<Prefix extends string = DefaultFeedbackPrefix> = `${Prefix}.loadingLabel` | `${Prefix}.emptyTitle` | `${Prefix}.errorTitle` | `${Prefix}.errorMessage` | `${Prefix}.retryLabel` | `${Prefix}.forbiddenTitle` | `${Prefix}.forbiddenDescription` | `${Prefix}.notFoundTitle` | `${Prefix}.notFoundDescription`;
 
 /**
  * Theme and time zone, the two preferences that outlive a render.
@@ -413,4 +426,4 @@ interface NajmUIProviderProps extends Omit<NajmPreferencesProviderProps, "childr
  */
 declare function NajmUIProvider({ children, design, initialDesign, className, t, paginationKeyPrefix, toolbarKeyPrefix, dir, tableDefaults, badgeDefaults, feedbackDefaults, initialTheme, initialTimeZone, onThemeChange, onTimeZoneChange, normalizeTimeZone, }: NajmUIProviderProps): React.JSX.Element;
 
-export { useDocumentDirection as A, type BadgeColor as B, useNTableDefaults as C, DEFAULT_TIME_ZONE as D, useNajmPreferencesContext as E, useNajmTheme as F, useNajmTimeZone as G, useResolvedToolbarLabels as H, type NFeedbackDefaults as N, type NFeedbackLabelKeys as a, type NFeedbackLabels as b, type NajmUIProviderProps as c, type NTableToolbarLabels as d, type NIconSource as e, type BadgeShape as f, Badge as g, type BadgeIcon as h, type BadgeLook as i, type BadgeProps as j, type BadgeSize as k, type BadgeVariant as l, NBadge as m, type NBadgeDefaults as n, type NBadgeLook as o, type NBadgeProps as p, NIcon as q, type NIconProps as r, type NTableDefaults as s, NTableDefaultsProvider as t, type NajmPreferencesContextValue as u, NajmPreferencesProvider as v, type NajmPreferencesProviderProps as w, NajmUIProvider as x, badgeColorVariants as y, badgeVariants as z };
+export { badgeVariants as A, type BadgeColor as B, useDocumentDirection as C, DEFAULT_FEEDBACK_KEY_PREFIX as D, useNTableDefaults as E, type FeedbackKey as F, useNajmPreferencesContext as G, useNajmTheme as H, useNajmTimeZone as I, useResolvedToolbarLabels as J, type NFeedbackDefaults as N, type NFeedbackLabelKeys as a, type NFeedbackLabels as b, type NajmUIProviderProps as c, type NTableToolbarLabels as d, type NIconSource as e, type BadgeShape as f, Badge as g, type BadgeIcon as h, type BadgeLook as i, type BadgeProps as j, type BadgeSize as k, type BadgeVariant as l, DEFAULT_TIME_ZONE as m, NBadge as n, type NBadgeDefaults as o, type NBadgeLook as p, type NBadgeProps as q, NIcon as r, type NIconProps as s, type NTableDefaults as t, NTableDefaultsProvider as u, type NajmPreferencesContextValue as v, NajmPreferencesProvider as w, type NajmPreferencesProviderProps as x, NajmUIProvider as y, badgeColorVariants as z };

package/dist/adapters/app.d.ts

@@ -3,7 +3,7 @@ import { Translations } from 'najm-i18n';
 import { F as FormDevToolsOptions, N as NBrandingInput } from '../NNotFoundState-CgU76llk.js';
 export { a as NEmptyState, b as NEmptyStateProps, c as NErrorState, d as NErrorStateProps, e as NFeedbackSurface, f as NForbiddenState, g as NForbiddenStateProps, h as NLoadingState, i as NLoadingStateProps, j as NNotFoundState, k as NNotFoundStateProps } from '../NNotFoundState-CgU76llk.js';
 import { NajmNextUIProviderProps } from './next.js';
-export { N as NFeedbackDefaults, a as NFeedbackLabelKeys, b as NFeedbackLabels } from '../NajmUIProvider-DSjvh4x2.js';
+export { D as DEFAULT_FEEDBACK_KEY_PREFIX, F as FeedbackKey, N as NFeedbackDefaults, a as NFeedbackLabelKeys, b as NFeedbackLabels } from '../NajmUIProvider-DTyRrukg.js';
 import 'zod';
 import 'lucide-react';
 import 'next/image';
@@ -33,6 +33,18 @@ interface NajmAppProviderProps extends Omit<NajmNextUIProviderProps, 't'> {
     translations?: Translations;
     initialLanguage?: string;
     defaultLanguage?: string;
+    /**
+     * Resolves a key missing from the active language against `defaultLanguage`
+     * instead of echoing the key. Forwarded to `najm-i18n`'s `I18nProvider`; see
+     * that package's "Missing-key fallback" for the full matrix.
+     *
+     * Off by default, matching the package. An application shipping an
+     * incomplete locale beside a complete one turns it on here rather than
+     * pre-merging its catalogs.
+     */
+    fallbackToDefaultLanguage?: boolean;
+    /** Maps a language to the writing direction applied to `<html>`. */
+    getLanguageDirection?: (language: string) => 'ltr' | 'rtl';
     /**
      * Where the chosen language is POSTed, as `{ language }`. Defaults to
      * `/api/ui-language`.
@@ -110,6 +122,6 @@ interface NajmAppProviderProps extends Omit<NajmNextUIProviderProps, 't'> {
  * state machine of its own above this provider. The controlled `design` and
  * `branding` props still work for applications that already do.
  */
-declare function NajmAppProvider({ translations, initialLanguage, defaultLanguage, languageEndpoint, appName, initialBranding, formDevTools, ...props }: NajmAppProviderProps): React.JSX.Element;
+declare function NajmAppProvider({ translations, initialLanguage, defaultLanguage, fallbackToDefaultLanguage, getLanguageDirection, languageEndpoint, appName, initialBranding, formDevTools, ...props }: NajmAppProviderProps): React.JSX.Element;
 
 export { type NajmAppBranding, NajmAppProvider, type NajmAppProviderProps };

package/dist/adapters/app.mjs

@@ -1,8 +1,8 @@
 'use client';
-import { FormDevToolsProvider, NBrandingStateProvider, NajmFormatProvider } from '../chunk-56JQI3VL.mjs';
-export { NEmptyState, NErrorState, NForbiddenState, NLoadingState, NNotFoundState } from '../chunk-56JQI3VL.mjs';
-import { NajmNextUIProvider } from '../chunk-VSK75GSS.mjs';
-import '../chunk-3J24TPLA.mjs';
+import { FormDevToolsProvider, NBrandingStateProvider, NajmFormatProvider } from '../chunk-26EASWUY.mjs';
+export { NEmptyState, NErrorState, NForbiddenState, NLoadingState, NNotFoundState } from '../chunk-26EASWUY.mjs';
+import { NajmNextUIProvider } from '../chunk-DKHIQFXX.mjs';
+export { DEFAULT_FEEDBACK_KEY_PREFIX } from '../chunk-BDQK6ECA.mjs';
 import '../chunk-M5VGBZ7R.mjs';
 import '../chunk-LK3SMYUP.mjs';
 import '../chunk-JABLSOQN.mjs';
@@ -72,6 +72,8 @@ function NajmAppProvider({
   translations,
   initialLanguage,
   defaultLanguage,
+  fallbackToDefaultLanguage,
+  getLanguageDirection,
   languageEndpoint = DEFAULT_LANGUAGE_ENDPOINT,
   appName,
   initialBranding,
@@ -104,6 +106,8 @@ function NajmAppProvider({
       translations,
       initialLanguage: initialLanguage ?? defaultLanguage ?? "en",
       defaultLanguage,
+      fallbackToDefaultLanguage,
+      getLanguageDirection,
       onLanguageChange: persistLanguage,
       children: /* @__PURE__ */ jsx(NajmAppUI, { ...props, initialBranding: seeded })
     }

package/dist/adapters/next.d.ts

@@ -1,6 +1,6 @@
 import React__default from 'react';
 import { ImageProps } from 'next/image';
-import { c as NajmUIProviderProps } from '../NajmUIProvider-DSjvh4x2.js';
+import { c as NajmUIProviderProps } from '../NajmUIProvider-DTyRrukg.js';
 import '../design-types-Rkpt8Pg1.js';
 import '../paginationLabels-dZLSNxfo.js';
 import 'class-variance-authority/types';

package/dist/adapters/next.mjs

@@ -1,3 +1,3 @@
-export { NNextImage, NajmNextUIProvider, NextLinkAdapter, useNextNavigationAdapter } from '../chunk-VSK75GSS.mjs';
-import '../chunk-3J24TPLA.mjs';
+export { NNextImage, NajmNextUIProvider, NextLinkAdapter, useNextNavigationAdapter } from '../chunk-DKHIQFXX.mjs';
+import '../chunk-BDQK6ECA.mjs';
 import '../chunk-LK3SMYUP.mjs';

package/dist/{chunk-56JQI3VL.mjs → chunk-26EASWUY.mjs}

@@ -1,4 +1,4 @@
-import { useResolvedFeedbackLabels, useNajmPreferencesContext } from './chunk-3J24TPLA.mjs';
+import { useResolvedFeedbackLabels, useNajmPreferencesContext } from './chunk-BDQK6ECA.mjs';
 import { Button } from './chunk-M5VGBZ7R.mjs';
 import { useNajmDesign, cn } from './chunk-LK3SMYUP.mjs';
 import { humanizeToken, DEFAULT_PLACEHOLDER, formatRelativeTime, formatTime, formatDateTime, formatDate, formatPercent, formatNumber, formatCurrency } from './chunk-JABLSOQN.mjs';

package/dist/{chunk-3J24TPLA.mjs → chunk-BDQK6ECA.mjs}

@@ -1,6 +1,6 @@
 import { NajmDesignProvider, cn } from './chunk-LK3SMYUP.mjs';
-import * as React2 from 'react';
-import React2__default from 'react';
+import * as React3 from 'react';
+import React3__default from 'react';
 import { jsx } from 'react/jsx-runtime';
 import { DirectionProvider } from '@radix-ui/react-direction';
 
@@ -74,7 +74,7 @@ function statusTextClass(status, statusMap, fallback) {
   const color = findStatusColor(status, statusMap) ?? fallback;
   return color ? colorTextClass(color) : "";
 }
-var NTableDefaultsContext = React2__default.createContext({});
+var NTableDefaultsContext = React3__default.createContext({});
 function NTableDefaultsProvider({
   children,
   value
@@ -82,12 +82,12 @@ function NTableDefaultsProvider({
   return /* @__PURE__ */ jsx(NTableDefaultsContext.Provider, { value, children });
 }
 function useNTableDefaults() {
-  return React2__default.useContext(NTableDefaultsContext);
+  return React3__default.useContext(NTableDefaultsContext);
 }
 function useResolvedPaginationLabels(own) {
   const defaults = useNTableDefaults();
   const inherited = defaults.paginationLabels;
-  return React2__default.useMemo(
+  return React3__default.useMemo(
     () => ({ ...inherited, ...own }),
     [inherited, own]
   );
@@ -95,12 +95,72 @@ function useResolvedPaginationLabels(own) {
 function useResolvedToolbarLabels(own) {
   const defaults = useNTableDefaults();
   const inherited = defaults.toolbarLabels;
-  return React2__default.useMemo(
+  return React3__default.useMemo(
     () => ({ ...inherited, ...own }),
     [inherited, own]
   );
 }
-var NajmPreferencesContext = React2.createContext(null);
+var ENGLISH_FEEDBACK_LABELS = {
+  loadingLabel: "Loading...",
+  emptyTitle: "No data",
+  errorTitle: "Something went wrong",
+  retryLabel: "Try again",
+  forbiddenTitle: "Access denied",
+  forbiddenDescription: "You do not have permission to view this page.",
+  notFoundTitle: "Page not found",
+  notFoundDescription: "The requested page could not be found."
+};
+var NFeedbackDefaultsContext = React3.createContext(null);
+function NFeedbackDefaultsProvider({
+  value,
+  children
+}) {
+  return /* @__PURE__ */ jsx(NFeedbackDefaultsContext.Provider, { value, children });
+}
+function useNFeedbackDefaults() {
+  return React3.useContext(NFeedbackDefaultsContext);
+}
+var DEFAULT_FEEDBACK_KEY_PREFIX = "common.feedback";
+function useResolvedFeedbackLabels() {
+  const ctx = useNFeedbackDefaults();
+  return React3.useMemo(() => resolveFeedbackLabels(ctx), [ctx]);
+}
+function resolveFeedbackLabels(ctx) {
+  const defaults = ctx?.defaults;
+  const t = ctx?.t;
+  const labels = defaults?.labels;
+  const labelKeys = defaults?.labelKeys;
+  const prefix = defaults?.prefix ?? DEFAULT_FEEDBACK_KEY_PREFIX;
+  const translated = (key) => {
+    if (!t) return void 0;
+    const value = t(key);
+    return value === key ? void 0 : value;
+  };
+  const pick = (field, hasFallback) => {
+    const literal = labels?.[field];
+    if (literal !== void 0) return literal;
+    const key = labelKeys?.[field];
+    const fromCatalog = translated(key ?? `${prefix}.${field}`);
+    if (fromCatalog !== void 0) return fromCatalog;
+    if (hasFallback) return ENGLISH_FEEDBACK_LABELS[field];
+    return void 0;
+  };
+  return {
+    loadingLabel: pick("loadingLabel", true) ?? ENGLISH_FEEDBACK_LABELS.loadingLabel,
+    emptyTitle: pick("emptyTitle", true) ?? ENGLISH_FEEDBACK_LABELS.emptyTitle,
+    errorTitle: pick("errorTitle", true) ?? ENGLISH_FEEDBACK_LABELS.errorTitle,
+    errorMessage: pick("errorMessage", false),
+    retryLabel: pick("retryLabel", true) ?? ENGLISH_FEEDBACK_LABELS.retryLabel,
+    forbiddenTitle: pick("forbiddenTitle", true) ?? ENGLISH_FEEDBACK_LABELS.forbiddenTitle,
+    forbiddenDescription: pick("forbiddenDescription", true) ?? ENGLISH_FEEDBACK_LABELS.forbiddenDescription,
+    notFoundTitle: pick("notFoundTitle", true) ?? ENGLISH_FEEDBACK_LABELS.notFoundTitle,
+    notFoundDescription: pick("notFoundDescription", true) ?? ENGLISH_FEEDBACK_LABELS.notFoundDescription
+  };
+}
+function resolveFeedbackDefaultsValue(defaults, t) {
+  return { defaults: defaults ?? {}, t };
+}
+var NajmPreferencesContext = React3.createContext(null);
 var DEFAULT_TIME_ZONE = "UTC";
 function isValidTimeZone(value) {
   try {
@@ -129,44 +189,44 @@ function NajmPreferencesProvider({
   onTimeZoneChange,
   normalizeTimeZone = defaultNormalizeTimeZone
 }) {
-  const [theme, setThemeState] = React2.useState(initialTheme);
-  const [timeZone, setTimeZoneState] = React2.useState(
+  const [theme, setThemeState] = React3.useState(initialTheme);
+  const [timeZone, setTimeZoneState] = React3.useState(
     () => normalizeTimeZone(initialTimeZone)
   );
-  const onThemeChangeRef = React2.useRef(onThemeChange);
-  const onTimeZoneChangeRef = React2.useRef(onTimeZoneChange);
-  const normalizeRef = React2.useRef(normalizeTimeZone);
-  React2.useEffect(() => {
+  const onThemeChangeRef = React3.useRef(onThemeChange);
+  const onTimeZoneChangeRef = React3.useRef(onTimeZoneChange);
+  const normalizeRef = React3.useRef(normalizeTimeZone);
+  React3.useEffect(() => {
     onThemeChangeRef.current = onThemeChange;
     onTimeZoneChangeRef.current = onTimeZoneChange;
     normalizeRef.current = normalizeTimeZone;
   });
-  React2.useEffect(() => {
+  React3.useEffect(() => {
     applyTheme(theme);
     applyTimeZone(timeZone);
   }, []);
-  const setTheme = React2.useCallback(async (next) => {
+  const setTheme = React3.useCallback(async (next) => {
     setThemeState(next);
     applyTheme(next);
     await onThemeChangeRef.current?.(next);
   }, []);
-  const setTimeZone = React2.useCallback(async (next) => {
+  const setTimeZone = React3.useCallback(async (next) => {
     const normalized = normalizeRef.current(next);
     setTimeZoneState(normalized);
     applyTimeZone(normalized);
     await onTimeZoneChangeRef.current?.(normalized);
   }, []);
-  const value = React2.useMemo(
+  const value = React3.useMemo(
     () => ({ theme, setTheme, timeZone, setTimeZone }),
     [theme, setTheme, timeZone, setTimeZone]
   );
   return /* @__PURE__ */ jsx(NajmPreferencesContext.Provider, { value, children });
 }
 function useNajmPreferencesContext() {
-  return React2.useContext(NajmPreferencesContext);
+  return React3.useContext(NajmPreferencesContext);
 }
 function usePreferencesOrThrow(hook) {
-  const value = React2.useContext(NajmPreferencesContext);
+  const value = React3.useContext(NajmPreferencesContext);
   if (!value) {
     throw new Error(
       `${hook} must be rendered under a NajmUIProvider or NajmPreferencesProvider.`
@@ -176,11 +236,11 @@ function usePreferencesOrThrow(hook) {
 }
 function useNajmTheme() {
   const { theme, setTheme } = usePreferencesOrThrow("useNajmTheme");
-  return React2.useMemo(() => ({ theme, setTheme }), [theme, setTheme]);
+  return React3.useMemo(() => ({ theme, setTheme }), [theme, setTheme]);
 }
 function useNajmTimeZone() {
   const { timeZone, setTimeZone } = usePreferencesOrThrow("useNajmTimeZone");
-  return React2.useMemo(
+  return React3.useMemo(
     () => ({ timeZone, setTimeZone }),
     [timeZone, setTimeZone]
   );
@@ -225,10 +285,10 @@ function buildToolbarLabels(t, prefix) {
   };
 }
 function useDocumentDirection(override) {
-  const [direction, setDirection] = React2.useState(
+  const [direction, setDirection] = React3.useState(
     override ?? "ltr"
   );
-  React2.useEffect(() => {
+  React3.useEffect(() => {
     if (override) {
       setDirection(override);
       return;
@@ -247,9 +307,9 @@ var EMPTY_DESIGN = Object.freeze({
   theme: {},
   components: {}
 });
-var NajmDesignEditorContext = React2.createContext(null);
+var NajmDesignEditorContext = React3.createContext(null);
 function useNajmDesignEditor() {
-  return React2.useContext(NajmDesignEditorContext);
+  return React3.useContext(NajmDesignEditorContext);
 }
 function cloneDesign(design) {
   return structuredClone(design);
@@ -259,29 +319,29 @@ function NajmDesignEditorProvider({
   design,
   initialDesign
 }) {
-  const [state, setState] = React2.useState(() => ({
+  const [state, setState] = React3.useState(() => ({
     committed: initialDesign ?? design ?? EMPTY_DESIGN,
     draft: null
   }));
-  const beginDraft = React2.useCallback(() => {
+  const beginDraft = React3.useCallback(() => {
     setState(
       (current) => current.draft ? current : { ...current, draft: cloneDesign(current.committed) }
     );
   }, []);
-  const setDraft = React2.useCallback((next) => {
+  const setDraft = React3.useCallback((next) => {
     setState((current) => ({ ...current, draft: cloneDesign(next) }));
   }, []);
-  const cancelDraft = React2.useCallback(() => {
+  const cancelDraft = React3.useCallback(() => {
     setState(
       (current) => current.draft === null ? current : { ...current, draft: null }
     );
   }, []);
-  const setCommitted = React2.useCallback((next) => {
+  const setCommitted = React3.useCallback((next) => {
     setState(
       (current) => current.committed === next && current.draft === null ? current : { committed: next, draft: null }
     );
   }, []);
-  const value = React2.useMemo(() => {
+  const value = React3.useMemo(() => {
     if (design) {
       return {
         design,
@@ -309,20 +369,20 @@ function NajmDesignEditorProvider({
 }
 function noop() {
 }
-var NBadgeDefaultsContext = React2.createContext(null);
+var NBadgeDefaultsContext = React3.createContext(null);
 function NBadgeDefaultsProvider({
   defaults,
   t,
   children
 }) {
-  const value = React2.useMemo(
+  const value = React3.useMemo(
     () => ({ defaults, t }),
     [defaults, t]
   );
   return /* @__PURE__ */ jsx(NBadgeDefaultsContext.Provider, { value, children });
 }
 function useNBadgeDefaults() {
-  return React2.useContext(NBadgeDefaultsContext);
+  return React3.useContext(NBadgeDefaultsContext);
 }
 function resolveBadgeStatusLabel(status, defaults, t) {
   if (!defaults) return void 0;
@@ -337,60 +397,6 @@ function mergeBadgeMaps(base, overrides) {
   if (!overrides) return base;
   return { ...base, ...overrides };
 }
-var ENGLISH_FEEDBACK_LABELS = {
-  loadingLabel: "Loading...",
-  emptyTitle: "No data",
-  errorTitle: "Something went wrong",
-  retryLabel: "Try again",
-  forbiddenTitle: "Access denied",
-  forbiddenDescription: "You do not have permission to view this page.",
-  notFoundTitle: "Page not found",
-  notFoundDescription: "The requested page could not be found."
-};
-var NFeedbackDefaultsContext = React2.createContext(null);
-function NFeedbackDefaultsProvider({
-  value,
-  children
-}) {
-  return /* @__PURE__ */ jsx(NFeedbackDefaultsContext.Provider, { value, children });
-}
-function useNFeedbackDefaults() {
-  return React2.useContext(NFeedbackDefaultsContext);
-}
-var DEFAULT_FEEDBACK_KEY_PREFIX = "common.feedback";
-function useResolvedFeedbackLabels() {
-  const ctx = useNFeedbackDefaults();
-  return React2.useMemo(() => resolveFeedbackLabels(ctx), [ctx]);
-}
-function resolveFeedbackLabels(ctx) {
-  const defaults = ctx?.defaults;
-  const t = ctx?.t;
-  const labels = defaults?.labels;
-  const labelKeys = defaults?.labelKeys;
-  defaults?.prefix ?? DEFAULT_FEEDBACK_KEY_PREFIX;
-  const pick = (field, hasFallback) => {
-    const literal = labels?.[field];
-    if (literal !== void 0) return literal;
-    const key = labelKeys?.[field];
-    if (key && t) return t(key);
-    if (hasFallback) return ENGLISH_FEEDBACK_LABELS[field];
-    return void 0;
-  };
-  return {
-    loadingLabel: pick("loadingLabel", true) ?? ENGLISH_FEEDBACK_LABELS.loadingLabel,
-    emptyTitle: pick("emptyTitle", true) ?? ENGLISH_FEEDBACK_LABELS.emptyTitle,
-    errorTitle: pick("errorTitle", true) ?? ENGLISH_FEEDBACK_LABELS.errorTitle,
-    errorMessage: pick("errorMessage", false),
-    retryLabel: pick("retryLabel", true) ?? ENGLISH_FEEDBACK_LABELS.retryLabel,
-    forbiddenTitle: pick("forbiddenTitle", true) ?? ENGLISH_FEEDBACK_LABELS.forbiddenTitle,
-    forbiddenDescription: pick("forbiddenDescription", true) ?? ENGLISH_FEEDBACK_LABELS.forbiddenDescription,
-    notFoundTitle: pick("notFoundTitle", true) ?? ENGLISH_FEEDBACK_LABELS.notFoundTitle,
-    notFoundDescription: pick("notFoundDescription", true) ?? ENGLISH_FEEDBACK_LABELS.notFoundDescription
-  };
-}
-function resolveFeedbackDefaultsValue(defaults, t) {
-  return { defaults: defaults ?? {}, t };
-}
 function NajmUICore({
   children,
   className,
@@ -405,7 +411,7 @@ function NajmUICore({
   const { theme } = useNajmTheme();
   const direction = useDocumentDirection(dir);
   const design = useNajmDesignEditor()?.design ?? EMPTY_DESIGN;
-  const defaults = React2.useMemo(() => {
+  const defaults = React3.useMemo(() => {
     const translated = t ? buildPaginationLabels(t, paginationKeyPrefix) : void 0;
     const overrides = tableDefaults?.paginationLabels;
     const paginationLabels = translated || overrides ? { ...translated, ...overrides } : void 0;
@@ -414,7 +420,7 @@ function NajmUICore({
     const toolbarLabels = translatedToolbar || toolbarOverrides ? { ...translatedToolbar, ...toolbarOverrides } : void 0;
     return { ...tableDefaults, paginationLabels, toolbarLabels };
   }, [t, paginationKeyPrefix, toolbarKeyPrefix, tableDefaults]);
-  const feedbackValue = React2.useMemo(
+  const feedbackValue = React3.useMemo(
     () => resolveFeedbackDefaultsValue(feedbackDefaults, t),
     [feedbackDefaults, t]
   );
@@ -499,7 +505,7 @@ function selectImageSource(sources, failed) {
 var NO_FAILURES = [];
 function useImageChain(sources) {
   const key = JSON.stringify(sources);
-  const [state, setState] = React2.useState(() => ({
+  const [state, setState] = React3.useState(() => ({
     key,
     failed: NO_FAILURES,
     loaded: null
@@ -508,13 +514,13 @@ function useImageChain(sources) {
   const current = state.key === key ? state : fresh;
   if (state.key !== key) setState(fresh);
   const active = selectImageSource(sources, current.failed);
-  const markLoaded = React2.useCallback(() => {
+  const markLoaded = React3.useCallback(() => {
     if (active === void 0) return;
     setState(
       (prev) => prev.key !== key || prev.loaded === active ? prev : { ...prev, loaded: active }
     );
   }, [key, active]);
-  const markFailed = React2.useCallback(() => {
+  const markFailed = React3.useCallback(() => {
     if (active === void 0) return;
     setState((prev) => {
       if (prev.key !== key || prev.failed.includes(active)) return prev;
@@ -534,4 +540,4 @@ function useImageChain(sources) {
   };
 }
 
-export { DEFAULT_PAGINATION_KEY_PREFIX, DEFAULT_TIME_ZONE, DEFAULT_TOOLBAR_KEY_PREFIX, EMPTY_DESIGN, NAJM_COLOR_TEXT_CLASSES, NAJM_STATUS_COLORS, NTableDefaultsProvider, NajmDesignEditorProvider, NajmPreferencesProvider, NajmUIProvider, buildPaginationLabels, buildToolbarLabels, colorTextClass, findStatusColor, mergeBadgeMaps, normalizeImageSources, normalizeStatusToken, resolveBadgeStatusLabel, resolveStatusColor, statusTextClass, useDocumentDirection, useImageChain, useNBadgeDefaults, useNTableDefaults, useNajmDesignEditor, useNajmPreferencesContext, useNajmTheme, useNajmTimeZone, useResolvedFeedbackLabels, useResolvedPaginationLabels, useResolvedToolbarLabels };
+export { DEFAULT_FEEDBACK_KEY_PREFIX, DEFAULT_PAGINATION_KEY_PREFIX, DEFAULT_TIME_ZONE, DEFAULT_TOOLBAR_KEY_PREFIX, EMPTY_DESIGN, NAJM_COLOR_TEXT_CLASSES, NAJM_STATUS_COLORS, NTableDefaultsProvider, NajmDesignEditorProvider, NajmPreferencesProvider, NajmUIProvider, buildPaginationLabels, buildToolbarLabels, colorTextClass, findStatusColor, mergeBadgeMaps, normalizeImageSources, normalizeStatusToken, resolveBadgeStatusLabel, resolveStatusColor, statusTextClass, useDocumentDirection, useImageChain, useNBadgeDefaults, useNTableDefaults, useNajmDesignEditor, useNajmPreferencesContext, useNajmTheme, useNajmTimeZone, useResolvedFeedbackLabels, useResolvedPaginationLabels, useResolvedToolbarLabels };

package/dist/{chunk-VSK75GSS.mjs → chunk-DKHIQFXX.mjs}

@@ -1,4 +1,4 @@
-import { useImageChain, normalizeImageSources, NajmUIProvider } from './chunk-3J24TPLA.mjs';
+import { useImageChain, normalizeImageSources, NajmUIProvider } from './chunk-BDQK6ECA.mjs';
 import React from 'react';
 import { useRouter } from 'next/navigation';
 import NextImage from 'next/image';

package/dist/index.d.ts

@@ -2,8 +2,8 @@ import * as React$1 from 'react';
 import React__default, { RefObject, ReactNode, ComponentType, InputHTMLAttributes, Ref, ImgHTMLAttributes, CSSProperties, MouseEvent, MouseEventHandler } from 'react';
 import { a as NajmDesignConfig, f as NajmThemeProviderProps, g as NajmAppearance, e as NajmMode, h as NajmThemeConfig, i as NajmAccent, j as NajmThemeTokens, k as NajmPreset, l as NajmComponentName, m as NajmComponentStyleConfig, N as NajmComponentThemeConfig, c as NajmTypographyConfig, b as NajmLayoutConfig, n as NajmResponsiveBreakpoint, o as NajmResponsiveValue } from './design-types-Rkpt8Pg1.js';
 export { p as NAJM_COMPONENT_NAMES, q as NajmComponentRadius, r as NajmDensity, s as NajmSlotStyle, d as NajmVariantStyle, R as RADIUS_VALUE_MAP, t as resolveRadiusValue } from './design-types-Rkpt8Pg1.js';
-import { d as NTableToolbarLabels, e as NIconSource, B as BadgeColor, f as BadgeShape } from './NajmUIProvider-DSjvh4x2.js';
-export { g as Badge, h as BadgeIcon, i as BadgeLook, j as BadgeProps, k as BadgeSize, l as BadgeVariant, D as DEFAULT_TIME_ZONE, m as NBadge, n as NBadgeDefaults, o as NBadgeLook, p as NBadgeProps, N as NFeedbackDefaults, a as NFeedbackLabelKeys, b as NFeedbackLabels, q as NIcon, r as NIconProps, s as NTableDefaults, t as NTableDefaultsProvider, u as NajmPreferencesContextValue, v as NajmPreferencesProvider, w as NajmPreferencesProviderProps, x as NajmUIProvider, c as NajmUIProviderProps, y as badgeColorVariants, z as badgeVariants, A as useDocumentDirection, C as useNTableDefaults, E as useNajmPreferencesContext, F as useNajmTheme, G as useNajmTimeZone, H as useResolvedToolbarLabels } from './NajmUIProvider-DSjvh4x2.js';
+import { d as NTableToolbarLabels, e as NIconSource, B as BadgeColor, f as BadgeShape } from './NajmUIProvider-DTyRrukg.js';
+export { g as Badge, h as BadgeIcon, i as BadgeLook, j as BadgeProps, k as BadgeSize, l as BadgeVariant, D as DEFAULT_FEEDBACK_KEY_PREFIX, m as DEFAULT_TIME_ZONE, F as FeedbackKey, n as NBadge, o as NBadgeDefaults, p as NBadgeLook, q as NBadgeProps, N as NFeedbackDefaults, a as NFeedbackLabelKeys, b as NFeedbackLabels, r as NIcon, s as NIconProps, t as NTableDefaults, u as NTableDefaultsProvider, v as NajmPreferencesContextValue, w as NajmPreferencesProvider, x as NajmPreferencesProviderProps, y as NajmUIProvider, c as NajmUIProviderProps, z as badgeColorVariants, A as badgeVariants, C as useDocumentDirection, E as useNTableDefaults, G as useNajmPreferencesContext, H as useNajmTheme, I as useNajmTimeZone, J as useResolvedToolbarLabels } from './NajmUIProvider-DTyRrukg.js';
 import { N as NajmTranslate, c as NTablePaginationVariant, b as NTablePaginationLabels, a as NTableCardPagination } from './paginationLabels-dZLSNxfo.js';
 export { D as DEFAULT_PAGINATION_KEY_PREFIX, d as NTableInfinitePagination, e as NTableLoadMorePagination, f as buildPaginationLabels } from './paginationLabels-dZLSNxfo.js';
 export { d as defineNajmDesignConfig, p as parseNajmDesignConfig, r as resolveVariantAlias, s as stringifyNajmDesignConfig } from './design-config-D_x1GCu3.js';

package/dist/index.mjs

@@ -1,9 +1,9 @@
 import { resolveAvatarSrc } from './chunk-BEGOH366.mjs';
 export { isPlaceholderAvatar, resolveAvatarSrc } from './chunk-BEGOH366.mjs';
-import { NLoadingState, NErrorState, NEmptyState, useResolvedFormDevTools, useNBranding } from './chunk-56JQI3VL.mjs';
-export { FormDevToolsProvider, NBrandingProvider, NBrandingStateProvider, NEmptyState, NErrorState, NForbiddenState, NLoadingState, NNotFoundState, NPageLayout, NSpinner, NajmFormatProvider, buildFormFill, normalizeBranding, useNBranding, useNBrandingEditor, useNajmFormat, useNajmFormatContext } from './chunk-56JQI3VL.mjs';
-import { normalizeImageSources, useImageChain, useNBadgeDefaults, mergeBadgeMaps, resolveStatusColor, resolveBadgeStatusLabel, colorTextClass, useResolvedPaginationLabels, useResolvedToolbarLabels } from './chunk-3J24TPLA.mjs';
-export { DEFAULT_PAGINATION_KEY_PREFIX, DEFAULT_TIME_ZONE, DEFAULT_TOOLBAR_KEY_PREFIX, EMPTY_DESIGN, NAJM_COLOR_TEXT_CLASSES, NAJM_STATUS_COLORS, NTableDefaultsProvider, NajmDesignEditorProvider, NajmPreferencesProvider, NajmUIProvider, buildPaginationLabels, buildToolbarLabels, colorTextClass, findStatusColor, normalizeStatusToken, resolveStatusColor, statusTextClass, useDocumentDirection, useNTableDefaults, useNajmDesignEditor, useNajmPreferencesContext, useNajmTheme, useNajmTimeZone, useResolvedToolbarLabels } from './chunk-3J24TPLA.mjs';
+import { NLoadingState, NErrorState, NEmptyState, useResolvedFormDevTools, useNBranding } from './chunk-26EASWUY.mjs';
+export { FormDevToolsProvider, NBrandingProvider, NBrandingStateProvider, NEmptyState, NErrorState, NForbiddenState, NLoadingState, NNotFoundState, NPageLayout, NSpinner, NajmFormatProvider, buildFormFill, normalizeBranding, useNBranding, useNBrandingEditor, useNajmFormat, useNajmFormatContext } from './chunk-26EASWUY.mjs';
+import { normalizeImageSources, useImageChain, useNBadgeDefaults, mergeBadgeMaps, resolveStatusColor, resolveBadgeStatusLabel, colorTextClass, useResolvedPaginationLabels, useResolvedToolbarLabels } from './chunk-BDQK6ECA.mjs';
+export { DEFAULT_FEEDBACK_KEY_PREFIX, DEFAULT_PAGINATION_KEY_PREFIX, DEFAULT_TIME_ZONE, DEFAULT_TOOLBAR_KEY_PREFIX, EMPTY_DESIGN, NAJM_COLOR_TEXT_CLASSES, NAJM_STATUS_COLORS, NTableDefaultsProvider, NajmDesignEditorProvider, NajmPreferencesProvider, NajmUIProvider, buildPaginationLabels, buildToolbarLabels, colorTextClass, findStatusColor, normalizeStatusToken, resolveStatusColor, statusTextClass, useDocumentDirection, useNTableDefaults, useNajmDesignEditor, useNajmPreferencesContext, useNajmTheme, useNajmTimeZone, useResolvedToolbarLabels } from './chunk-BDQK6ECA.mjs';
 import { NajmScroll, useNajmScrollViewport, useTableStore, TableStoreContext, NTableJson } from './chunk-5JVFMOLI.mjs';
 export { NTableJson, NajmScroll, TableStoreContext, useTableStore } from './chunk-5JVFMOLI.mjs';
 import { inputBorderClasses, Button, NIcon, surfaceBorderClasses, buttonVariants, NButton, sidebarBorderClasses } from './chunk-M5VGBZ7R.mjs';

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.12",
+  "version": "2.11.13",
   "license": "MIT",
   "type": "module",
   "description": "Reusable React UI component package for Najm framework",
@@ -198,7 +198,7 @@
     "@uiw/react-codemirror": "^4.25.0",
     "@vitejs/plugin-react": "^5.2.0",
     "happy-dom": "^20.11.1",
-    "najm-i18n": "^2.0.3",
+    "najm-i18n": "^2.1.0",
     "postcss": "^8.5.22",
     "react-hook-form": "^7",
     "rimraf": "^6",