najm-kit 2.7.3 → 2.8.1

package/CHANGELOG.md

@@ -1,6 +1,32 @@
-# Changelog
-
-## 2.6.2
+# Changelog
+
+## 2.8.1 - 2026-08-08
+
+- Added schema-driven form development tools to `NajmAppProvider`. Passing
+  `formDevTools` enables F8 filling for every `NForm` and `WizardForm` without
+  an application helper or additional provider.
+- Added built-in Zod 4 form-value generation with per-form overrides for
+  relation fields and other application-owned values. Existing explicit
+  `devTools.enabled` and `devTools.fill` usage remains supported.
+
+## 2.8.0 - 2026-08-08
+
+- Added server-safe `najm-kit/format` helpers for currency minor units,
+  numbers, percentages, dates, times, relative time, tokens, local date inputs,
+  and slugs. Client applications can use the same contract reactively through
+  `NajmFormatProvider` and `useNajmFormat`.
+- Added the server-safe `najm-kit/pagination` offset protocol, including bounded
+  page creation, total-aware continuation, probe-row continuation for APIs
+  without totals, and query cleanup that preserves meaningful `false` and `0`.
+- Added the optional-peer `najm-kit/query` entry with offset infinite-query and
+  responsive paged/card-list hooks, plus shared card-pagination adapters and
+  localized continuation labels.
+- Extended `NajmAppProvider` with formatting locale, currency, and placeholder
+  configuration so applications can bind language, time zone, and formatting
+  without another host bridge provider.
+- Added shared media-query/card-viewport helpers and avatar-source utilities.
+
+## 2.6.2
 
 - Added `NSidebarProvider` and `useNSidebar`, so sidebar state can be read from a distance. `NSidebar` renders beside the page content rather than around it, which left applications hand-rolling a context to hand `setMobileOpen` down to a page header — a wrapper component plus an aliased import at every call site. Wrap the shell in `NSidebarProvider` and `NPageHeader` now resolves both `onSidebarOpen` and `mobileBreakpoint` from it, so a header nested anywhere below renders a working mobile trigger with no props threaded to it. Also exports the `NSidebarContextValue` type.
 - `NSidebar` resolves its open and collapsed state as explicit prop → surrounding provider → internal state. Passing `collapsed`, `mobileOpen`, `onCollapsedChange`, or `onMobileOpenChange` keeps behaving exactly as before, and a sidebar with no provider around it still owns its own state, so this is additive for every existing consumer.

package/README.md

@@ -123,7 +123,7 @@ Changing the state updates the complete theme immediately. Use
 `stringifyNajmThemeConfig(theme)` when persisting it, and parse settings loaded
 from an API or local storage with `parseNajmThemeConfig` before applying them.
 
-## Components
+## Components
 
 Import from `najm-kit`:
 
@@ -145,7 +145,42 @@ import { Form, FormInput, useNForm } from 'najm-kit';
 | Feedback | Alert, Badge, Progress, Spinner, Toast |
 | Layout | Card, Sheet, Dialog, Popover, DropdownMenu, Tabs |
 | Data | Table (NTable), StatCard, DetailList |
-| Overlays | Command palette, Tooltip, Toast |
+| Overlays | Command palette, Tooltip, Toast |
+
+## Global form development tools
+
+Enable schema-driven test values once on the full application provider. Every
+`NForm` and `WizardForm` below it then fills from its Zod schema when F8 is
+pressed; applications do not need a second provider or a form-fill helper.
+
+```tsx
+import { NajmAppProvider } from "najm-kit/app";
+
+<NajmAppProvider formDevTools>
+  <App />
+</NajmAppProvider>;
+```
+
+Pass a boolean to control it from application settings:
+
+```tsx
+<NajmAppProvider formDevTools={formFillEnabled}>
+  <App />
+</NajmAppProvider>
+```
+
+Forms with live relation options can override only those fields. The provider
+still owns enablement and Najm Kit still owns schema traversal and generation.
+
+```tsx
+<NForm
+  schema={orderSchema}
+  devTools={{ overrides: { customerId: customerOptions } }}
+  onSubmit={saveOrder}
+>
+  {/* fields */}
+</NForm>
+```
 
 ## ImageInput and AvatarInput
 
