najm-kit 2.8.1 → 2.9.0

package/dist/{NajmUIProvider-BSbXaqak.d.ts → NajmUIProvider-CI_73GEp.d.ts}

@@ -1,166 +1,9 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import * as React$1 from 'react';
+import * as React from 'react';
 import React__default from 'react';
+import { e as NajmMode, a as NajmDesignConfig } from './design-types-Rkpt8Pg1.js';
 import { b as NTablePaginationLabels, N as NajmTranslate } from './paginationLabels-dZLSNxfo.js';
 
-type NajmMode = 'light' | 'dark';
-type NajmAccent = 'neutral' | 'emerald' | 'green' | 'slate' | 'blue' | 'violet';
-type NajmPreset = 'light' | 'dark' | 'dark-emerald' | 'dark-green' | 'dark-slate' | 'dark-blue' | 'dark-violet';
-interface NajmAppearance {
-    /** Global border thickness, e.g. `'0'`, `'1px'`, `'2px'`. `'0'` hides borders. */
-    borderWidth?: string;
-}
-interface NajmThemeTokens {
-    background?: string;
-    foreground?: string;
-    card?: string;
-    'card-foreground'?: string;
-    popover?: string;
-    'popover-foreground'?: string;
-    primary?: string;
-    'primary-foreground'?: string;
-    secondary?: string;
-    'secondary-foreground'?: string;
-    tertiary?: string;
-    'tertiary-foreground'?: string;
-    muted?: string;
-    'muted-foreground'?: string;
-    accent?: string;
-    'accent-foreground'?: string;
-    destructive?: string;
-    'destructive-foreground'?: string;
-    border?: string;
-    input?: string;
-    ring?: string;
-    sidebar?: string;
-    'sidebar-foreground'?: string;
-    'sidebar-primary'?: string;
-    'sidebar-primary-foreground'?: string;
-    'sidebar-accent'?: string;
-    'sidebar-accent-foreground'?: string;
-    'sidebar-border'?: string;
-    'sidebar-ring'?: string;
-    'chart-1'?: string;
-    'chart-2'?: string;
-    'chart-3'?: string;
-    'chart-4'?: string;
-    'chart-5'?: string;
-    radius?: string;
-}
-/** Serializable theme settings suitable for JSON files, APIs, or local storage. */
-interface NajmThemeConfig {
-    preset?: NajmPreset;
-    mode?: NajmMode;
-    accent?: NajmAccent;
-    tokens?: NajmThemeTokens;
-    /**
-     * Per-mode token overrides authored on top of the composed preset. Keeps
-     * light and dark customizations independent: editing a token in one mode
-     * records it here so it survives switching to the other mode and back.
-     * Providers resolve this field on top of the composed mode/accent preset.
-     */
-    overrides?: Partial<Record<NajmMode, NajmThemeTokens>>;
-    accentOnly?: boolean;
-    appearance?: NajmAppearance;
-    radius?: string;
-}
-interface NajmThemeProviderProps {
-    /** Serializable theme settings. Explicit provider props override this config. */
-    config?: NajmThemeConfig;
-    preset?: NajmPreset;
-    mode?: NajmMode;
-    accent?: NajmAccent;
-    tokens?: NajmThemeTokens;
-    /** When true, only inject accent tokens (primary, ring, accent and their foregrounds).
-     *  Everything else (bg, card, fg…) is inherited from the parent cascade. */
-    accentOnly?: boolean;
-    /** App-wide UI preferences (currently global border width). */
-    appearance?: NajmAppearance;
-    /** Global base radius, for example `0`, `0.5rem`, or `0.75rem`. */
-    radius?: string;
-    className?: string;
-    asChild?: boolean;
-    children: React.ReactNode;
-}
-
-type NajmDensity = "compact" | "default" | "comfortable";
-/** Tailwind's mobile-first viewport breakpoints, plus the default value. */
-type NajmResponsiveBreakpoint = "base" | "sm" | "md" | "lg" | "xl" | "2xl";
-/**
- * A scalar value for every viewport, or mobile-first breakpoint overrides.
- * For example: `{ base: 164, lg: 200, xl: 240 }`.
- */
-type NajmResponsiveValue<T> = T | Partial<Record<NajmResponsiveBreakpoint, T>>;
-type NajmComponentRadius = "inherit" | "none" | "xs" | "sm" | "md" | "lg" | "xl" | "full" | string;
-interface NajmSlotStyle {
-    className?: string;
-    radius?: NajmComponentRadius;
-    borderWidth?: string;
-    padding?: string;
-    paddingTop?: string;
-}
-interface NajmVariantStyle {
-    /** Reuse another variant's recipe. Example: primary badge uses secondary. */
-    use?: string;
-    className?: string;
-    tokens?: Record<string, string>;
-}
-interface NajmComponentStyleConfig {
-    /** Render components that support it as a card-like surface. */
-    card?: boolean;
-    /** Sidebar-only: render section titles above grouped nav items. */
-    showSectionLabels?: boolean;
-    /** Sidebar-only: render separator lines between nav item sections. */
-    showSectionSeparators?: boolean;
-    /** Sidebar-only: expanded width in px (default 240). Supports responsive overrides. */
-    expandedWidth?: NajmResponsiveValue<number>;
-    /** Sidebar-only: collapsed width in px (default 64). Supports responsive overrides. */
-    collapsedWidth?: NajmResponsiveValue<number>;
-    /** Sidebar-only: mobile drawer width in px. Defaults to the expanded width. */
-    mobileWidth?: NajmResponsiveValue<number>;
-    defaultVariant?: string;
-    defaultSize?: string;
-    density?: NajmDensity;
-    /** NTable-only: CSS color used for the table header and add button. */
-    headerColor?: string;
-    /** NTable-only: CSS color used for table header text and add button text. */
-    headerTextColor?: string;
-    /** NTable-only: CSS color used for table container and row borders. */
-    borderColor?: string;
-    radius?: NajmComponentRadius;
-    borderWidth?: string;
-    slots?: Record<string, NajmSlotStyle>;
-    variants?: Record<string, NajmVariantStyle>;
-}
-type NajmComponentName = "button" | "badge" | "card" | "table" | "tabs" | "dialog" | "alert" | "sidebar" | "pageHeader" | "input" | "select" | "dropdown" | "sheet" | "popover" | "tooltip" | "progress" | "avatar";
-type NajmComponentThemeConfig = Partial<Record<NajmComponentName, NajmComponentStyleConfig>>;
-interface NajmTypographyConfig {
-    fontSans?: string;
-    fontHeading?: string;
-    fontMono?: string;
-    baseSize?: string;
-    scale?: "compact" | "default" | "comfortable";
-    lineHeight?: string;
-    letterSpacing?: string;
-}
-interface NajmLayoutConfig {
-    /** Page inline padding, usually used by NPageLayout. */
-    pageGutter?: string;
-    /** Vertical page padding and stacked section gap, usually used by NPageLayout. */
-    sectionGap?: string;
-}
-interface NajmDesignConfig {
-    version: 1;
-    theme: NajmThemeConfig;
-    typography?: NajmTypographyConfig;
-    components?: NajmComponentThemeConfig;
-    layout?: NajmLayoutConfig;
-}
-declare const NAJM_COMPONENT_NAMES: readonly NajmComponentName[];
-/** Maps a NajmComponentRadius keyword to a CSS value (or var). */
-declare const RADIUS_VALUE_MAP: Record<string, string>;
-declare function resolveRadiusValue(radius: NajmComponentRadius | undefined): string | undefined;
-
 /**
  * Defaults every `NTable` beneath the provider inherits.
  *
@@ -205,7 +48,7 @@ interface NajmPreferencesContextValue {
 }
 declare const DEFAULT_TIME_ZONE = "UTC";
 interface NajmPreferencesProviderProps {
-    children: React$1.ReactNode;
+    children: React.ReactNode;
     /** Seeds theme state; ignored after mount. Defaults to `"light"`. */
     initialTheme?: NajmMode;
     /** Seeds time zone state; ignored after mount. Defaults to `"UTC"`. */
