najm-kit 2.7.0 → 2.7.1

package/dist/NBrandingContext-dkADu8JS.d.ts

@@ -0,0 +1,82 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+
+interface NBrandingValue {
+    /** Used as the logo's `alt` when the logo does not set one. */
+    appName?: string;
+    logoExpanded?: ReactNode | string;
+    /** Falls back to `logoExpanded`. */
+    logoCollapsed?: ReactNode | string;
+    /** Swapped in when a `string` logo fails to load. */
+    logoFallback?: string;
+    logoHref?: string;
+}
+/**
+ * What a Najm branding endpoint returns, as the marks the chrome needs.
+ *
+ * Accepted anywhere branding goes *in* so an application hands over its API
+ * payload unchanged instead of renaming two fields at every call site. Fields
+ * beyond these are ignored: excess-property checks only fire on object
+ * literals, so passing a wider response object — auth logos, a revision — type
+ * checks and drops what the chrome has no use for.
+ */
+interface NBrandingPayload {
+    sidebarLogoExpandedPath?: string | null;
+    sidebarLogoCollapsedPath?: string | null;
+}
+/** Resolved marks, an endpoint payload, or both. */
+type NBrandingInput = NBrandingValue & NBrandingPayload;
+/**
+ * Projects an input onto the marks `useNBranding` publishes.
+ *
+ * Explicit marks win over payload fields, so an application already passing
+ * `logoExpanded` — or a `ReactNode` logo, which no payload can express — is
+ * unaffected by the wider input type.
+ */
+declare function normalizeBranding(input?: NBrandingInput): NBrandingValue;
+/** Returns `null` outside a provider, so every consumer stays optional. */
+declare function useNBranding(): NBrandingValue | null;
+/**
+ * Publishes the app's marks once, so shells stop threading a `logo` through
+ * every surface that shows one. `NSidebar` reads this when no `logo` prop is
+ * given; an explicit `logo` always wins.
+ *
+ * Unlike `NSidebarProvider` this owns no state — the values are resolved by the
+ * app (usually server-side) and only forwarded, so memoizing on the fields is
+ * correct here.
+ */
+declare function NBrandingProvider({ children, appName, logoExpanded, logoCollapsed, logoFallback, logoHref, }: Readonly<NBrandingValue & {
+    children: ReactNode;
+}>): react_jsx_runtime.JSX.Element;
+interface NBrandingEditorValue {
+    branding: NBrandingValue;
+    /**
+     * Merges a patch over the current marks. Inert while controlled.
+     *
+     * Takes the endpoint payload shape too, so a settings surface hands back the
+     * response it just received rather than renaming its fields first.
+     */
+    setBranding: (patch: NBrandingInput) => void;
+}
+/**
+ * Lets a settings surface swap the app's marks without a reload.
+ *
+ * Returns `null` outside `NBrandingStateProvider`, so a branding editor stays
+ * mountable in an app that resolves its logos once and never changes them.
+ *
+ * Only the *display* values live here. Where the assets are stored, who may
+ * replace them, and what happens to a superseded upload are the application's
+ * concerns, and folding them in would make this a branding backend.
+ */
+declare function useNBrandingEditor(): NBrandingEditorValue | null;
+interface NBrandingStateProviderProps {
+    children: ReactNode;
+    /** Controlled marks. When given, `setBranding` is inert. */
+    branding?: NBrandingInput;
+    /** Seeds marks this provider owns from then on; ignored after mount. */
+    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;
+
+export { type NBrandingInput as N, type NBrandingEditorValue as a, type NBrandingPayload as b, NBrandingProvider as c, NBrandingStateProvider as d, type NBrandingStateProviderProps as e, type NBrandingValue as f, useNBrandingEditor as g, normalizeBranding as n, useNBranding as u };

package/dist/{NajmUIProvider-BsCoDjHH.d.ts → NajmUIProvider-Dj32bd5d.d.ts}

@@ -328,7 +328,13 @@ interface NajmPreferencesProviderProps {
     onThemeChange?: (theme: NajmMode) => void | Promise<void>;
     /** Persist the new time zone. Rejections propagate to `setTimeZone`. */
     onTimeZoneChange?: (timeZone: string) => void | Promise<void>;
-    /** Sanitize a time zone before it is stored. Defaults to identity. */
+    /**
+     * Sanitize a time zone before it is stored.
+     *
+     * Defaults to an IANA check that falls back to `DEFAULT_TIME_ZONE`, which is
+     * what every application wanted from the callback it used to have to supply.
+     * Pass one to narrow further — a fixed set backing a picker, say.
+     */
     normalizeTimeZone?: (value: string) => string;
 }
 /**
@@ -382,14 +388,34 @@ declare function buildPaginationLabels(t: NajmTranslate, prefix?: string): NTabl
 interface NajmUIProviderProps extends Omit<NajmPreferencesProviderProps, "children"> {
     children: React$1.ReactNode;
     /**
-     * The design config handed to `NajmDesignProvider`.
+     * The design config handed to `NajmDesignProvider`, owned by the application.
      *
      * Optional, and deliberately so: an application with no runtime theme editor
      * has nothing to put here, and requiring it was the only reason such an
      * application still had to author a provider file just to hold a constant.
+     *
+     * Prefer `initialDesign` for a theme editor. Passing `design` means the
+     * application holds the draft state itself, which is the file this provider
+     * exists to delete.
      */
     design?: NajmDesignConfig;
-    /** Forwarded to `NajmDesignProvider`. */
+    /**
+     * Seeds design state this provider owns from then on; ignored after mount.
+     * A theme editor drives it through `useNajmDesignEditor`.
+     */
+    initialDesign?: NajmDesignConfig;
+    /**
+     * Forwarded to `NajmDesignProvider`, merged over a `min-h-full` default.
+     *
+     * The default is not decoration. `NajmThemeProvider` renders a real `div`
+     * between the document body and the application, and a block box of
+     * automatic height severs any `h-full` chain below it — every application
+     * mounting this at the root was passing the same class back to repair that.
+     * It is inert where it is not needed: a percentage `min-height` against an
+     * auto-height parent imposes no constraint.
+     *
+     * Merged with `cn`, so a conflicting utility here still wins.
+     */
     className?: string;
     /**
      * Translator for the pagination labels. Omit it and the packaged English
@@ -426,6 +452,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, className, t, paginationKeyPrefix, tableDefaults, initialTheme, initialTimeZone, onThemeChange, onTimeZoneChange, normalizeTimeZone, }: NajmUIProviderProps): react_jsx_runtime.JSX.Element;
+declare function NajmUIProvider({ children, design, initialDesign, className, t, paginationKeyPrefix, tableDefaults, initialTheme, initialTimeZone, onThemeChange, onTimeZoneChange, normalizeTimeZone, }: NajmUIProviderProps): react_jsx_runtime.JSX.Element;
 
-export { type NajmDensity as A, type NajmPreferencesContextValue as B, NajmPreferencesProvider as C, DEFAULT_PAGINATION_KEY_PREFIX as D, type NajmPreferencesProviderProps as E, type NajmSlotStyle as F, type NajmTranslate as G, NajmUIProvider as H, buildPaginationLabels as I, resolveRadiusValue as J, useNTableDefaults as K, useNajmPreferencesContext as L, useNajmTheme as M, type NajmUIProviderProps as N, useNajmTimeZone as O, RADIUS_VALUE_MAP as R, type NajmThemeProviderProps as a, type NajmAppearance as b, type NajmMode as c, type NajmDesignConfig as d, type NajmThemeConfig as e, type NajmAccent as f, type NajmThemeTokens as g, type NajmPreset as h, type NajmComponentName as i, type NajmComponentStyleConfig as j, type NajmComponentThemeConfig as k, type NajmTypographyConfig as l, type NajmLayoutConfig as m, type NajmVariantStyle as n, type NTablePaginationVariant as o, type NTablePaginationLabels as p, type NTableCardPagination as q, type NajmResponsiveBreakpoint as r, type NajmResponsiveValue as s, DEFAULT_TIME_ZONE as t, NAJM_COMPONENT_NAMES as u, type NTableDefaults as v, NTableDefaultsProvider as w, type NTableInfinitePagination as x, type NTableLoadMorePagination as y, type NajmComponentRadius as z };
+export { type NajmDensity as A, type NajmPreferencesContextValue as B, NajmPreferencesProvider as C, DEFAULT_PAGINATION_KEY_PREFIX as D, type NajmPreferencesProviderProps as E, type NajmSlotStyle as F, type NajmTranslate as G, NajmUIProvider as H, buildPaginationLabels as I, resolveRadiusValue as J, useNTableDefaults as K, useNajmPreferencesContext as L, useNajmTheme as M, type NajmUIProviderProps as N, useNajmTimeZone as O, RADIUS_VALUE_MAP as R, type NajmDesignConfig as a, type NajmThemeProviderProps as b, type NajmAppearance as c, type NajmMode as d, type NajmThemeConfig as e, type NajmAccent as f, type NajmThemeTokens as g, type NajmPreset as h, type NajmComponentName as i, type NajmComponentStyleConfig as j, type NajmComponentThemeConfig as k, type NajmTypographyConfig as l, type NajmLayoutConfig as m, type NajmVariantStyle as n, type NTablePaginationVariant as o, type NTablePaginationLabels as p, type NTableCardPagination as q, type NajmResponsiveBreakpoint as r, type NajmResponsiveValue as s, DEFAULT_TIME_ZONE as t, NAJM_COMPONENT_NAMES as u, type NTableDefaults as v, NTableDefaultsProvider as w, type NTableInfinitePagination as x, type NTableLoadMorePagination as y, type NajmComponentRadius as z };

package/dist/adapters/app.d.ts

@@ -1,8 +1,9 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { Translations } from 'najm-i18n';
+import { N as NBrandingInput } from '../NBrandingContext-dkADu8JS.js';
 import { NajmNextUIProviderProps } from './next.js';
 import 'react';
-import '../NajmUIProvider-BsCoDjHH.js';
+import '../NajmUIProvider-Dj32bd5d.js';
 
 /** Branding shown by the kit's chrome. Purely presentational values. */
 interface NajmAppBranding {
@@ -29,7 +30,30 @@ interface NajmAppProviderProps extends Omit<NajmNextUIProviderProps, 't'> {
      * would discard that work to re-render the same strings from the server.
      */
     languageEndpoint?: string;
-    branding?: NajmAppBranding;
+    /**
+     * The product name, used as the logo's `alt` and by the kit's chrome.
+     *
+     * Separate from `initialBranding` because it is a constant rather than
+     * something a branding editor swaps, and because it is the one mark no
+     * branding endpoint returns. An `appName` inside `initialBranding` wins.
+     */
+    appName?: string;
+    /**
+     * Controlled marks. Prefer `initialBranding` — passing this means the
+     * application holds the state itself, which is the file this provider exists
+     * to delete.
+     */
+    branding?: NBrandingInput;
+    /**
+     * Seeds marks this provider owns from then on; ignored after mount. A
+     * branding editor swaps them through `useNBrandingEditor`.
+     *
+     * Takes a branding endpoint's payload as-is — `sidebarLogoExpandedPath` and
+     * `sidebarLogoCollapsedPath` are read straight off it, and unrelated fields
+     * are ignored — so the application forwards its response rather than
+     * renaming two keys here.
+     */
+    initialBranding?: NBrandingInput;
 }
 /**
  * The whole UI provider stack for a Najm application, as one component.
@@ -43,9 +67,13 @@ interface NajmAppProviderProps extends Omit<NajmNextUIProviderProps, 't'> {
  * and an application that wants different query policy should not have to fork
  * a provider to get it. Mount them above this, from their own packages.
  *
- * Design is optional. Applications that resolve a design config at runtime — a
- * theme editor — compute it above and pass it down; everything else omits it.
+ * Design and branding are optional, and both are *uncontrolled* through their
+ * `initial*` props: an application with a runtime theme or branding editor
+ * seeds them from the server once and drives them afterwards through
+ * `useNajmDesignEditor` and `useNBrandingEditor`, rather than holding a draft
+ * 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, ...props }: NajmAppProviderProps): react_jsx_runtime.JSX.Element;
+declare function NajmAppProvider({ translations, initialLanguage, defaultLanguage, languageEndpoint, appName, initialBranding, ...props }: NajmAppProviderProps): react_jsx_runtime.JSX.Element;
 
 export { type NajmAppBranding, NajmAppProvider, type NajmAppProviderProps };

package/dist/adapters/app.mjs

@@ -1,32 +1,40 @@
 'use client';
-import { NBrandingProvider } from '../chunk-IGUQGT3G.mjs';
-import { NajmNextUIProvider } from '../chunk-4MRUJ2ZO.mjs';
-import '../chunk-7F65QM43.mjs';
-import '../chunk-YBM5CTE6.mjs';
+import { NBrandingStateProvider } from '../chunk-5LW62RB6.mjs';
+import { NajmNextUIProvider } from '../chunk-IRFFSAO2.mjs';
+import '../chunk-USZUOJMK.mjs';
+import '../chunk-KVZACF4G.mjs';
 import * as React from 'react';
 import { I18nProvider, useTranslation } from 'najm-i18n/react';
 import { jsx } from 'react/jsx-runtime';
 
 var DEFAULT_LANGUAGE_ENDPOINT = "/api/ui-language";
-function NajmAppUI({ children, branding, ...props }) {
+function NajmAppUI({
+  children,
+  branding,
+  initialBranding,
+  ...props
+}) {
   const { t } = useTranslation();
   return /* @__PURE__ */ jsx(NajmNextUIProvider, { t, ...props, children: /* @__PURE__ */ jsx(
-    NBrandingProvider,
+    NBrandingStateProvider,
     {
-      appName: branding?.appName,
-      logoExpanded: branding?.logoExpanded,
-      logoCollapsed: branding?.logoCollapsed,
+      branding,
+      initialBranding,
       children
     }
   ) });
 }
-function NajmAppNoI18n({ children, branding, ...props }) {
+function NajmAppNoI18n({
+  children,
+  branding,
+  initialBranding,
+  ...props
+}) {
   return /* @__PURE__ */ jsx(NajmNextUIProvider, { ...props, children: /* @__PURE__ */ jsx(
-    NBrandingProvider,
+    NBrandingStateProvider,
     {
-      appName: branding?.appName,
-      logoExpanded: branding?.logoExpanded,
-      logoCollapsed: branding?.logoCollapsed,
+      branding,
+      initialBranding,
       children
     }
   ) });
@@ -36,6 +44,8 @@ function NajmAppProvider({
   initialLanguage,
   defaultLanguage,
   languageEndpoint = DEFAULT_LANGUAGE_ENDPOINT,
+  appName,
+  initialBranding,
   ...props
 }) {
   const persistLanguage = React.useCallback(
@@ -54,7 +64,8 @@ function NajmAppProvider({
     },
     [languageEndpoint]
   );
-  if (!translations) return /* @__PURE__ */ jsx(NajmAppNoI18n, { ...props });
+  const seeded = appName ? { appName, ...initialBranding } : initialBranding;
+  if (!translations) return /* @__PURE__ */ jsx(NajmAppNoI18n, { ...props, initialBranding: seeded });
   return /* @__PURE__ */ jsx(
     I18nProvider,
     {
@@ -62,7 +73,7 @@ function NajmAppProvider({
       initialLanguage: initialLanguage ?? defaultLanguage ?? "en",
       defaultLanguage,
       onLanguageChange: persistLanguage,
-      children: /* @__PURE__ */ jsx(NajmAppUI, { ...props })
+      children: /* @__PURE__ */ jsx(NajmAppUI, { ...props, initialBranding: seeded })
     }
   );
 }

package/dist/adapters/next.d.ts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React__default from 'react';
-import { N as NajmUIProviderProps } from '../NajmUIProvider-BsCoDjHH.js';
+import { N as NajmUIProviderProps } from '../NajmUIProvider-Dj32bd5d.js';
 
 interface NextLinkAdapterProps extends Record<string, any> {
     href: string;

package/dist/adapters/next.mjs

@@ -1,3 +1,3 @@
-export { NajmNextUIProvider, NextLinkAdapter, useNextNavigationAdapter } from '../chunk-4MRUJ2ZO.mjs';
-import '../chunk-7F65QM43.mjs';
-import '../chunk-YBM5CTE6.mjs';
+export { NajmNextUIProvider, NextLinkAdapter, useNextNavigationAdapter } from '../chunk-IRFFSAO2.mjs';
+import '../chunk-USZUOJMK.mjs';
+import '../chunk-KVZACF4G.mjs';

package/dist/chunk-5LW62RB6.mjs

@@ -0,0 +1,65 @@
+import { createContext, useContext, useMemo, useState, useCallback } from 'react';
+import { jsx } from 'react/jsx-runtime';
+
+// src/components/branding/NBrandingContext.tsx
+function normalizeBranding(input) {
+  if (!input) return {};
+  const value = {};
+  const expanded = input.logoExpanded ?? input.sidebarLogoExpandedPath;
+  const collapsed = input.logoCollapsed ?? input.sidebarLogoCollapsedPath;
+  if (input.appName !== void 0) value.appName = input.appName;
+  if (input.logoFallback !== void 0) value.logoFallback = input.logoFallback;
+  if (input.logoHref !== void 0) value.logoHref = input.logoHref;
+  if (expanded !== void 0) value.logoExpanded = expanded;
+  if (collapsed !== void 0) value.logoCollapsed = collapsed;
+  return value;
+}
+var NBrandingContext = createContext(null);
+function useNBranding() {
+  return useContext(NBrandingContext);
+}
+function NBrandingProvider({
+  children,
+  appName,
+  logoExpanded,
+  logoCollapsed,
+  logoFallback,
+  logoHref
+}) {
+  const value = useMemo(
+    () => ({ appName, logoExpanded, logoCollapsed, logoFallback, logoHref }),
+    [appName, logoExpanded, logoCollapsed, logoFallback, logoHref]
+  );
+  return /* @__PURE__ */ jsx(NBrandingContext.Provider, { value, children });
+}
+var NBrandingEditorContext = createContext(null);
+function useNBrandingEditor() {
+  return useContext(NBrandingEditorContext);
+}
+function NBrandingStateProvider({
+  children,
+  branding,
+  initialBranding
+}) {
+  const [state, setState] = useState(
+    () => normalizeBranding(initialBranding ?? branding)
+  );
+  const setBranding = useCallback((patch) => {
+    const marks = normalizeBranding(patch);
+    setState((current) => ({ ...current, ...marks }));
+  }, []);
+  const controlled = useMemo(
+    () => branding ? normalizeBranding(branding) : void 0,
+    [branding]
+  );
+  const resolved = controlled ?? state;
+  const editor = useMemo(
+    () => ({ branding: resolved, setBranding: branding ? noop : setBranding }),
+    [resolved, branding, setBranding]
+  );
+  return /* @__PURE__ */ jsx(NBrandingEditorContext.Provider, { value: editor, children: /* @__PURE__ */ jsx(NBrandingProvider, { ...resolved, children }) });
+}
+function noop() {
+}
+
+export { NBrandingProvider, NBrandingStateProvider, normalizeBranding, useNBranding, useNBrandingEditor };

package/dist/{chunk-4DLRXB2W.mjs → chunk-6OOBAEH2.mjs}

@@ -1,6 +1,4 @@
-import { useNajmComponentStyle } from './chunk-YBM5CTE6.mjs';
-import { clsx } from 'clsx';
-import { twMerge } from 'tailwind-merge';
+import { useNajmComponentStyle, cn } from './chunk-KVZACF4G.mjs';
 import * as React2 from 'react';
 import React2__default, { createContext, useContext } from 'react';
 import * as LucideIcons from 'lucide-react';
@@ -11,9 +9,6 @@ import { cva } from 'class-variance-authority';
 import { OverlayScrollbars } from 'overlayscrollbars';
 import { OverlayScrollbarsComponent } from 'overlayscrollbars-react';
 
-function cn(...inputs) {
-  return twMerge(clsx(inputs));
-}
 function toPascalCase(value) {
   return value.replace(/([a-z0-9])([A-Z])/g, "$1 $2").split(/[\s_-]+/).filter(Boolean).map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join("");
 }
@@ -829,4 +824,4 @@ function NTableJson() {
   return /* @__PURE__ */ jsx("div", { className: "flex-1 flex flex-col min-h-0 overflow-hidden", children: renderJson?.() ?? /* @__PURE__ */ jsx(NajmScroll, { axis: "both", className: "h-full min-h-0 rounded-md border border-border bg-muted/40", children: /* @__PURE__ */ jsx("pre", { className: "p-4 font-mono text-xs leading-relaxed text-foreground", children: formatJsonValue(jsonValue) }) }) });
 }
 
-export { Button, NAJM_COMPONENT_NAMES, NButton, NIcon, NTableJson, NajmScroll, RADIUS_VALUE_MAP, TableStoreContext, buttonVariants, cn, defineNajmDesignConfig, defineNajmThemeConfig, inputBorderClasses, parseNajmDesignConfig, parseNajmThemeConfig, resolveRadiusValue, resolveVariantAlias, sidebarBorderClasses, stringifyNajmDesignConfig, stringifyNajmThemeConfig, surfaceBorderClasses, useNajmScrollViewport, useTableStore };
+export { Button, NAJM_COMPONENT_NAMES, NButton, NIcon, NTableJson, NajmScroll, RADIUS_VALUE_MAP, TableStoreContext, buttonVariants, defineNajmDesignConfig, defineNajmThemeConfig, inputBorderClasses, parseNajmDesignConfig, parseNajmThemeConfig, resolveRadiusValue, resolveVariantAlias, sidebarBorderClasses, stringifyNajmDesignConfig, stringifyNajmThemeConfig, surfaceBorderClasses, useNajmScrollViewport, useTableStore };

package/dist/{chunk-4MRUJ2ZO.mjs → chunk-IRFFSAO2.mjs}

@@ -1,4 +1,4 @@
-import { NajmUIProvider } from './chunk-7F65QM43.mjs';
+import { NajmUIProvider } from './chunk-USZUOJMK.mjs';
 import React from 'react';
 import { useRouter } from 'next/navigation';
 import { jsx } from 'react/jsx-runtime';

package/dist/{chunk-YBM5CTE6.mjs → chunk-KVZACF4G.mjs}

@@ -1,6 +1,8 @@
 import * as React from 'react';
 import { Slot } from '@radix-ui/react-slot';
 import { jsx } from 'react/jsx-runtime';
+import { clsx } from 'clsx';
+import { twMerge } from 'tailwind-merge';
 
 // src/theme/presets/modes.ts
 var lightMode = {
@@ -301,6 +303,9 @@ function NajmThemeProvider({
     }
   ) }) }) }) });
 }