@@ -212,10 +247,93 @@ Key behaviors:
   a newer value, and object URLs created by the component are tracked so
   consumer-owned blob URLs are never revoked.
 
-`AvatarInput` forwards every preview and accessibility prop unchanged while
-preserving its circular, size, fill, and camera-icon defaults.
-
-## Hooks
+`AvatarInput` forwards every preview and accessibility prop unchanged while
+preserving its circular, size, fill, and camera-icon defaults.
+
+## Formatting
+
+Pure formatters are available from the server-safe `najm-kit/format` entry.
+Money values are integer minor units and use the currency's own exponent (for
+example MAD has two decimals, JPY zero, and KWD three).
+
+```ts
+import { formatCurrency, formatDate, slugify } from 'najm-kit/format';
+
+formatCurrency(12_500, { locale: 'fr-MA', currency: 'MAD' });
+formatDate('2026-08-08T20:00:00Z', {
+  locale: 'fr-MA',
+  timeZone: 'Africa/Casablanca',
+});
+slugify('Najm Format & Pagination');
+```
+
+Client code can use the active locale, time zone, currency, and placeholder
+through `useNajmFormat`. `NajmAppProvider` mounts the format provider for you:
+
+```tsx
+import { NajmAppProvider } from 'najm-kit/app';
+import { useNajmFormat } from 'najm-kit';
+
+<NajmAppProvider
+  translations={translations}
+  currency="MAD"
+  locales={{ en: 'en-MA', fr: 'fr-MA' }}
+>
+  <App />
+</NajmAppProvider>
+
+function Total({ value }: { value: number }) {
+  return <span>{useNajmFormat().money(value)}</span>;
+}
+```
+
+## Offset pagination and queries
+
+`najm-kit/pagination` is server-safe and framework-independent. It accepts
+endpoints that return either `{ rows, total }` or a bare row array. When no
+total exists it probes for one extra row; when a total exists continuation is
+calculated without another request.
+
+```ts
+import {
+  createOffsetPagination,
+  fetchOffsetPage,
+} from 'najm-kit/pagination';
+
+const pagination = createOffsetPagination(pageIndex, pageSize);
+const page = await fetchOffsetPage(
+  ({ limit, offset }) => api.orders.list({ limit, offset }),
+  pagination,
+);
+```
+
+React Query consumers install the optional `@tanstack/react-query` peer and use
+the isolated `najm-kit/query` entry. `useResponsiveOffsetList` resolves numbered
+desktop paging versus card continuation and exposes props that plug directly
+into `NTable` and `createCardPagination`.
+
+```tsx
+import { NTable, createCardPagination } from 'najm-kit';
+import { useResponsiveOffsetList } from 'najm-kit/query';
+
+const list = useResponsiveOffsetList({
+  queryKey: ['orders'],
+  fetchPage: ({ limit, offset }) => api.orders.list({ limit, offset }),
+  strategy: 'paged',
+});
+
+<NTable
+  data={list.data}
+  columns={columns}
+  manualPagination
+  pageCount={list.pageCount}
+  pagination={list.pagination}
+  onPaginationChange={list.onPaginationChange}
+  cardPagination={createCardPagination(list, labels)}
+/>
+```
+
+## Hooks
 
 ```tsx
 import { useKeyboard } from 'najm-kit';

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

@@ -1,7 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React$1 from 'react';
 import React__default from 'react';
-import { b as NTablePaginationLabels, N as NajmTranslate } from './paginationLabels-DgHutNWz.js';
+import { b as NTablePaginationLabels, N as NajmTranslate } from './paginationLabels-dZLSNxfo.js';
 
 type NajmMode = 'light' | 'dark';
 type NajmAccent = 'neutral' | 'emerald' | 'green' | 'slate' | 'blue' | 'violet';

package/dist/adapters/app.d.ts

@@ -1,10 +1,11 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { Translations } from 'najm-i18n';
-import { N as NBrandingInput } from '../NBrandingContext-dkADu8JS.js';
+import { F as FormDevToolsOptions, N as NBrandingInput } from '../formFill-BcH-m9Kf.js';
 import { NajmNextUIProviderProps } from './next.js';
 import 'react';
-import '../NajmUIProvider-IFU3dFkn.js';
-import '../paginationLabels-DgHutNWz.js';
+import 'zod';
+import '../NajmUIProvider-BSbXaqak.js';
+import '../paginationLabels-dZLSNxfo.js';
 
 /** Branding shown by the kit's chrome. Purely presentational values. */
 interface NajmAppBranding {
@@ -13,6 +14,11 @@ interface NajmAppBranding {
     logoCollapsed?: string | null;
 }
 interface NajmAppProviderProps extends Omit<NajmNextUIProviderProps, 't'> {
+    /**
+     * Enables schema-driven form filling for every `NForm` and `WizardForm`.
+     * `true` uses F8; an options object can choose another shortcut.
+     */
+    formDevTools?: boolean | FormDevToolsOptions;
     /**
      * Catalog for `najm-i18n`. Supplying it mounts an `I18nProvider` and derives
      * the pagination labels from it, so `t` is not a prop here — the provider
@@ -99,6 +105,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, ...props }: NajmAppProviderProps): react_jsx_runtime.JSX.Element;
+declare function NajmAppProvider({ translations, initialLanguage, defaultLanguage, languageEndpoint, appName, initialBranding, formDevTools, ...props }: NajmAppProviderProps): react_jsx_runtime.JSX.Element;
 
 export { type NajmAppBranding, NajmAppProvider, type NajmAppProviderProps };

package/dist/adapters/app.mjs

@@ -1,9 +1,9 @@
 'use client';
-import { NBrandingStateProvider, NajmFormatProvider } from '../chunk-VKQIRB7F.mjs';
+import { FormDevToolsProvider, NBrandingStateProvider, NajmFormatProvider } from '../chunk-GHMR45H3.mjs';
 import { NajmNextUIProvider } from '../chunk-IRFFSAO2.mjs';
 import '../chunk-USZUOJMK.mjs';
 import '../chunk-KVZACF4G.mjs';
-import '../chunk-GPHWBOSP.mjs';
+import '../chunk-JABLSOQN.mjs';
 import * as React from 'react';
 import { I18nProvider, useTranslation } from 'najm-i18n/react';
 import { jsx } from 'react/jsx-runtime';
@@ -72,6 +72,7 @@ function NajmAppProvider({
   languageEndpoint = DEFAULT_LANGUAGE_ENDPOINT,
   appName,
   initialBranding,
+  formDevTools,
   ...props
 }) {
   const persistLanguage = React.useCallback(
@@ -91,8 +92,10 @@ function NajmAppProvider({
     [languageEndpoint]
   );
   const seeded = appName ? { appName, ...initialBranding } : initialBranding;
-  if (!translations) return /* @__PURE__ */ jsx(NajmAppNoI18n, { ...props, initialBranding: seeded });
-  return /* @__PURE__ */ jsx(
+  if (!translations) {
+    return /* @__PURE__ */ jsx(FormDevToolsProvider, { value: formDevTools, children: /* @__PURE__ */ jsx(NajmAppNoI18n, { ...props, initialBranding: seeded }) });
+  }
+  return /* @__PURE__ */ jsx(FormDevToolsProvider, { value: formDevTools, children: /* @__PURE__ */ jsx(
     I18nProvider,
     {
       translations,
@@ -101,7 +104,7 @@ function NajmAppProvider({
       onLanguageChange: persistLanguage,
       children: /* @__PURE__ */ jsx(NajmAppUI, { ...props, initialBranding: seeded })
     }
-  );
+  ) });
 }
 
 export { NajmAppProvider };

package/dist/adapters/next.d.ts

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

package/dist/{cardPagination-A6h8vXuk.d.ts → cardPagination-Bwf3tEeN.d.ts}

@@ -1,4 +1,4 @@
-import { N as NajmTranslate, a as NTableCardPagination } from './paginationLabels-DgHutNWz.js';
+import { N as NajmTranslate, a as NTableCardPagination } from './paginationLabels-dZLSNxfo.js';
 
 /**
  * How a list continues.
@@ -34,11 +34,18 @@ interface CardPaginationLabels {
     itemsLoaded?: (count: number) => string;
 }
 declare const DEFAULT_CARD_PAGINATION_KEY_PREFIX = "common.pagination";
+type DefaultCardPaginationPrefix = typeof DEFAULT_CARD_PAGINATION_KEY_PREFIX;
+/** The three catalog keys `buildCardPaginationLabels` reads under `Prefix`. */
+type CardPaginationKey<Prefix extends string = DefaultCardPaginationPrefix> = `${Prefix}.itemsLoaded` | `${Prefix}.loadMoreError` | `${Prefix}.retryLoadMore`;
 /**
  * Projects a translator onto the three card-continuation labels, matching
  * `buildPaginationLabels` — same prefix convention, same key-per-field naming.
+ *
+ * The keys are named in the type, not just built at runtime, so an application
+ * whose `t` is typed to a generated union of its catalog can pass it directly
+ * and have the three keys verified against that union.
  */
-declare function buildCardPaginationLabels(t: NajmTranslate, prefix?: string): CardPaginationLabels;
+declare function buildCardPaginationLabels<Prefix extends string = DefaultCardPaginationPrefix>(t: NajmTranslate<CardPaginationKey<Prefix>>, prefix?: Prefix): CardPaginationLabels;
 /**
  * Builds the `cardPagination` prop from the state a paged list already holds.
  *
@@ -47,7 +54,12 @@ declare function buildCardPaginationLabels(t: NajmTranslate, prefix?: string): C
  * reports the size it wants through `onPaginationChange`; `all` renders exactly
  * what it is given and shows no controls; `infinite` is the only one that needs
  * continuation wiring, which is why the other two ignore the labels entirely.
+ *
+ * The second argument takes a translator as well as a label bundle. That is the
+ * common case — a list page has `t` in hand and nothing else to say about these
+ * three strings — and passing it here rather than pre-building labels also means
+ * the lookups only happen in `infinite` mode, where they are rendered.
  */
-declare function createCardPagination(state: CardPaginationState, labels?: CardPaginationLabels): NTableCardPagination;
+declare function createCardPagination<Prefix extends string = DefaultCardPaginationPrefix>(state: CardPaginationState, labels?: CardPaginationLabels | NajmTranslate<CardPaginationKey<Prefix>>, prefix?: Prefix): NTableCardPagination;
 
-export { type CardPaginationLabels as C, DEFAULT_CARD_PAGINATION_KEY_PREFIX as D, type ListStrategy as L, type ResolvedListMode as R, type CardPaginationState as a, buildCardPaginationLabels as b, createCardPagination as c };
+export { type CardPaginationKey as C, DEFAULT_CARD_PAGINATION_KEY_PREFIX as D, type ListStrategy as L, type ResolvedListMode as R, type CardPaginationLabels as a, type CardPaginationState as b, buildCardPaginationLabels as c, createCardPagination as d };

package/dist/chunk-GHMR45H3.mjs

@@ -0,0 +1,333 @@
+import { useNajmPreferencesContext } from './chunk-USZUOJMK.mjs';
+import { humanizeToken, DEFAULT_PLACEHOLDER, formatRelativeTime, formatTime, formatDateTime, formatDate, formatPercent, formatNumber, formatCurrency } from './chunk-JABLSOQN.mjs';
+import * as React2 from 'react';
+import { createContext, useContext, useMemo, useState, useCallback } from 'react';
+import { jsx } from 'react/jsx-runtime';
+
+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() {
+}
+
+// src/components/form/formFill.ts
+var CITIES = ["Casablanca", "Rabat", "Marrakesh", "Tangier"];
+var SCHOOL_LEVELS = ["Primary", "Middle school", "Secondary school"];
+var CLOTHING_SIZES = ["6 years", "8 years", "10 years", "12 years"];
+function pick(values) {
+  if (values.length === 0) return void 0;
+  return values[Math.floor(Math.random() * values.length)];
+}
+function randomDigits(length) {
+  return Array.from({ length }, () => Math.floor(Math.random() * 10)).join("");
+}
+function randomToken(length = 8) {
+  const alphabet = "abcdefghijklmnopqrstuvwxyz0123456789";
+  return Array.from(
+    { length },
+    () => alphabet[Math.floor(Math.random() * alphabet.length)]
+  ).join("");
+}
+function asZodLike(schema) {
+  return schema && typeof schema === "object" ? schema : void 0;
+}
+function definition(schema) {
+  const current = asZodLike(schema);
+  return current?._def ?? current?.def ?? {};
+}
+function schemaKind(schema) {
+  const currentDefinition = definition(schema);
+  const raw = currentDefinition.typeName ?? currentDefinition.type;
+  if (typeof raw !== "string") return "";
+  return raw.replace(/^Zod/, "").toLowerCase();
+}
+function unwrap(schema) {
+  const seen = /* @__PURE__ */ new Set();
+  let current = asZodLike(schema);
+  while (current && !seen.has(current)) {
+    seen.add(current);
+    const kind = schemaKind(current);
+    const currentDefinition = definition(current);
+    const inner = currentDefinition.innerType ?? currentDefinition.schema ?? (kind === "pipe" ? currentDefinition.out ?? currentDefinition.in : void 0);
+    if (!inner || typeof inner !== "object") break;
+    current = inner;
+  }
+  return current;
+}
+function objectShape(schema) {
+  const current = unwrap(schema);
+  if (schemaKind(current) !== "object") return null;
+  const shape = current?.shape ?? definition(current).shape;
+  return typeof shape === "function" ? shape() : shape ?? null;
+}
+function arrayElement(schema) {
+  const current = unwrap(schema);
+  if (schemaKind(current) !== "array") return null;
+  const currentDefinition = definition(current);
+  const element = current?.element ?? currentDefinition.element ?? currentDefinition.type;
+  return element && typeof element === "object" ? element : null;
+}
+function enumValues(schema) {
+  const current = unwrap(schema);
+  const currentDefinition = definition(current);
+  const kind = schemaKind(current);
+  if (kind === "literal") {
+    const values2 = currentDefinition.values;
+    if (Array.isArray(values2)) return values2;
+    return "value" in currentDefinition ? [currentDefinition.value] : [];
+  }
+  if (kind !== "enum" && kind !== "nativeenum") return [];
+  const entries = currentDefinition.entries;
+  if (entries && typeof entries === "object") return Object.values(entries);
+  const values = currentDefinition.values;
+  if (Array.isArray(values)) return values;
+  return Array.isArray(current?.options) ? [...current.options] : [];
+}
+function stringFormat(schema) {
+  const currentDefinition = definition(unwrap(schema));
+  if (typeof currentDefinition.format === "string") return currentDefinition.format;
+  const checks = Array.isArray(currentDefinition.checks) ? currentDefinition.checks : [];
+  for (const check of checks) {
+    if (!check || typeof check !== "object") continue;
+    const value = check;
+    const format = value.format ?? value.kind;
+    if (typeof format === "string") return format;
+  }
+  return "";
+}
+function resolveOverride(override, fieldName) {
+  if (typeof override === "function") return override(fieldName);
+  if (Array.isArray(override)) {
+    const value = pick(override);
+    if (value && typeof value === "object" && "value" in value) {
+      return value.value;
+    }
+    return value;
+  }
+  return override;
+}
+function localDateInput(date = /* @__PURE__ */ new Date()) {
+  return `${date.getFullYear()}-${String(date.getMonth() + 1).padStart(2, "0")}-${String(date.getDate()).padStart(2, "0")}`;
+}
+function birthDate(child) {
+  const date = /* @__PURE__ */ new Date();
+  date.setFullYear(date.getFullYear() - (child ? 10 : 35));
+  return localDateInput(date);
+}
+function fieldValue(fieldName, schema, siblingFields) {
+  const key = fieldName.toLowerCase();
+  const current = unwrap(schema);
+  const kind = schemaKind(current);
+  const format = stringFormat(current);
+  const values = enumValues(current);
+  if (values.length) return pick(values);
+  if (kind === "boolean") return true;
+  if (kind === "number" || kind === "bigint") {
+    if (key.includes("sortorder")) return 1;
+    if (key.includes("quantity")) return 5;
+    return 10;
+  }
+  if (format === "uuid" || key.endsWith("uuid")) {
+    return "9cc2c93f-f545-4e07-9f77-f79f08a71dd5";
+  }
+  if (format === "email" || key.includes("email")) {
+    return `test-${randomToken()}@example.com`;
+  }
+  if (format === "url" || key === "image" || key.includes("imageurl") || key.endsWith("url")) {
+    return `https://picsum.photos/seed/${randomToken()}/800/600`;
+  }
+  if (key === "month") return `${localDateInput().slice(0, 7)}-01`;
+  if (key === "registrationdate") return localDateInput();
+  if (format === "date" || key.includes("dateofbirth")) {
+    const child = siblingFields.has("schoolLevel") || siblingFields.has("clothingSize");
+    return birthDate(child);
+  }
+  if (key.endsWith("id") || key.endsWith("by")) return "";
+  if (key === "name") {
+    if (siblingFields.has("sku")) return `Test product ${randomToken(4)}`;
+    if (siblingFields.has("slug")) return `Test category ${randomToken(4)}`;
+    return "Test User";
+  }
+  if (key.includes("legalname")) return "Test User";
+  if (key.includes("phone")) return `+2126${randomDigits(8)}`;
+  if (key.endsWith("cin")) return `AB${randomDigits(6)}`;
+  if (key.includes("address")) return `10 Test Street, ${pick(CITIES)}`;
+  if (key.includes("schoollevel")) return pick(SCHOOL_LEVELS);
+  if (key.includes("clothingsize")) return pick(CLOTHING_SIZES);
+  if (key.includes("shoesize")) return "36";
+  if (key.includes("relationship")) return "Legal guardian";
+  if (key.includes("activationtargetmad")) return "7500";
+  if (key === "slug") return `test-${randomToken(6)}`;
+  if (key === "sku") return `TEST-${randomToken(8).toUpperCase()}`;
+  if (key.includes("amountmad") || key.includes("pricemad") || key.includes("limitmad") || key.includes("targetmad")) {
+    return "100.00";
+  }
+  if (key.includes("reason")) return "Generated for form testing.";
+  if (key.includes("notes")) return "Generated form testing note.";
+  if (key.includes("description")) return "Generated description for form testing.";
+  if (key.includes("code")) return randomToken(8).toUpperCase();
+  return `Test ${fieldName}`;
+}
+function buildFormFill(schema, overrides = {}) {
+  const shape = objectShape(schema) ?? {};
+  const siblingFields = new Set(Object.keys(shape));
+  const output = {};
+  for (const [fieldName, fieldSchema] of Object.entries(shape)) {
+    if (Object.prototype.hasOwnProperty.call(overrides, fieldName)) {
+      output[fieldName] = resolveOverride(overrides[fieldName], fieldName);
+      continue;
+    }
+    const nestedShape = objectShape(fieldSchema);
+    if (nestedShape) {
+      output[fieldName] = buildFormFill(fieldSchema);
+      continue;
+    }
+    const element = arrayElement(fieldSchema);
+    if (element) {
+      output[fieldName] = objectShape(element) ? [buildFormFill(element)] : [fieldValue(fieldName, element, siblingFields)];
+      continue;
+    }
+    output[fieldName] = fieldValue(fieldName, fieldSchema, siblingFields);
+  }
+  return output;
+}
+var DEFAULT_FORM_DEV_TOOLS = {
+  enabled: false,
+  shortcut: "F8"
+};
+var FormDevToolsContext = createContext(
+  DEFAULT_FORM_DEV_TOOLS
+);
+function normalizeFormDevTools(value) {
+  if (typeof value === "boolean") {
+    return { ...DEFAULT_FORM_DEV_TOOLS, enabled: value };
+  }
+  if (!value) return DEFAULT_FORM_DEV_TOOLS;
+  return {
+    enabled: value.enabled ?? true,
+    shortcut: value.shortcut ?? DEFAULT_FORM_DEV_TOOLS.shortcut
+  };
+}
+function FormDevToolsProvider({
+  children,
+  value
+}) {
+  const resolved = useMemo(
+    () => normalizeFormDevTools(value),
+    [value]
+  );
+  return /* @__PURE__ */ jsx(FormDevToolsContext.Provider, { value: resolved, children });
+}
+function useResolvedFormDevTools(schema, local) {
+  const global = useContext(FormDevToolsContext);
+  const options = typeof local === "object" ? local : void 0;
+  const enabled = typeof local === "boolean" ? local : options?.enabled ?? global.enabled;
+  const shortcut = options?.shortcut ?? global.shortcut;
+  const fill = options?.fill ?? (schema ? () => buildFormFill(schema, options?.overrides) : void 0);
+  return { enabled, shortcut, fill };
+}
+var NajmFormatContext = React2.createContext(
+  null
+);
+function NajmFormatProvider({
+  children,
+  locale,
+  currency,
+  timeZone,
+  placeholder = DEFAULT_PLACEHOLDER
+}) {
+  const preferences = useNajmPreferencesContext();
+  const resolvedTimeZone = timeZone ?? preferences?.timeZone ?? Intl.DateTimeFormat().resolvedOptions().timeZone;
+  const value = React2.useMemo(() => {
+    const config = {
+      locale,
+      timeZone: resolvedTimeZone,
+      currency,
+      placeholder
+    };
+    return {
+      locale,
+      timeZone: resolvedTimeZone,
+      currency,
+      placeholder,
+      config,
+      money: (minorUnits) => formatCurrency(minorUnits, config),
+      number: (value_, options) => formatNumber(value_, config, options),
+      percent: (value_, digits) => formatPercent(value_, config, digits),
+      date: (value_, options) => formatDate(value_, config, options),
+      dateTime: (value_) => formatDateTime(value_, config),
+      time: (value_) => formatTime(value_, config),
+      relativeTime: (value_) => formatRelativeTime(value_, config),
+      humanize: humanizeToken
+    };
+  }, [locale, resolvedTimeZone, currency, placeholder]);
+  return /* @__PURE__ */ jsx(NajmFormatContext.Provider, { value, children });
+}
+function useNajmFormatContext() {
+  return React2.useContext(NajmFormatContext);
+}
+function useNajmFormat() {
+  const value = React2.useContext(NajmFormatContext);
+  if (!value) {
+    throw new Error(
+      "useNajmFormat must be rendered under a NajmFormatProvider or NajmAppProvider."
+    );
+  }
+  return value;
+}
+
+export { FormDevToolsProvider, NBrandingProvider, NBrandingStateProvider, NajmFormatProvider, buildFormFill, normalizeBranding, useNBranding, useNBrandingEditor, useNajmFormat, useNajmFormatContext, useResolvedFormDevTools };