@@ -247,7 +90,7 @@ declare function useNajmTheme(): Pick<NajmPreferencesContextValue, "theme" | "se
 declare function useNajmTimeZone(): Pick<NajmPreferencesContextValue, "timeZone" | "setTimeZone">;
 
 interface NajmUIProviderProps extends Omit<NajmPreferencesProviderProps, "children"> {
-    children: React$1.ReactNode;
+    children: React.ReactNode;
     /**
      * The design config handed to `NajmDesignProvider`, owned by the application.
      *
@@ -315,4 +158,4 @@ interface NajmUIProviderProps extends Omit<NajmPreferencesProviderProps, "childr
  */
 declare function NajmUIProvider({ children, design, initialDesign, className, t, paginationKeyPrefix, tableDefaults, initialTheme, initialTimeZone, onThemeChange, onTimeZoneChange, normalizeTimeZone, }: NajmUIProviderProps): react_jsx_runtime.JSX.Element;
 
-export { resolveRadiusValue as A, useNTableDefaults as B, useNajmPreferencesContext as C, DEFAULT_TIME_ZONE as D, useNajmTheme as E, useNajmTimeZone as F, type NajmUIProviderProps as N, 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 NajmResponsiveBreakpoint as o, type NajmResponsiveValue as p, NAJM_COMPONENT_NAMES as q, type NTableDefaults as r, NTableDefaultsProvider as s, type NajmComponentRadius as t, type NajmDensity as u, type NajmPreferencesContextValue as v, NajmPreferencesProvider as w, type NajmPreferencesProviderProps as x, type NajmSlotStyle as y, NajmUIProvider as z };
+export { DEFAULT_TIME_ZONE as D, type NajmUIProviderProps as N, type NTableDefaults as a, NTableDefaultsProvider as b, type NajmPreferencesContextValue as c, NajmPreferencesProvider as d, type NajmPreferencesProviderProps as e, NajmUIProvider as f, useNajmPreferencesContext as g, useNajmTheme as h, useNajmTimeZone as i, useNTableDefaults as u };

package/dist/adapters/app.d.ts

@@ -4,7 +4,8 @@ import { F as FormDevToolsOptions, N as NBrandingInput } from '../formFill-BcH-m
 import { NajmNextUIProviderProps } from './next.js';
 import 'react';
 import 'zod';
-import '../NajmUIProvider-BSbXaqak.js';
+import '../NajmUIProvider-CI_73GEp.js';
+import '../design-types-Rkpt8Pg1.js';
 import '../paginationLabels-dZLSNxfo.js';
 
 /** Branding shown by the kit's chrome. Purely presentational values. */

package/dist/adapters/next.d.ts

@@ -1,6 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React__default from 'react';
-import { N as NajmUIProviderProps } from '../NajmUIProvider-BSbXaqak.js';
+import { N as NajmUIProviderProps } from '../NajmUIProvider-CI_73GEp.js';
+import '../design-types-Rkpt8Pg1.js';
 import '../paginationLabels-dZLSNxfo.js';
 
 interface NextLinkAdapterProps extends Record<string, any> {

package/dist/chunk-7H6NFBQT.mjs

@@ -0,0 +1,75 @@
+// src/server/uiBootstrap.ts
+var MISSING = Symbol("najm-kit/server: missing envelope");
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+function selectData(payload) {
+  return isRecord(payload) && "data" in payload ? payload.data : MISSING;
+}
+function describeThrown(value) {
+  return value instanceof Error ? `${value.name}: ${value.message}` : `non-error thrown: ${typeof value}`;
+}
+function createUiBootstrapLoader(config) {
+  const { fetcher, resources, onDiagnostic } = config;
+  const selectEnvelope = config.select ?? selectData;
+  const names = Object.keys(resources);
+  const report = (diagnostic) => {
+    if (!onDiagnostic) return;
+    try {
+      onDiagnostic(diagnostic);
+    } catch {
+    }
+  };
+  async function loadOne(name) {
+    const resource = resources[name];
+    const { path } = resource;
+    const select = resource.select ?? selectEnvelope;
+    const fail = (reason, detail = {}) => {
+      report({ resource: name, reason, path, ...detail });
+      return resource.fallback();
+    };
+    let response;
+    try {
+      response = await fetcher(path);
+    } catch (cause) {
+      return fail("fetch-failed", { error: describeThrown(cause) });
+    }
+    if (!response.ok) return fail("response-not-ok", { status: response.status });
+    let payload;
+    try {
+      payload = await response.json();
+    } catch (cause) {
+      return fail("invalid-json", { error: describeThrown(cause) });
+    }
+    let data;
+    try {
+      data = select(payload);
+    } catch (cause) {
+      return fail("invalid-envelope", { error: describeThrown(cause) });
+    }
+    if (data === MISSING) return fail("invalid-envelope");
+    try {
+      const parsed = resource.parse(data);
+      if (parsed !== void 0) return parsed;
+    } catch (cause) {
+      return fail("invalid-payload", { error: describeThrown(cause) });
+    }
+    return fail("invalid-payload");
+  }
+  const loaders = Object.fromEntries(
+    names.map((name) => [name, () => loadOne(name)])
+  );
+  async function load() {
+    const pending = names.map((name) => loadOne(name));
+    const settled = await Promise.all(pending);
+    const snapshot = {};
+    names.forEach((name, index) => {
+      snapshot[name] = settled[index];
+    });
+    Object.freeze(snapshot);
+    return snapshot;
+  }
+  return { load, loadResource: (name) => loaders[name](), loaders };
+}
+
+export { createUiBootstrapLoader };

package/dist/chunk-BEGOH366.mjs

@@ -0,0 +1,12 @@
+// src/lib/avatar.ts
+var PLACEHOLDER_AVATAR = /(^|\/)noavatar\.png(?:$|[?#])/i;
+function isPlaceholderAvatar(src) {
+  const trimmed = src?.trim() ?? "";
+  return !trimmed || PLACEHOLDER_AVATAR.test(trimmed);
+}
+function resolveAvatarSrc(src, fallback) {
+  const trimmed = src?.trim() ?? "";
+  return trimmed && !PLACEHOLDER_AVATAR.test(trimmed) ? trimmed : fallback;
+}
+
+export { isPlaceholderAvatar, resolveAvatarSrc };