najm-kit 2.11.11 → 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/{NNotFoundState-D1CLLLxc.d.ts → NNotFoundState-CgU76llk.d.ts}

@@ -1,4 +1,4 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as React from 'react';
 import React__default, { ReactNode } from 'react';
 import { ZodTypeAny, TypeOf } from 'zod';
 import { LucideIcon } from 'lucide-react';
@@ -49,7 +49,7 @@ declare function useNBranding(): NBrandingValue | null;
  */
 declare function NBrandingProvider({ children, appName, logoExpanded, logoCollapsed, logoFallback, logoHref, }: Readonly<NBrandingValue & {
     children: ReactNode;
-}>): react_jsx_runtime.JSX.Element;
+}>): React.JSX.Element;
 interface NBrandingEditorValue {
     branding: NBrandingValue;
     /**
@@ -79,7 +79,7 @@ interface NBrandingStateProviderProps {
     initialBranding?: NBrandingInput;
 }
 /** `NBrandingProvider` with the marks held as state an editor can write. */
-declare function NBrandingStateProvider({ children, branding, initialBranding, }: Readonly<NBrandingStateProviderProps>): react_jsx_runtime.JSX.Element;
+declare function NBrandingStateProvider({ children, branding, initialBranding, }: Readonly<NBrandingStateProviderProps>): React.JSX.Element;
 
 type FormFillOverride = unknown | readonly unknown[] | ((fieldName: string) => unknown);
 type FormFillOverrides = Record<string, FormFillOverride>;
@@ -122,7 +122,7 @@ interface NLoadingStateProps {
      */
     surface?: NFeedbackSurface;
 }
-declare function NLoadingState({ label, className, fullScreen, spinnerVariant, spinnerSize, surface, }: NLoadingStateProps): react_jsx_runtime.JSX.Element;
+declare function NLoadingState({ label, className, fullScreen, spinnerVariant, spinnerSize, surface, }: NLoadingStateProps): React__default.JSX.Element;
 
 interface NErrorStateProps {
     title?: string;
@@ -134,7 +134,7 @@ interface NErrorStateProps {
     /** Layout surface. See `NLoadingStateProps.surface`. */
     surface?: NFeedbackSurface;
 }
-declare function NErrorState({ title, message, onRetry, retryLabel, className, icon, surface, }: NErrorStateProps): react_jsx_runtime.JSX.Element;
+declare function NErrorState({ title, message, onRetry, retryLabel, className, icon, surface, }: NErrorStateProps): React__default.JSX.Element;
 
 interface NEmptyStateProps {
     title?: string;
@@ -145,7 +145,7 @@ interface NEmptyStateProps {
     /** Layout surface. See `NLoadingStateProps.surface`. */
     surface?: NFeedbackSurface;
 }
-declare function NEmptyState({ title, description, icon, action, className, surface, }: NEmptyStateProps): react_jsx_runtime.JSX.Element;
+declare function NEmptyState({ title, description, icon, action, className, surface, }: NEmptyStateProps): React__default.JSX.Element;
 
 /**
  * First-class "access denied" state.
@@ -160,7 +160,7 @@ interface NForbiddenStateProps extends NEmptyStateProps {
     title?: string;
     description?: string;
 }
-declare function NForbiddenState(props: NForbiddenStateProps): react_jsx_runtime.JSX.Element;
+declare function NForbiddenState(props: NForbiddenStateProps): React__default.JSX.Element;
 
 /**
  * First-class "page not found" state.
@@ -174,6 +174,6 @@ interface NNotFoundStateProps extends NEmptyStateProps {
     title?: string;
     description?: string;
 }
-declare function NNotFoundState(props: NNotFoundStateProps): react_jsx_runtime.JSX.Element;
+declare function NNotFoundState(props: NNotFoundStateProps): React__default.JSX.Element;
 
 export { type FormDevToolsOptions as F, type NBrandingInput as N, NEmptyState as a, type NEmptyStateProps as b, NErrorState as c, type NErrorStateProps as d, type NFeedbackSurface as e, NForbiddenState as f, type NForbiddenStateProps as g, NLoadingState as h, type NLoadingStateProps as i, NNotFoundState as j, type NNotFoundStateProps as k, type FormDevTools as l, type FormDevToolsConfig as m, type FormFillOverride as n, type FormFillOverrides as o, type NBrandingEditorValue as p, type NBrandingPayload as q, NBrandingProvider as r, NBrandingStateProvider as s, type NBrandingStateProviderProps as t, type NBrandingValue as u, buildFormFill as v, normalizeBranding as w, useNBranding as x, useNBrandingEditor as y };

package/dist/NTableJson-BHXwRVvL.d.ts

@@ -0,0 +1,5 @@
+import React__default from 'react';
+
+declare function NTableJson(): React__default.JSX.Element;
+
+export { NTableJson as N };

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

@@ -1,4 +1,3 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React from 'react';
 import React__default from 'react';
 import { e as NajmMode, a as NajmDesignConfig } from './design-types-Rkpt8Pg1.js';
@@ -6,6 +5,48 @@ import { b as NTablePaginationLabels, N as NajmTranslate } from './paginationLab
 import * as class_variance_authority_types from 'class-variance-authority/types';
 import { VariantProps } from 'class-variance-authority';
 
+/**
+ * Accessible names and visible copy for the toolbar above the rows.
+ *
+ * Every field is optional and falls back to English, matching
+ * `NTablePaginationLabels`. The settings menu is the motivating case: its
+ * headings and view-mode options are the only chrome in a localized table that
+ * a catalog could not previously reach, because they are built inside the kit
+ * rather than supplied per column.
+ */
+interface NTableToolbarLabels {
+    /** Accessible name of the settings trigger. Defaults to `"Table settings"`. */
+    settings?: string;
+    /** Heading above the view-mode group. Defaults to `"View"`. */
+    view?: string;
+    /** Heading above the column-visibility list. Defaults to `"Columns"`. */
+    columns?: string;
+    /** Visible name of the table view mode. Defaults to `"Table"`. */
+    modeTable?: string;
+    /** Visible name of the cards view mode. Defaults to `"Cards"`. */
+    modeCards?: string;
+    /** Visible name of the JSON view mode. Defaults to `"JSON"`. */
+    modeJson?: string;
+    /** Visible name of the files view mode. Defaults to `"Files"`. */
+    modeFiles?: string;
+    /**
+     * Accessible name of one view-mode option, given its visible name. Defaults
+     * to `` `${mode} view` ``.
+     *
+     * It must contain the visible name — voice control matches on what is on
+     * screen — so a translation reorders around the mode rather than replacing it.
+     */
+    modeOption?: (mode: string) => string;
+    /** Accessible name and tooltip of the mobile filters trigger. Defaults to `"Filters"`. */
+    filters?: string;
+    /** Accessible name of the filter row. Defaults to `"Table filters"`. */
+    filterRegion?: string;
+    /** The option that clears a select filter. Defaults to `"All"`. */
+    allOption?: string;
+    /** Accessible name of the add control when `addButtonText` is empty. Defaults to `"Create"`. */
+    create?: string;
+}
+
 /**
  * Defaults every `NTable` beneath the provider inherits.
  *
@@ -15,6 +56,7 @@ import { VariantProps } from 'class-variance-authority';
  */
 interface NTableDefaults {
     paginationLabels?: NTablePaginationLabels;
+    toolbarLabels?: NTableToolbarLabels;
 }
 /**
  * Supply table defaults to everything below.
@@ -27,8 +69,13 @@ interface NTableDefaults {
 declare function NTableDefaultsProvider({ children, value, }: {
     children: React__default.ReactNode;
     value: NTableDefaults;
-}): react_jsx_runtime.JSX.Element;
+}): React__default.JSX.Element;
 declare function useNTableDefaults(): NTableDefaults;
+/**
+ * Per-key merge for the toolbar copy, on the same terms as
+ * `useResolvedPaginationLabels`.
+ */
+declare function useResolvedToolbarLabels(own: NTableToolbarLabels | undefined): NTableToolbarLabels;
 
 type NIconSource = React__default.ReactElement | React__default.ComponentType<any> | React__default.ExoticComponent<any> | string | {
     src: string;
@@ -81,7 +128,7 @@ type BadgeProps = React.ComponentProps<"span"> & {
     iconMap?: Record<string, BadgeIcon>;
     iconPosition?: "left" | "right";
 };
-declare function Badge({ className, variant, status, statusMap, label, showIcon, color, look, size, shape, icon, iconMap, iconPosition, asChild, children, style, ...props }: BadgeProps): react_jsx_runtime.JSX.Element;
+declare function Badge({ className, variant, status, statusMap, label, showIcon, color, look, size, shape, icon, iconMap, iconPosition, asChild, children, style, ...props }: BadgeProps): React.JSX.Element;
 declare const NBadge: typeof Badge;
 type NBadgeLook = BadgeDisplayLook;
 type NBadgeProps = BadgeProps;
@@ -170,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.
@@ -223,7 +283,7 @@ interface NajmPreferencesProviderProps {
  * config and therefore has to sit above the provider consuming it. Hoisting
  * preferences out is then a reorder rather than a fork.
  */
-declare function NajmPreferencesProvider({ children, initialTheme, initialTimeZone, onThemeChange, onTimeZoneChange, normalizeTimeZone, }: NajmPreferencesProviderProps): react_jsx_runtime.JSX.Element;
+declare function NajmPreferencesProvider({ children, initialTheme, initialTimeZone, onThemeChange, onTimeZoneChange, normalizeTimeZone, }: NajmPreferencesProviderProps): React.JSX.Element;
 /**
  * Returns the context when one is mounted, or `null`.
  *
@@ -237,6 +297,28 @@ declare function useNajmTheme(): Pick<NajmPreferencesContextValue, "theme" | "se
 /** The live time zone and a setter that persists through `onTimeZoneChange`. */
 declare function useNajmTimeZone(): Pick<NajmPreferencesContextValue, "timeZone" | "setTimeZone">;
 
+type NajmDirection = "ltr" | "rtl";
+/**
+ * The document's writing direction, kept in sync with the `dir` attribute.
+ *
+ * Radix reads direction from its own `DirectionProvider` and defaults to
+ * `"ltr"`. It never consults the DOM, and it stamps that default onto every
+ * portaled `Content` element — so in an application that sets
+ * `<html dir="rtl">`, a dropdown or select popup renders LTR inside an
+ * otherwise RTL page, and the logical padding and inset utilities on its items
+ * resolve against the wrong side. Nothing bridged the two until this hook and
+ * the `DirectionProvider` above it.
+ *
+ * Reading the attribute rather than a language preference is deliberate: `dir`
+ * is what the browser itself lays out against, applications already set it, and
+ * a kit that inferred direction from a locale list would disagree with the page
+ * the moment an application supported a language the kit had not heard of.
+ *
+ * Server renders return `"ltr"` and the first client effect corrects it. That
+ * is not a hydration risk for the popups, which mount only on open.
+ */
+declare function useDocumentDirection(override?: NajmDirection): NajmDirection;
+
 interface NajmUIProviderProps extends Omit<NajmPreferencesProviderProps, "children"> {
     children: React.ReactNode;
     /**
@@ -279,6 +361,26 @@ interface NajmUIProviderProps extends Omit<NajmPreferencesProviderProps, "childr
     t?: NajmTranslate;
     /** Catalog prefix for the labels. Defaults to `"common.pagination"`. */
     paginationKeyPrefix?: string;
+    /**
+     * Catalog prefix for the table toolbar and settings menu. Defaults to
+     * `"common.table"`.
+     *
+     * These labels are built inside the kit rather than supplied per column, so
+     * this prefix is the only way a catalog reaches the view-mode options, the
+     * column-visibility heading, and the filter controls' accessible names.
+     */
+    toolbarKeyPrefix?: string;
+    /**
+     * Writing direction for the Radix popups beneath — menus, selects, and the
+     * rest of the portaled content.
+     *
+     * Omit it and the direction follows `<html dir>`, which is what an
+     * application already sets and what the browser lays the page out against.
+     * Radix defaults its own context to `"ltr"` and stamps that on every portaled
+     * element, so without this bridge an RTL page gets LTR popups. Pass a value
+     * only to pin one region against the document.
+     */
+    dir?: NajmDirection;
     /**
      * Per-key overrides layered over the translated labels. Memoize it, for the
      * same reason as `t`.
@@ -322,6 +424,6 @@ interface NajmUIProviderProps extends Omit<NajmPreferencesProviderProps, "childr
  * an application with a runtime theme editor hoist preferences above its
  * design context without forking this component.
  */
-declare function NajmUIProvider({ children, design, initialDesign, className, t, paginationKeyPrefix, tableDefaults, badgeDefaults, feedbackDefaults, initialTheme, initialTimeZone, onThemeChange, onTimeZoneChange, normalizeTimeZone, }: NajmUIProviderProps): react_jsx_runtime.JSX.Element;
+declare function NajmUIProvider({ children, design, initialDesign, className, t, paginationKeyPrefix, toolbarKeyPrefix, dir, tableDefaults, badgeDefaults, feedbackDefaults, initialTheme, initialTimeZone, onThemeChange, onTimeZoneChange, normalizeTimeZone, }: NajmUIProviderProps): React.JSX.Element;
 
-export { useNajmPreferencesContext as A, type BadgeColor as B, useNajmTheme as C, DEFAULT_TIME_ZONE as D, useNajmTimeZone as E, type NFeedbackDefaults as N, type NFeedbackLabelKeys as a, type NFeedbackLabels as b, type NajmUIProviderProps as c, type NIconSource as d, type BadgeShape as e, Badge as f, type BadgeIcon as g, type BadgeLook as h, type BadgeProps as i, type BadgeSize as j, type BadgeVariant as k, NBadge as l, type NBadgeDefaults as m, type NBadgeLook as n, type NBadgeProps as o, NIcon as p, type NIconProps as q, type NTableDefaults as r, NTableDefaultsProvider as s, type NajmPreferencesContextValue as t, NajmPreferencesProvider as u, type NajmPreferencesProviderProps as v, NajmUIProvider as w, badgeColorVariants as x, badgeVariants as y, useNTableDefaults 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

@@ -1,10 +1,9 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as React from 'react';
 import { Translations } from 'najm-i18n';
-import { F as FormDevToolsOptions, N as NBrandingInput } from '../NNotFoundState-D1CLLLxc.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-D1CLLLxc.js';
+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-cNCb8Tpn.js';
-import 'react';
+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';
@@ -34,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`.
@@ -111,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_runtime.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-W2HMBUZ4.mjs';
-export { NEmptyState, NErrorState, NForbiddenState, NLoadingState, NNotFoundState } from '../chunk-W2HMBUZ4.mjs';
-import { NajmNextUIProvider } from '../chunk-T6RL7TSQ.mjs';
-import '../chunk-6UDJNTJ6.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,7 +1,6 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
 import React__default from 'react';
 import { ImageProps } from 'next/image';
-import { c as NajmUIProviderProps } from '../NajmUIProvider-cNCb8Tpn.js';
+import { c as NajmUIProviderProps } from '../NajmUIProvider-DTyRrukg.js';
 import '../design-types-Rkpt8Pg1.js';
 import '../paginationLabels-dZLSNxfo.js';
 import 'class-variance-authority/types';
@@ -44,7 +43,7 @@ interface NNextImageProps extends Omit<ImageProps, 'src' | 'onError'> {
  * validation, permissions, and what bytes come back remain entirely the
  * backend's.
  */
-declare function NNextImage({ src, fallbackSrc, loading, priority, onError, ...props }: NNextImageProps): react_jsx_runtime.JSX.Element;
+declare function NNextImage({ src, fallbackSrc, loading, priority, onError, ...props }: NNextImageProps): React__default.JSX.Element;
 /** Where `NajmNextUIProvider` POSTs each preference. */
 interface NajmNextUIEndpoints {
     /** Defaults to `/api/ui-theme`. Receives `{ theme }`. */
@@ -73,6 +72,6 @@ interface NajmNextUIProviderProps extends Omit<NajmUIProviderProps, 'onThemeChan
  * `next` is an *optional* peer dependency: consumers of the root entry never
  * reach this file.
  */
-declare function NajmNextUIProvider({ endpoints, refreshOnChange, ...props }: NajmNextUIProviderProps): react_jsx_runtime.JSX.Element;
+declare function NajmNextUIProvider({ endpoints, refreshOnChange, ...props }: NajmNextUIProviderProps): React__default.JSX.Element;
 
 export { NNextImage, type NNextImageProps, type NajmNextUIEndpoints, NajmNextUIProvider, type NajmNextUIProviderProps, NextLinkAdapter, type NextLinkAdapterProps, useNextNavigationAdapter };

package/dist/adapters/next.mjs

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

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

@@ -1,4 +1,4 @@
-import { useResolvedFeedbackLabels, useNajmPreferencesContext } from './chunk-6UDJNTJ6.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';