package/dist/{chunk-GPHWBOSP.mjs → chunk-JABLSOQN.mjs}

@@ -100,5 +100,15 @@ function formatRelativeTime(value, { locale, placeholder = DEFAULT_PLACEHOLDER }
 function humanizeToken(value) {
   return value.trim().replace(/[_-]+/g, " ").replace(/\s+/g, " ").replace(/\b\w/g, (letter) => letter.toUpperCase());
 }
+function localDateInput(date = /* @__PURE__ */ new Date()) {
+  const month = String(date.getMonth() + 1).padStart(2, "0");
+  const day = String(date.getDate()).padStart(2, "0");
+  return `${date.getFullYear()}-${month}-${day}`;
+}
+function slugify(value, { upperCase = false, maxLength = 160 } = {}) {
+  const normalized = value.normalize("NFD").replace(/[\u0300-\u036f]/g, "").trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, maxLength);
+  const slug = normalized || crypto.randomUUID().slice(0, 8);
+  return upperCase ? slug.toUpperCase() : slug;
+}
 
-export { DEFAULT_PLACEHOLDER, formatCurrency, formatDate, formatDateTime, formatNumber, formatPercent, formatRelativeTime, formatTime, humanizeToken };
+export { DEFAULT_PLACEHOLDER, formatCurrency, formatDate, formatDateTime, formatNumber, formatPercent, formatRelativeTime, formatTime, humanizeToken, localDateInput, slugify };