+function cn(...inputs) {
+  return twMerge(clsx(inputs));
+}
 var NajmDesignContext = React.createContext({
   components: {}
 });
@@ -363,4 +368,4 @@ function NajmDesignProvider({
   ) : children }) });
 }
 
-export { NajmDesignProvider, NajmThemeContainerCtx, NajmThemeProvider, composePreset, resolvePreset, useNajmAppearance, useNajmComponentStyle, useNajmDesign, useNajmThemeMode };
+export { NajmDesignProvider, NajmThemeContainerCtx, NajmThemeProvider, cn, composePreset, resolvePreset, useNajmAppearance, useNajmComponentStyle, useNajmDesign, useNajmThemeMode };

package/dist/{chunk-7F65QM43.mjs → chunk-USZUOJMK.mjs}

@@ -1,4 +1,4 @@
-import { NajmDesignProvider } from './chunk-YBM5CTE6.mjs';
+import { NajmDesignProvider, cn } from './chunk-KVZACF4G.mjs';
 import * as React2 from 'react';
 import React2__default from 'react';
 import { jsx } from 'react/jsx-runtime';
@@ -23,6 +23,17 @@ function useResolvedPaginationLabels(own) {
 }
 var NajmPreferencesContext = React2.createContext(null);
 var DEFAULT_TIME_ZONE = "UTC";
+function isValidTimeZone(value) {
+  try {
+    new Intl.DateTimeFormat(void 0, { timeZone: value });
+    return true;
+  } catch {
+    return false;
+  }
+}
+function defaultNormalizeTimeZone(value) {
+  return isValidTimeZone(value) ? value : DEFAULT_TIME_ZONE;
+}
 function applyTheme(theme) {
   if (typeof document === "undefined") return;
   document.documentElement.classList.toggle("dark", theme === "dark");
@@ -37,11 +48,11 @@ function NajmPreferencesProvider({
   initialTimeZone = DEFAULT_TIME_ZONE,
   onThemeChange,
   onTimeZoneChange,
-  normalizeTimeZone
+  normalizeTimeZone = defaultNormalizeTimeZone
 }) {
   const [theme, setThemeState] = React2.useState(initialTheme);
   const [timeZone, setTimeZoneState] = React2.useState(
-    () => normalizeTimeZone ? normalizeTimeZone(initialTimeZone) : initialTimeZone
+    () => normalizeTimeZone(initialTimeZone)
   );
   const onThemeChangeRef = React2.useRef(onThemeChange);
   const onTimeZoneChangeRef = React2.useRef(onTimeZoneChange);
@@ -61,7 +72,7 @@ function NajmPreferencesProvider({
     await onThemeChangeRef.current?.(next);
   }, []);
   const setTimeZone = React2.useCallback(async (next) => {
-    const normalized = normalizeRef.current ? normalizeRef.current(next) : next;
+    const normalized = normalizeRef.current(next);
     setTimeZoneState(normalized);
     applyTimeZone(normalized);
     await onTimeZoneChangeRef.current?.(normalized);
@@ -119,26 +130,95 @@ var EMPTY_DESIGN = Object.freeze({
   theme: {},
   components: {}
 });
+var NajmDesignEditorContext = React2.createContext(null);
+function useNajmDesignEditor() {
+  return React2.useContext(NajmDesignEditorContext);
+}
+function cloneDesign(design) {
+  return structuredClone(design);
+}
+function NajmDesignEditorProvider({
+  children,
+  design,
+  initialDesign
+}) {
+  const [state, setState] = React2.useState(() => ({
+    committed: initialDesign ?? design ?? EMPTY_DESIGN,
+    draft: null
+  }));
+  const beginDraft = React2.useCallback(() => {
+    setState(
+      (current) => current.draft ? current : { ...current, draft: cloneDesign(current.committed) }
+    );
+  }, []);
+  const setDraft = React2.useCallback((next) => {
+    setState((current) => ({ ...current, draft: cloneDesign(next) }));
+  }, []);
+  const cancelDraft = React2.useCallback(() => {
+    setState(
+      (current) => current.draft === null ? current : { ...current, draft: null }
+    );
+  }, []);
+  const setCommitted = React2.useCallback((next) => {
+    setState({ committed: next, draft: null });
+  }, []);
+  const value = React2.useMemo(() => {
+    if (design) {
+      return {
+        design,
+        committed: design,
+        draft: null,
+        hasDraft: false,
+        beginDraft: noop,
+        setDraft: noop,
+        cancelDraft: noop,
+        setCommitted: noop
+      };
+    }
+    return {
+      design: state.draft ?? state.committed,
+      committed: state.committed,
+      draft: state.draft,
+      hasDraft: state.draft !== null,
+      beginDraft,
+      setDraft,
+      cancelDraft,
+      setCommitted
+    };
+  }, [design, state, beginDraft, setDraft, cancelDraft, setCommitted]);
+  return /* @__PURE__ */ jsx(NajmDesignEditorContext.Provider, { value, children });
+}
+function noop() {
+}
 function NajmUICore({
   children,
-  design = EMPTY_DESIGN,
   className,
   t,
   paginationKeyPrefix = DEFAULT_PAGINATION_KEY_PREFIX,
   tableDefaults
 }) {
   const { theme } = useNajmTheme();
+  const design = useNajmDesignEditor()?.design ?? EMPTY_DESIGN;
   const defaults = React2.useMemo(() => {
     const translated = t ? buildPaginationLabels(t, paginationKeyPrefix) : void 0;
     const overrides = tableDefaults?.paginationLabels;
     const paginationLabels = translated || overrides ? { ...translated, ...overrides } : void 0;
     return { ...tableDefaults, paginationLabels };
   }, [t, paginationKeyPrefix, tableDefaults]);
-  return /* @__PURE__ */ jsx(NajmDesignProvider, { config: design, mode: theme, className, children: /* @__PURE__ */ jsx(NTableDefaultsProvider, { value: defaults, children }) });
+  return /* @__PURE__ */ jsx(
+    NajmDesignProvider,
+    {
+      config: design,
+      mode: theme,
+      className: cn("min-h-full", className),
+      children: /* @__PURE__ */ jsx(NTableDefaultsProvider, { value: defaults, children })
+    }
+  );
 }
 function NajmUIProvider({
   children,
   design,
+  initialDesign,
   className,
   t,
   paginationKeyPrefix,
@@ -150,17 +230,16 @@ function NajmUIProvider({
   normalizeTimeZone
 }) {
   const outerPreferences = useNajmPreferencesContext();
-  const core = /* @__PURE__ */ jsx(
+  const core = /* @__PURE__ */ jsx(NajmDesignEditorProvider, { design, initialDesign, children: /* @__PURE__ */ jsx(
     NajmUICore,
     {
-      design,
       className,
       t,
       paginationKeyPrefix,
       tableDefaults,
       children
     }
-  );
+  ) });
   if (outerPreferences) return core;
   return /* @__PURE__ */ jsx(
     NajmPreferencesProvider,
@@ -175,4 +254,4 @@ function NajmUIProvider({
   );
 }
 
-export { DEFAULT_PAGINATION_KEY_PREFIX, DEFAULT_TIME_ZONE, NTableDefaultsProvider, NajmPreferencesProvider, NajmUIProvider, buildPaginationLabels, useNTableDefaults, useNajmPreferencesContext, useNajmTheme, useNajmTimeZone, useResolvedPaginationLabels };
+export { DEFAULT_PAGINATION_KEY_PREFIX, DEFAULT_TIME_ZONE, EMPTY_DESIGN, NTableDefaultsProvider, NajmDesignEditorProvider, NajmPreferencesProvider, NajmUIProvider, buildPaginationLabels, useNTableDefaults, useNajmDesignEditor, useNajmPreferencesContext, useNajmTheme, useNajmTimeZone, useResolvedPaginationLabels };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { a as NajmThemeProviderProps, b as NajmAppearance, c as NajmMode, d as NajmDesignConfig, e as NajmThemeConfig, f as NajmAccent, g as NajmThemeTokens, h as NajmPreset, i as NajmComponentName, j as NajmComponentStyleConfig, k as NajmComponentThemeConfig, l as NajmTypographyConfig, m as NajmLayoutConfig, n as NajmVariantStyle, o as NTablePaginationVariant, p as NTablePaginationLabels, q as NTableCardPagination, r as NajmResponsiveBreakpoint, s as NajmResponsiveValue } from './NajmUIProvider-BsCoDjHH.js';
-export { D as DEFAULT_PAGINATION_KEY_PREFIX, t as DEFAULT_TIME_ZONE, u as NAJM_COMPONENT_NAMES, v as NTableDefaults, w as NTableDefaultsProvider, x as NTableInfinitePagination, y as NTableLoadMorePagination, z as NajmComponentRadius, A as NajmDensity, B as NajmPreferencesContextValue, C as NajmPreferencesProvider, E as NajmPreferencesProviderProps, F as NajmSlotStyle, G as NajmTranslate, H as NajmUIProvider, N as NajmUIProviderProps, R as RADIUS_VALUE_MAP, I as buildPaginationLabels, J as resolveRadiusValue, K as useNTableDefaults, L as useNajmPreferencesContext, M as useNajmTheme, O as useNajmTimeZone } from './NajmUIProvider-BsCoDjHH.js';
+import { a as NajmDesignConfig, b as NajmThemeProviderProps, c as NajmAppearance, d as NajmMode, e as NajmThemeConfig, f as NajmAccent, g as NajmThemeTokens, h as NajmPreset, i as NajmComponentName, j as NajmComponentStyleConfig, k as NajmComponentThemeConfig, l as NajmTypographyConfig, m as NajmLayoutConfig, n as NajmVariantStyle, o as NTablePaginationVariant, p as NTablePaginationLabels, q as NTableCardPagination, r as NajmResponsiveBreakpoint, s as NajmResponsiveValue } from './NajmUIProvider-Dj32bd5d.js';
+export { D as DEFAULT_PAGINATION_KEY_PREFIX, t as DEFAULT_TIME_ZONE, u as NAJM_COMPONENT_NAMES, v as NTableDefaults, w as NTableDefaultsProvider, x as NTableInfinitePagination, y as NTableLoadMorePagination, z as NajmComponentRadius, A as NajmDensity, B as NajmPreferencesContextValue, C as NajmPreferencesProvider, E as NajmPreferencesProviderProps, F as NajmSlotStyle, G as NajmTranslate, H as NajmUIProvider, N as NajmUIProviderProps, R as RADIUS_VALUE_MAP, I as buildPaginationLabels, J as resolveRadiusValue, K as useNTableDefaults, L as useNajmPreferencesContext, M as useNajmTheme, O as useNajmTimeZone } from './NajmUIProvider-Dj32bd5d.js';
 import * as React$1 from 'react';
 import React__default, { RefObject, ReactNode, ComponentType, InputHTMLAttributes, Ref, ImgHTMLAttributes, CSSProperties, MouseEvent, MouseEventHandler } from 'react';
 import * as class_variance_authority_types from 'class-variance-authority/types';
@@ -20,6 +20,7 @@ import * as TooltipPrimitive from '@radix-ui/react-tooltip';
 import * as ProgressPrimitive from '@radix-ui/react-progress';
 import * as SeparatorPrimitive from '@radix-ui/react-separator';
 import { OverlayScrollbarsComponentProps } from 'overlayscrollbars-react';
+export { a as NBrandingEditorValue, N as NBrandingInput, b as NBrandingPayload, c as NBrandingProvider, d as NBrandingStateProvider, e as NBrandingStateProviderProps, f as NBrandingValue, n as normalizeBranding, u as useNBranding, g as useNBrandingEditor } from './NBrandingContext-dkADu8JS.js';
 import * as AvatarPrimitive from '@radix-ui/react-avatar';
 import { Command as Command$1 } from 'cmdk';
 import * as CollapsiblePrimitive from '@radix-ui/react-collapsible';
@@ -38,6 +39,56 @@ export { N as NTableJson } from './NTableJson-tXqgfZI1.js';
 import * as _tanstack_table_core from '@tanstack/table-core';
 import { ClassValue } from 'clsx';
 
+/**
+ * Shared so the identity is stable across renders — `NajmDesignProvider`
+ * memoizes on `config.components`, `config.typography` and `config.layout`, and
+ * a fresh literal here would invalidate that on every render of the tree.
+ */
+declare const EMPTY_DESIGN: NajmDesignConfig;
+interface NajmDesignEditorValue {
+    /** `draft ?? committed`. What the tree is currently rendered against. */
+    design: NajmDesignConfig;
+    /** The last design the application saved. */
+    committed: NajmDesignConfig;
+    /** The unsaved edit layered over `committed`, or `null`. */
+    draft: NajmDesignConfig | null;
+    hasDraft: boolean;
+    /** Clones `committed` into a draft. A no-op while one is already open. */
+    beginDraft: () => void;
+    setDraft: (design: NajmDesignConfig) => void;
+    cancelDraft: () => void;
+    /** Adopt a design the application persisted, discarding any draft. */
+    setCommitted: (design: NajmDesignConfig) => void;
+}
+/**
+ * The draft/commit layer a runtime theme editor needs.
+ *
+ * Returns `null` outside a provider, so a component that only *offers* theme
+ * editing stays mountable in an application that has none.
+ *
+ * The editor holds no opinion about persistence: an application saves through
+ * whatever its own API is, then hands the result back via `setCommitted`. That
+ * is the same split `NajmPreferencesProvider` draws for theme and time zone.
+ */
+declare function useNajmDesignEditor(): NajmDesignEditorValue | null;
+interface NajmDesignEditorProviderProps {
+    children: React$1.ReactNode;
+    /**
+     * Controlled design. When given, this provider only forwards it and every
+     * command below is inert — the application already owns the state.
+     */
+    design?: NajmDesignConfig;
+    /**
+     * Seeds design state this provider owns from then on; ignored after mount.
+     *
+     * Uncontrolled on purpose, matching `initialTheme` and `initialTimeZone`:
+     * the page is rendered once against what the server resolved, and every
+     * change after that originates in the editor.
+     */
+    initialDesign?: NajmDesignConfig;
+}
+declare function NajmDesignEditorProvider({ children, design, initialDesign, }: NajmDesignEditorProviderProps): react_jsx_runtime.JSX.Element;
+
 /** Returns the active mode inherited from the nearest Najm theme provider. */
 declare function useNajmThemeMode(): NajmMode | undefined;
 declare function useNajmAppearance(): NajmAppearance;
@@ -1083,31 +1134,6 @@ interface NImageProps extends Omit<ImgHTMLAttributes<HTMLImageElement>, "src" |
  */
 declare function NImage({ src, fallback, alt, ...rest }: NImageProps): react_jsx_runtime.JSX.Element;
 
-interface NBrandingValue {
-    /** Used as the logo's `alt` when the logo does not set one. */
-    appName?: string;
-    logoExpanded?: ReactNode | string;
-    /** Falls back to `logoExpanded`. */
-    logoCollapsed?: ReactNode | string;
-    /** Swapped in when a `string` logo fails to load. */
-    logoFallback?: string;
-    logoHref?: string;
-}
-/** Returns `null` outside a provider, so every consumer stays optional. */
-declare function useNBranding(): NBrandingValue | null;
-/**
- * Publishes the app's marks once, so shells stop threading a `logo` through
- * every surface that shows one. `NSidebar` reads this when no `logo` prop is
- * given; an explicit `logo` always wins.
- *
- * Unlike `NSidebarProvider` this owns no state — the values are resolved by the
- * app (usually server-side) and only forwarded, so memoizing on the fields is
- * correct here.
- */
-declare function NBrandingProvider({ children, appName, logoExpanded, logoCollapsed, logoFallback, logoHref, }: Readonly<NBrandingValue & {
-    children: ReactNode;
-}>): react_jsx_runtime.JSX.Element;
-
 type AvatarSize = "xs" | "sm" | "md" | "lg" | "xl" | "2xl";
 type AvatarShape$1 = "circle" | "rounded" | "square";
 type AvatarStatusType = "online" | "offline" | "busy" | "away";
@@ -4096,4 +4122,4 @@ interface NGridItemProps extends Omit<React$1.AllHTMLAttributes<HTMLDivElement>,
 declare function NGrid({ as: Comp, children, cols, smCols, mdCols, lgCols, xlCols, gap, className, style, ...props }: NGridProps): react_jsx_runtime.JSX.Element;
 declare function NGridItem({ children, span, smSpan, mdSpan, lgSpan, xlSpan, className, ...props }: NGridItemProps): react_jsx_runtime.JSX.Element;
 
-export { Alert, type AlertLook, type AlertOrientation, type AlertProps, type AlertSize, type AlertTone, type AlertVariant, NCard as AsyncCard, Avatar, AvatarFallback, AvatarFormInput, type AvatarFormInputProps, AvatarGroup, type AvatarGroupProps, AvatarImage, AvatarInput, type AvatarInputProps, type AvatarInputRadius, type AvatarProps$1 as AvatarProps, type AvatarShape$1 as AvatarShape, type AvatarSize, AvatarStatus, type AvatarStatusType, Badge, type BadgeColor, type BadgeIcon, type BadgeLook, type BadgeProps, type BadgeShape, type BadgeSize, type BadgeVariant, BaseInput, type BuildDefaultFileColumnsOptions, Button, type ButtonConfig, type ButtonIcon, type ButtonLoaderPosition, type ButtonProps, type ButtonRounded, type ButtonSize, type ButtonVariant, Calendar, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Checkbox, CheckboxGroupInput, type CheckboxGroupInputProps, CheckboxInput, type CheckboxInputProps, Collapsible, CollapsibleContent, CollapsibleTrigger, ColorArrayInput, type ColorArrayInputProps, type ColorFormat, ColorPickerInput, type ColorPickerInputProps, Combobox, ComboboxInput, type ComboboxInputProps, type ComboboxOption, type ComboboxProps, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, type ContextMenuItem, DEFAULT_THEME_FILE_NAME, DateInput, type DateInputProps, type DeleteDialogOptions, Dialog, type DialogActionMode, type DialogApi, DialogClose, type DialogConfig, DialogContent, type DialogContentProps, DialogDescription, DialogFooter, DialogHeader, type DialogHeight, DialogOverlay, type DialogPadding, DialogPortal, type DialogRenderContext, type DialogRenderer, type DialogSize, type DialogStore, DialogTitle, DialogTrigger, type DialogVariant, type DialogWidth, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, DynamicArray, type DynamicArrayProps, EmojiInput, type EmojiInputProps, type FileBrowserMode, FileImportButton, FileInput, type FileInputProps, type FileNode, Form, FormControl, FormDescription, FormField, FormInput, type FormInputBackground, type FormInputProps, FormItem, FormLabel, FormMessage, type FormProps, type FormSlotClassNames, type FormVariant, IconButton, type IconButtonProps, type IconButtonSize, type IconButtonVariant, ImageInput, type ImageInputPreviewError, type ImageInputPreviewSource, type ImageInputProps, Indicator, type IndicatorHorizontal, type IndicatorOverlay, type IndicatorPosition, type IndicatorProps, type IndicatorResponsivePosition, type IndicatorSize, type IndicatorVertical, Input, type InputIcon, Label, LangInput, type LangInputProps, type LinkComponentType, MultiSelectInput, type MultiSelectInputProps, NAJM_SAVED_THEME_VALUE, NAlert, type NAppCommandItem, NAppShell, type NAppShellAction, type NAppShellClassNames, type NAppShellProps, type NAppShellUser, NCard as NAsyncCard, type CardClassNames as NAsyncCardClassNames, type CardProps as NAsyncCardProps, NAvatar, type NAvatarClassNames, type NAvatarProps, type AvatarShape as NAvatarShape, NBadge, type NBadgeLook, type NBadgeProps, NBarChart, type NBarChartProps, NBrandingProvider, type NBrandingValue, type NBulkAction, type NBulkActionButton, type NBulkActionSelect, NBulkActionsBar, type NBulkActionsBarProps, NButton, type NButtonProps, NCard, NCardAction, type CardClassNames as NCardClassNames, type NCardDensity, NCardFooter, NCardInfo, type NCardInfoProps, NCardMedia, type NCardMediaAspect, type NCardMediaPlacement, type NCardMediaProps, type NCardMediaSize, type NCardMediaVariant, type CardProps as NCardProps, NCardSection, type NCardSectionProps, type NCardSectionSurface, type NCartesianChartProps, type NChartCardProps, type NChartDatum, type NChartItem, type NChartSeries, type NChartSize, NChartSkeleton, type NChartSkeletonProps, type NChartSkeletonVariant, NCommandPalette, type NCommandPaletteProps, NConfirmDialog, type NConfirmDialogProps, NContextMenu, type NContextMenuItem, type NContextMenuProps, NDataCardShell, type NDataCardShellActions, type NDataCardShellProps, NDeleteDialog, NDeleteDialogContent, type NDeleteDialogContentProps, type NDeleteDialogProps, NDetailCard, type NDetailCardClassNames, type NDetailCardProps, NDetailItem, type NDetailItemProps, NDetailList, type NDetailListItem, type NDetailListProps, NDialog, type NDialogActionProps, NDialogDescription, type NDialogDescriptionProps, type NDialogDirectProps, NDialogHeader, type NDialogHeaderProps, NDialogPrimaryButton, type NDialogProps, NDialogSecondaryButton, NDonutCard, type NDonutCardClassNames, type NDonutCardItem, type NDonutCardLayout, type NDonutCardLegendMarker, type NDonutCardProps, type NDonutCardVariant, type NEditorTab, NEditorTabs, type NEditorTabsProps, NEmptyState, type NEmptyStateProps, NErrorBoundary, NErrorState, type NErrorStateProps, NFileBrowser, type NFileBrowserCardProps, type NFileBrowserProps, type NFileBrowserRenderThumbProps, NFileTypeIcon, type NFileTypeIconProps, NFilterBar, NFolderIcon, type NFolderIconProps, NForm, NFormSectionHeader, type NFormSectionHeaderProps, NGrid, type NGridCols, NGridItem, type NGridItemProps, type NGridProps, type NGridSpan, NIcon, type NIconProps, type NIconSource, NImage, type NImageProps, NIndicator, NInspectorSheet, NLineChart, type NLineChartProps, NLoadingState, type NLoadingStateProps, NMultiDialog, type NMultiDialogProps, NNavbar, NPageHeader, NPageHeaderActions, type NPageHeaderBreakpoint, NPageHeaderCompactActions, NPageHeaderFilters, type NPageHeaderProps, NPageHeaderTop, NPageLayout, type NPageLayoutProps, NPieChart, type NPieChartProps, NPortalScopeProvider, NProgress, type NProgressProps, NRowActions, NSection, NSectionHeader, type NSectionHeaderActionsProps, type NSectionHeaderContentProps, type NSectionHeaderProps, type NSectionHeaderSubtitleProps, type NSectionHeaderTitleProps, NSectionInfo, type NSectionInfoProps, type NSectionProps, NSectionWithInfo, type NSectionWithInfoItem, type NSectionWithInfoProps, NSheet, type NSheetClassNames, type NSheetProps, NSidebar, NSidebarBrand, type NSidebarBrandProps, NSidebarContent, type NSidebarContentProps, type NSidebarContextValue, NSidebarFooter, type NSidebarFooterProps, NSidebarHeader, type NSidebarHeaderProps, NSidebarItem, NSidebarMobile, type NSidebarMobileProps, NSidebarProvider, NSidebarSection, type NSidebarSectionProps, NSkeleton, NSkeletonCalendar, NSkeletonChart, NSkeletonDonut, NSkeletonEventList, NSkeletonWidget, NSkeletonWidgets, NSlider, type NSliderProps, NSmartPasteDialog, type NSmartPasteDialogProps, NSpinner, type NSpinnerProps, NStatCard, type NStatCardClassNames, type NStatCardProps, NStatCardSkeleton, type NStatCardVariant, NStatusBreakdown, type NStatusBreakdownProps, Swap as NSwap, type NSwapProps, NTable, NTableCardPagination, NTableCardRoot, type NTableCardRootProps, NTableCards, type NTableClassNames, type NTableColumnBreakpoint, type NTableColumnDef, type NTableColumnMeta, NTableContent, NTableHeader, NTableLoadingSkeleton, type NTableMenu, type NTableMenuProp, type NTablePageItem, NTablePagination, NTablePaginationLabels, NTablePaginationVariant, type NTableProps, NTableRowSkeleton, NTableSkeleton, type NTableState, NTabs, type NTabsClassNames, type NTabsColor, type NTabsItem, type NTabsProps, type NTabsStyles, NThemeCustomizer, type NThemeCustomizerFontOption, type NThemeCustomizerLabels, type NThemeCustomizerProps, type NThemeCustomizerTab, type NThemePreset, NThemePresets, type NThemePresetsLabels, type NThemePresetsProps, type NThemePresetsStatus, NUploader, type NUploaderItem, type NUploaderItemStatus, type NUploaderProps, NViewBody, NViewToggle, NajmAccent, NajmAppearance, type NajmBorderSide, NajmComponentName, NajmComponentStyleConfig, NajmComponentThemeConfig, NajmDesignConfig, NajmDesignProvider, type NajmDesignProviderProps, NajmLayoutConfig, NajmMode, NajmPreset, NajmResponsiveBreakpoint, NajmResponsiveValue, NajmScroll, type NajmScrollProps, NajmThemeConfig, NajmThemeProvider, NajmThemeProviderProps, NajmThemeTokens, NajmTypographyConfig, NajmVariantStyle, NativeSelect, type NativeSelectOption, type NativeSelectProps, type NavItem, type NavItemGroup, NumberInput, type NumberInputProps, OtpInput, type OtpInputProps, PasswordInput, type PasswordInputProps, PhoneInput, type PhoneInputProps, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, PrefixProvider, Progress, type ProgressColor, type ProgressLabelPosition, type ProgressProps, type ProgressSize, type PushDialogOptions, RadioGroup, RadioGroupInput, type RadioGroupInputProps, RadioGroupItem, type RenderSlot, RepeatingFields, type RepeatingFieldsProps, ScrollArea, type ScrollAreaProps, SearchField, SearchField as SearchInput, SegmentedControl, type SegmentedControlOption, type SegmentedControlProps, Select, SelectContent, SelectGroup, SelectInput, type SelectInputProps, SelectItem, type SelectItemType$1 as SelectItemDataType, type SelectItemType, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetPortal, SheetTitle, SheetTrigger, type SidebarItemProps, type SidebarLogo, type SidebarLogoRender, type SidebarProps, type SidebarWidth, type SidebarWidths, SimpleTooltip, type SimpleTooltipProps, NSkeleton as Skeleton, Slider, SliderInput, type SliderInputProps, type SliderOrientation, type SliderProps, type SliderSize, type SliderVariant, type SmartPastePreview, type SpinnerVariant, StarRatingInput, type StarRatingInputProps, StatusPill, type StatusPillProps, type StatusPillTone, type StepConfig, StepIndicator, type StepMeta, StepsHeader, StepsProgress, type StorageMenuAction, type StorageSortOption, type StorageTarget, Swap, type SwapEffect, SwapIndeterminate, SwapOff, SwapOn, type SwapProps, type SwapSize, type SwapState, Switch, type SwitchColor, SwitchInput, type SwitchInputProps, type SwitchSize, TAB_COLORS, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, type TableHeaderColor, TableRow, type TableState, type TableStore, TableStoreContext, Tabs, TabsContent, TabsList, type TabsListProps, type TabsOrientation, type TabsProps, TabsTrigger, type TabsTriggerProps, type TabsVariant, TextAreaInput, type TextAreaInputProps, TextInput, type TextInputProps, Textarea, TimeInput, type TimeInputProps, TimeZoneInput, type TimeZoneInputProps, Toaster, Toggle, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, type UseContextMenuResult, type UseNFormOptions, type UseStorageContextMenuOptions, type UseStorageContextMenuResult, type UserMenuAction, VariantProvider, type WizardClassNames, WizardForm, type WizardFormProps, alertVariants, avatarVariants, badgeColorVariants, badgeVariants, buildDefaultFileColumns, buildPageItems, buttonVariants, cn, composePreset, createDialogStore, createTableStore, defineNajmDesignConfig, defineNajmThemeConfig, detectFormat, dialogVariants, filterResponsiveColumns, formatColor, formatFileBytes, formatFileRelative, getIconColorProps, getNChartColor, getNextEditorTabValue, hiddenBelowClasses, indicatorVariants, inputBorderClasses, normalizeThemeFileName, parseColor, parseNajmDesignConfig, parseNajmThemeConfig, parseThemeFile, resolveHiddenBelowClass, resolvePreset, resolveSlot, resolveVariantAlias, sidebarBorderClasses, sliderVariants, stringifyNajmDesignConfig, stringifyNajmThemeConfig, stringifyThemeFile, surfaceBorderClasses, swapVariants, toPickerHex, toggleVariants, tooltipContentVariants, truncateByCharacters, useClickOutside, useContextMenu, useDebouncedValue, useDelayedLoading, useDialog, useDialogStore, useDynamicPageSize, useFormField, useFormSubmission, useInfiniteScroll, useKeyboard, useLocalStorageState, useNBranding, useNForm, useNPortalScope, useNSidebar, useNajmAppearance, useNajmComponentStyle, useNajmDesign, useNajmThemeMode, usePrefix, useSelection, useStepNavigation, useStorageContextMenu, useStoreSync, useTable, useTableKeyboard, useTableStore, useVariant, useVariantPreset };
+export { Alert, type AlertLook, type AlertOrientation, type AlertProps, type AlertSize, type AlertTone, type AlertVariant, NCard as AsyncCard, Avatar, AvatarFallback, AvatarFormInput, type AvatarFormInputProps, AvatarGroup, type AvatarGroupProps, AvatarImage, AvatarInput, type AvatarInputProps, type AvatarInputRadius, type AvatarProps$1 as AvatarProps, type AvatarShape$1 as AvatarShape, type AvatarSize, AvatarStatus, type AvatarStatusType, Badge, type BadgeColor, type BadgeIcon, type BadgeLook, type BadgeProps, type BadgeShape, type BadgeSize, type BadgeVariant, BaseInput, type BuildDefaultFileColumnsOptions, Button, type ButtonConfig, type ButtonIcon, type ButtonLoaderPosition, type ButtonProps, type ButtonRounded, type ButtonSize, type ButtonVariant, Calendar, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Checkbox, CheckboxGroupInput, type CheckboxGroupInputProps, CheckboxInput, type CheckboxInputProps, Collapsible, CollapsibleContent, CollapsibleTrigger, ColorArrayInput, type ColorArrayInputProps, type ColorFormat, ColorPickerInput, type ColorPickerInputProps, Combobox, ComboboxInput, type ComboboxInputProps, type ComboboxOption, type ComboboxProps, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, type ContextMenuItem, DEFAULT_THEME_FILE_NAME, DateInput, type DateInputProps, type DeleteDialogOptions, Dialog, type DialogActionMode, type DialogApi, DialogClose, type DialogConfig, DialogContent, type DialogContentProps, DialogDescription, DialogFooter, DialogHeader, type DialogHeight, DialogOverlay, type DialogPadding, DialogPortal, type DialogRenderContext, type DialogRenderer, type DialogSize, type DialogStore, DialogTitle, DialogTrigger, type DialogVariant, type DialogWidth, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, DynamicArray, type DynamicArrayProps, EMPTY_DESIGN, EmojiInput, type EmojiInputProps, type FileBrowserMode, FileImportButton, FileInput, type FileInputProps, type FileNode, Form, FormControl, FormDescription, FormField, FormInput, type FormInputBackground, type FormInputProps, FormItem, FormLabel, FormMessage, type FormProps, type FormSlotClassNames, type FormVariant, IconButton, type IconButtonProps, type IconButtonSize, type IconButtonVariant, ImageInput, type ImageInputPreviewError, type ImageInputPreviewSource, type ImageInputProps, Indicator, type IndicatorHorizontal, type IndicatorOverlay, type IndicatorPosition, type IndicatorProps, type IndicatorResponsivePosition, type IndicatorSize, type IndicatorVertical, Input, type InputIcon, Label, LangInput, type LangInputProps, type LinkComponentType, MultiSelectInput, type MultiSelectInputProps, NAJM_SAVED_THEME_VALUE, NAlert, type NAppCommandItem, NAppShell, type NAppShellAction, type NAppShellClassNames, type NAppShellProps, type NAppShellUser, NCard as NAsyncCard, type CardClassNames as NAsyncCardClassNames, type CardProps as NAsyncCardProps, NAvatar, type NAvatarClassNames, type NAvatarProps, type AvatarShape as NAvatarShape, NBadge, type NBadgeLook, type NBadgeProps, NBarChart, type NBarChartProps, type NBulkAction, type NBulkActionButton, type NBulkActionSelect, NBulkActionsBar, type NBulkActionsBarProps, NButton, type NButtonProps, NCard, NCardAction, type CardClassNames as NCardClassNames, type NCardDensity, NCardFooter, NCardInfo, type NCardInfoProps, NCardMedia, type NCardMediaAspect, type NCardMediaPlacement, type NCardMediaProps, type NCardMediaSize, type NCardMediaVariant, type CardProps as NCardProps, NCardSection, type NCardSectionProps, type NCardSectionSurface, type NCartesianChartProps, type NChartCardProps, type NChartDatum, type NChartItem, type NChartSeries, type NChartSize, NChartSkeleton, type NChartSkeletonProps, type NChartSkeletonVariant, NCommandPalette, type NCommandPaletteProps, NConfirmDialog, type NConfirmDialogProps, NContextMenu, type NContextMenuItem, type NContextMenuProps, NDataCardShell, type NDataCardShellActions, type NDataCardShellProps, NDeleteDialog, NDeleteDialogContent, type NDeleteDialogContentProps, type NDeleteDialogProps, NDetailCard, type NDetailCardClassNames, type NDetailCardProps, NDetailItem, type NDetailItemProps, NDetailList, type NDetailListItem, type NDetailListProps, NDialog, type NDialogActionProps, NDialogDescription, type NDialogDescriptionProps, type NDialogDirectProps, NDialogHeader, type NDialogHeaderProps, NDialogPrimaryButton, type NDialogProps, NDialogSecondaryButton, NDonutCard, type NDonutCardClassNames, type NDonutCardItem, type NDonutCardLayout, type NDonutCardLegendMarker, type NDonutCardProps, type NDonutCardVariant, type NEditorTab, NEditorTabs, type NEditorTabsProps, NEmptyState, type NEmptyStateProps, NErrorBoundary, NErrorState, type NErrorStateProps, NFileBrowser, type NFileBrowserCardProps, type NFileBrowserProps, type NFileBrowserRenderThumbProps, NFileTypeIcon, type NFileTypeIconProps, NFilterBar, NFolderIcon, type NFolderIconProps, NForm, NFormSectionHeader, type NFormSectionHeaderProps, NGrid, type NGridCols, NGridItem, type NGridItemProps, type NGridProps, type NGridSpan, NIcon, type NIconProps, type NIconSource, NImage, type NImageProps, NIndicator, NInspectorSheet, NLineChart, type NLineChartProps, NLoadingState, type NLoadingStateProps, NMultiDialog, type NMultiDialogProps, NNavbar, NPageHeader, NPageHeaderActions, type NPageHeaderBreakpoint, NPageHeaderCompactActions, NPageHeaderFilters, type NPageHeaderProps, NPageHeaderTop, NPageLayout, type NPageLayoutProps, NPieChart, type NPieChartProps, NPortalScopeProvider, NProgress, type NProgressProps, NRowActions, NSection, NSectionHeader, type NSectionHeaderActionsProps, type NSectionHeaderContentProps, type NSectionHeaderProps, type NSectionHeaderSubtitleProps, type NSectionHeaderTitleProps, NSectionInfo, type NSectionInfoProps, type NSectionProps, NSectionWithInfo, type NSectionWithInfoItem, type NSectionWithInfoProps, NSheet, type NSheetClassNames, type NSheetProps, NSidebar, NSidebarBrand, type NSidebarBrandProps, NSidebarContent, type NSidebarContentProps, type NSidebarContextValue, NSidebarFooter, type NSidebarFooterProps, NSidebarHeader, type NSidebarHeaderProps, NSidebarItem, NSidebarMobile, type NSidebarMobileProps, NSidebarProvider, NSidebarSection, type NSidebarSectionProps, NSkeleton, NSkeletonCalendar, NSkeletonChart, NSkeletonDonut, NSkeletonEventList, NSkeletonWidget, NSkeletonWidgets, NSlider, type NSliderProps, NSmartPasteDialog, type NSmartPasteDialogProps, NSpinner, type NSpinnerProps, NStatCard, type NStatCardClassNames, type NStatCardProps, NStatCardSkeleton, type NStatCardVariant, NStatusBreakdown, type NStatusBreakdownProps, Swap as NSwap, type NSwapProps, NTable, NTableCardPagination, NTableCardRoot, type NTableCardRootProps, NTableCards, type NTableClassNames, type NTableColumnBreakpoint, type NTableColumnDef, type NTableColumnMeta, NTableContent, NTableHeader, NTableLoadingSkeleton, type NTableMenu, type NTableMenuProp, type NTablePageItem, NTablePagination, NTablePaginationLabels, NTablePaginationVariant, type NTableProps, NTableRowSkeleton, NTableSkeleton, type NTableState, NTabs, type NTabsClassNames, type NTabsColor, type NTabsItem, type NTabsProps, type NTabsStyles, NThemeCustomizer, type NThemeCustomizerFontOption, type NThemeCustomizerLabels, type NThemeCustomizerProps, type NThemeCustomizerTab, type NThemePreset, NThemePresets, type NThemePresetsLabels, type NThemePresetsProps, type NThemePresetsStatus, NUploader, type NUploaderItem, type NUploaderItemStatus, type NUploaderProps, NViewBody, NViewToggle, NajmAccent, NajmAppearance, type NajmBorderSide, NajmComponentName, NajmComponentStyleConfig, NajmComponentThemeConfig, NajmDesignConfig, NajmDesignEditorProvider, type NajmDesignEditorProviderProps, type NajmDesignEditorValue, NajmDesignProvider, type NajmDesignProviderProps, NajmLayoutConfig, NajmMode, NajmPreset, NajmResponsiveBreakpoint, NajmResponsiveValue, NajmScroll, type NajmScrollProps, NajmThemeConfig, NajmThemeProvider, NajmThemeProviderProps, NajmThemeTokens, NajmTypographyConfig, NajmVariantStyle, NativeSelect, type NativeSelectOption, type NativeSelectProps, type NavItem, type NavItemGroup, NumberInput, type NumberInputProps, OtpInput, type OtpInputProps, PasswordInput, type PasswordInputProps, PhoneInput, type PhoneInputProps, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, PrefixProvider, Progress, type ProgressColor, type ProgressLabelPosition, type ProgressProps, type ProgressSize, type PushDialogOptions, RadioGroup, RadioGroupInput, type RadioGroupInputProps, RadioGroupItem, type RenderSlot, RepeatingFields, type RepeatingFieldsProps, ScrollArea, type ScrollAreaProps, SearchField, SearchField as SearchInput, SegmentedControl, type SegmentedControlOption, type SegmentedControlProps, Select, SelectContent, SelectGroup, SelectInput, type SelectInputProps, SelectItem, type SelectItemType$1 as SelectItemDataType, type SelectItemType, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetPortal, SheetTitle, SheetTrigger, type SidebarItemProps, type SidebarLogo, type SidebarLogoRender, type SidebarProps, type SidebarWidth, type SidebarWidths, SimpleTooltip, type SimpleTooltipProps, NSkeleton as Skeleton, Slider, SliderInput, type SliderInputProps, type SliderOrientation, type SliderProps, type SliderSize, type SliderVariant, type SmartPastePreview, type SpinnerVariant, StarRatingInput, type StarRatingInputProps, StatusPill, type StatusPillProps, type StatusPillTone, type StepConfig, StepIndicator, type StepMeta, StepsHeader, StepsProgress, type StorageMenuAction, type StorageSortOption, type StorageTarget, Swap, type SwapEffect, SwapIndeterminate, SwapOff, SwapOn, type SwapProps, type SwapSize, type SwapState, Switch, type SwitchColor, SwitchInput, type SwitchInputProps, type SwitchSize, TAB_COLORS, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, type TableHeaderColor, TableRow, type TableState, type TableStore, TableStoreContext, Tabs, TabsContent, TabsList, type TabsListProps, type TabsOrientation, type TabsProps, TabsTrigger, type TabsTriggerProps, type TabsVariant, TextAreaInput, type TextAreaInputProps, TextInput, type TextInputProps, Textarea, TimeInput, type TimeInputProps, TimeZoneInput, type TimeZoneInputProps, Toaster, Toggle, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, type UseContextMenuResult, type UseNFormOptions, type UseStorageContextMenuOptions, type UseStorageContextMenuResult, type UserMenuAction, VariantProvider, type WizardClassNames, WizardForm, type WizardFormProps, alertVariants, avatarVariants, badgeColorVariants, badgeVariants, buildDefaultFileColumns, buildPageItems, buttonVariants, cn, composePreset, createDialogStore, createTableStore, defineNajmDesignConfig, defineNajmThemeConfig, detectFormat, dialogVariants, filterResponsiveColumns, formatColor, formatFileBytes, formatFileRelative, getIconColorProps, getNChartColor, getNextEditorTabValue, hiddenBelowClasses, indicatorVariants, inputBorderClasses, normalizeThemeFileName, parseColor, parseNajmDesignConfig, parseNajmThemeConfig, parseThemeFile, resolveHiddenBelowClass, resolvePreset, resolveSlot, resolveVariantAlias, sidebarBorderClasses, sliderVariants, stringifyNajmDesignConfig, stringifyNajmThemeConfig, stringifyThemeFile, surfaceBorderClasses, swapVariants, toPickerHex, toggleVariants, tooltipContentVariants, truncateByCharacters, useClickOutside, useContextMenu, useDebouncedValue, useDelayedLoading, useDialog, useDialogStore, useDynamicPageSize, useFormField, useFormSubmission, useInfiniteScroll, useKeyboard, useLocalStorageState, useNForm, useNPortalScope, useNSidebar, useNajmAppearance, useNajmComponentStyle, useNajmDesign, useNajmDesignEditor, useNajmThemeMode, usePrefix, useSelection, useStepNavigation, useStorageContextMenu, useStoreSync, useTable, useTableKeyboard, useTableStore, useVariant, useVariantPreset };

package/dist/index.mjs

@@ -1,11 +1,11 @@
-import { useNBranding } from './chunk-IGUQGT3G.mjs';
-export { NBrandingProvider, useNBranding } from './chunk-IGUQGT3G.mjs';
-import { useResolvedPaginationLabels } from './chunk-7F65QM43.mjs';
-export { DEFAULT_PAGINATION_KEY_PREFIX, DEFAULT_TIME_ZONE, NTableDefaultsProvider, NajmPreferencesProvider, NajmUIProvider, buildPaginationLabels, useNTableDefaults, useNajmPreferencesContext, useNajmTheme, useNajmTimeZone } from './chunk-7F65QM43.mjs';
-import { resolveRadiusValue, inputBorderClasses, cn, Button, NIcon, NajmScroll, surfaceBorderClasses, useNajmScrollViewport, resolveVariantAlias, buttonVariants, NButton, parseNajmDesignConfig, useTableStore, TableStoreContext, sidebarBorderClasses, NTableJson } from './chunk-4DLRXB2W.mjs';
-export { Button, NAJM_COMPONENT_NAMES, NButton, NIcon, NTableJson, NajmScroll, RADIUS_VALUE_MAP, TableStoreContext, buttonVariants, cn, defineNajmDesignConfig, defineNajmThemeConfig, inputBorderClasses, parseNajmDesignConfig, parseNajmThemeConfig, resolveRadiusValue, resolveVariantAlias, sidebarBorderClasses, stringifyNajmDesignConfig, stringifyNajmThemeConfig, surfaceBorderClasses, useTableStore } from './chunk-4DLRXB2W.mjs';
-import { useNajmComponentStyle, NajmThemeContainerCtx, useNajmThemeMode, useNajmDesign, composePreset } from './chunk-YBM5CTE6.mjs';
-export { NajmDesignProvider, NajmThemeProvider, composePreset, resolvePreset, useNajmAppearance, useNajmComponentStyle, useNajmDesign, useNajmThemeMode } from './chunk-YBM5CTE6.mjs';
+import { useNBranding } from './chunk-5LW62RB6.mjs';
+export { NBrandingProvider, NBrandingStateProvider, normalizeBranding, useNBranding, useNBrandingEditor } from './chunk-5LW62RB6.mjs';
+import { useResolvedPaginationLabels } from './chunk-USZUOJMK.mjs';
+export { DEFAULT_PAGINATION_KEY_PREFIX, DEFAULT_TIME_ZONE, EMPTY_DESIGN, NTableDefaultsProvider, NajmDesignEditorProvider, NajmPreferencesProvider, NajmUIProvider, buildPaginationLabels, useNTableDefaults, useNajmDesignEditor, useNajmPreferencesContext, useNajmTheme, useNajmTimeZone } from './chunk-USZUOJMK.mjs';
+import { resolveRadiusValue, inputBorderClasses, Button, NIcon, NajmScroll, surfaceBorderClasses, useNajmScrollViewport, resolveVariantAlias, buttonVariants, NButton, parseNajmDesignConfig, useTableStore, TableStoreContext, sidebarBorderClasses, NTableJson } from './chunk-6OOBAEH2.mjs';
+export { Button, NAJM_COMPONENT_NAMES, NButton, NIcon, NTableJson, NajmScroll, RADIUS_VALUE_MAP, TableStoreContext, buttonVariants, defineNajmDesignConfig, defineNajmThemeConfig, inputBorderClasses, parseNajmDesignConfig, parseNajmThemeConfig, resolveRadiusValue, resolveVariantAlias, sidebarBorderClasses, stringifyNajmDesignConfig, stringifyNajmThemeConfig, surfaceBorderClasses, useTableStore } from './chunk-6OOBAEH2.mjs';
+import { useNajmComponentStyle, cn, NajmThemeContainerCtx, useNajmThemeMode, useNajmDesign, composePreset } from './chunk-KVZACF4G.mjs';
+export { NajmDesignProvider, NajmThemeProvider, cn, composePreset, resolvePreset, useNajmAppearance, useNajmComponentStyle, useNajmDesign, useNajmThemeMode } from './chunk-KVZACF4G.mjs';
 import * as React60 from 'react';
 import React60__default, { createContext, useRef, useMemo, useState, useEffect, useContext, useCallback, useLayoutEffect, isValidElement } from 'react';
 import * as TabsPrimitive from '@radix-ui/react-tabs';

package/dist/json.mjs

@@ -1,6 +1,6 @@
-import { cn, Button } from './chunk-4DLRXB2W.mjs';
-export { NTableJson } from './chunk-4DLRXB2W.mjs';
-import './chunk-YBM5CTE6.mjs';
+import { Button } from './chunk-6OOBAEH2.mjs';
+export { NTableJson } from './chunk-6OOBAEH2.mjs';
+import { cn } from './chunk-KVZACF4G.mjs';
 import { useMemo, useRef, useCallback } from 'react';
 import CodeMirror from '@uiw/react-codemirror';
 import { json } from '@codemirror/lang-json';

package/package.json

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

package/dist/chunk-IGUQGT3G.mjs

@@ -1,24 +0,0 @@
-import { createContext, useContext, useMemo } from 'react';
-import { jsx } from 'react/jsx-runtime';
-
-// src/components/branding/NBrandingContext.tsx
-var NBrandingContext = createContext(null);
-function useNBranding() {
-  return useContext(NBrandingContext);
-}
-function NBrandingProvider({
-  children,
-  appName,
-  logoExpanded,
-  logoCollapsed,
-  logoFallback,
-  logoHref
-}) {
-  const value = useMemo(
-    () => ({ appName, logoExpanded, logoCollapsed, logoFallback, logoHref }),
-    [appName, logoExpanded, logoCollapsed, logoFallback, logoHref]
-  );
-  return /* @__PURE__ */ jsx(NBrandingContext.Provider, { value, children });
-}
-
-export { NBrandingProvider, useNBranding };