@nxgt/material 1.0.0

package/dist/lib/i18n/translator.d.ts

@@ -0,0 +1,28 @@
+import { Language, LanguageProvider, MaterialLocaleKey, Translate } from './types';
+/**
+ * Reads the current language from `localStorage`, falling back to
+ * {@link FALLBACK_LANGUAGE} when unavailable or unsupported.
+ *
+ * This is only the default language source of {@link createTranslator}. When an
+ * `I18nProvider` is mounted, prefer passing `() => language` so translations
+ * follow the shared React state instead of storage.
+ */
+export declare function getLanguage(): Language;
+/**
+ * Builds a translate function over a resource bundle keyed by language.
+ *
+ * Lookups are dot-path based (`lodash.get`) and messages are formatted with
+ * ICU MessageFormat, so plurals/selects/interpolations all work. An unknown key
+ * is returned verbatim, which makes missing translations obvious without
+ * throwing.
+ *
+ * @example
+ * ```ts
+ * const translate = createTranslator<LocaleKey>(mergedResources);
+ * translate('material.command.title');
+ * translate('material.upload.dropzone.files-selected', { count: 3 }, () => 'fr');
+ * ```
+ */
+export declare function createTranslator<K extends string = MaterialLocaleKey>(bundle?: Record<string, any>, localeProvider?: LanguageProvider): Translate<K>;
+/** Translator bound to the base bundle owned by `@nxgt/material`. */
+export declare const translate: Translate<"material.filter.title" | "material.filter.reset" | "material.filter.trigger" | "material.filter.apply" | "material.filter.clear-all" | "material.code.copy" | "material.code.language" | "material.code.copied" | "material.code.word-wrap" | "material.pagination.next" | "material.pagination.previous" | "material.table.pagination.next" | "material.table.pagination.previous" | "material.table.pagination.go-to-next-page" | "material.table.pagination.go-to-previous-page" | "material.table.pagination.go-to-first-page" | "material.table.pagination.go-to-last-page" | "material.table.pagination.rows-per-page" | "material.table.pagination.rows-selected" | "material.table.pagination.page-of" | "material.table.labels.desc" | "material.table.labels.view" | "material.table.labels.hide" | "material.table.labels.asc" | "material.table.labels.actions" | "material.table.labels.delete-selected-rows" | "material.table.labels.toggle-columns" | "material.table.labels.no-data" | "material.table.delete-confirm.title" | "material.table.delete-confirm.cancel" | "material.table.delete-confirm.description" | "material.table.delete-confirm.confirm" | "material.banner.dismiss" | "material.tree.label" | "material.tree.expand" | "material.tree.collapse" | "material.copy.copy" | "material.copy.copied" | "material.command.title" | "material.command.description" | "material.language.fr" | "material.language.en" | "material.skeleton.loading" | "material.timeline.label" | "material.timeline.empty" | "material.upload.dropzone.idle" | "material.upload.dropzone.at-capacity" | "material.upload.dropzone.files-selected" | "material.empty-state.empty.title" | "material.empty-state.empty.description" | "material.empty-state.not-found.title" | "material.empty-state.not-found.description" | "material.empty-state.unauthorized.title" | "material.empty-state.unauthorized.description" | "material.empty-state.generic.title" | "material.empty-state.generic.description" | "material.image-field.replace" | "material.image-field.remove" | "material.image-field.choose" | "material.image-field.retry" | "material.buttons.add" | "material.buttons.save" | "material.buttons.load-more" | "material.buttons.ok" | "material.buttons.delete" | "material.json-viewer.expand" | "material.json-viewer.items" | "material.json-viewer.collapse" | "material.json-viewer.invalid" | "material.chat.send" | "material.chat.copy" | "material.chat.message" | "material.chat.empty" | "material.chat.retry" | "material.chat.attach" | "material.chat.remove-attachment" | "material.chat.scroll-to-latest" | "material.chat.add-reaction" | "material.chat.attachment-type" | "material.chat.attachment-max-files" | "material.chat.attachment-max-size" | "material.chat.placeholder" | "material.chat.typing" | "material.chat.empty-description" | "material.chat.send-failed" | "material.gallery.label" | "material.gallery.select" | "material.gallery.next" | "material.gallery.previous" | "material.gallery.open" | "material.gallery.repeat" | "material.gallery.close" | "material.gallery.download" | "material.gallery.play" | "material.gallery.empty" | "material.gallery.delete" | "material.gallery.empty-description" | "material.gallery.of" | "material.gallery.more" | "material.gallery.zoom-in" | "material.gallery.zoom-out" | "material.gallery.repeat-off" | "material.gallery.selected" | "material.gallery.clear-selection" | "material.notifications.label" | "material.notifications.search" | "material.notifications.dismiss" | "material.notifications.empty" | "material.notifications.empty-description" | "material.notifications.empty-unread" | "material.notifications.empty-unread-description" | "material.notifications.read-all" | "material.notifications.filter-all" | "material.notifications.filter-unread" | "material.notifications.filter-category-all" | "material.notifications.dismiss-item" | "material.education.progress" | "material.education.results" | "material.education.true" | "material.education.false" | "material.education.next" | "material.education.previous" | "material.education.submit" | "material.education.empty" | "material.education.retry" | "material.education.answer-placeholder" | "material.education.expected" | "material.education.answered" | "material.education.score" | "material.stx-player.audio" | "material.stx-player.video" | "material.stx-player.next" | "material.stx-player.previous" | "material.stx-player.repeat" | "material.stx-player.error" | "material.stx-player.loading" | "material.stx-player.pause" | "material.stx-player.play" | "material.stx-player.volume" | "material.stx-player.retry" | "material.stx-player.empty-description" | "material.stx-player.repeat-off" | "material.stx-player.mute" | "material.stx-player.unmute" | "material.stx-player.fullscreen" | "material.stx-player.exit-fullscreen" | "material.stx-player.pip" | "material.stx-player.exit-pip" | "material.stx-player.captions" | "material.stx-player.captions-off" | "material.stx-player.playback-rate" | "material.stx-player.queue" | "material.stx-player.now-playing" | "material.stx-player.buffering" | "material.stx-player.empty-title" | "material.stx-player.normal" | "material.attributes.buttons.add" | "material.attributes.buttons.save" | "material.attributes.form.label.label" | "material.attributes.form.label.placeholder" | "material.attributes.form.type.label" | "material.attributes.form.type.placeholder" | "material.attributes.form.name.label" | "material.attributes.form.name.placeholder" | "material.attributes.form.description.label" | "material.attributes.form.description.placeholder" | "material.attributes.form.default-value.label" | "material.attributes.form.default-value.placeholder" | "material.attributes.form.priority.label" | "material.attributes.form.priority.placeholder" | "material.attributes.form.options.label" | "material.attributes.form.options.placeholder" | "material.attributes.form.unit.label" | "material.attributes.form.unit.placeholder" | "material.attributes.messages.dialog" | "material.attributes.messages.empty" | "material.attributes.messages.create-succeeded" | "material.attributes.messages.update-succeeded" | "material.attributes.messages.delete-succeeded" | "material.attributes.messages.add-first" | "material.attributes.buttons.details" | "material.attributes.buttons.cancel" | "material.attributes.buttons.edit" | "material.attributes.buttons.remove" | "material.attributes.labels.attributes" | "material.attributes.labels.new-attribute" | "material.attributes.types.string" | "material.attributes.types.number" | "material.attributes.types.boolean" | "material.attributes.types.select" | "material.attributes.types.time" | "material.attributes.types.text" | "material.attributes.types.color" | "material.attributes.types.date" | "material.attributes.types.datetime" | "material.attributes.types.multi-select" | "material.attributes.types.rich-text" | "material.attributes.fields.label" | "material.attributes.fields.type" | "material.attributes.fields.name" | "material.attributes.fields.description" | "material.attributes.fields.default-value" | "material.attributes.fields.priority" | "material.attributes.fields.options" | "material.attributes.fields.unit" | "material.contacts.buttons.add" | "material.contacts.buttons.save" | "material.contacts.messages.dialog" | "material.contacts.messages.add-first" | "material.contacts.buttons.cancel" | "material.contacts.buttons.edit" | "material.contacts.buttons.remove" | "material.contacts.fields.label" | "material.contacts.fields.type" | "material.contacts.messages.no-contacts" | "material.contacts.labels.contacts" | "material.contacts.types.email" | "material.contacts.types.fax" | "material.contacts.types.mobile" | "material.contacts.types.phone" | "material.contacts.types.website" | "material.contacts.fields.value" | "material.contacts.placeholders.label" | "material.contacts.placeholders.email" | "material.contacts.placeholders.type" | "material.contacts.placeholders.value" | "material.contacts.placeholders.fax" | "material.contacts.placeholders.mobile" | "material.contacts.placeholders.phone" | "material.contacts.placeholders.website" | "material.opening-hours.buttons.add" | "material.opening-hours.buttons.save" | "material.opening-hours.messages.dialog" | "material.opening-hours.messages.add-first" | "material.opening-hours.buttons.cancel" | "material.opening-hours.buttons.edit" | "material.opening-hours.buttons.remove" | "material.opening-hours.messages.no-hours" | "material.opening-hours.buttons.add-all" | "material.opening-hours.labels.closed-all-day" | "material.opening-hours.labels.open-hours" | "material.opening-hours.fields.dayOfWeek" | "material.opening-hours.fields.openTime" | "material.opening-hours.fields.closeTime" | "material.opening-hours.fields.isClosed" | "material.opening-hours.placeholders.dayOfWeek" | "material.opening-hours.placeholders.openTime" | "material.opening-hours.placeholders.closeTime" | "material.opening-hours.days.0" | "material.opening-hours.days.1" | "material.opening-hours.days.2" | "material.opening-hours.days.3" | "material.opening-hours.days.4" | "material.opening-hours.days.5" | "material.opening-hours.days.6" | "material.opening-hours.daysShort.0" | "material.opening-hours.daysShort.1" | "material.opening-hours.daysShort.2" | "material.opening-hours.daysShort.3" | "material.opening-hours.daysShort.4" | "material.opening-hours.daysShort.5" | "material.opening-hours.daysShort.6" | "material.postal-address.buttons.add" | "material.postal-address.buttons.save" | "material.postal-address.messages.dialog" | "material.postal-address.messages.empty" | "material.postal-address.messages.add-first" | "material.postal-address.buttons.cancel" | "material.postal-address.buttons.edit" | "material.postal-address.buttons.remove" | "material.postal-address.labels.address" | "material.postal-address.fields.region" | "material.postal-address.fields.street" | "material.postal-address.fields.locality" | "material.postal-address.fields.postalCode" | "material.postal-address.fields.country" | "material.postal-address.placeholders.region" | "material.postal-address.placeholders.street" | "material.postal-address.placeholders.locality" | "material.postal-address.placeholders.postalCode" | "material.postal-address.placeholders.country" | "material.toast.buttons.close" | "material.toast.operations.error.title" | "material.toast.operations.success.title" | "material.toast.operations.loading.title" | "material.zod.default" | "material.zod.required" | "material.zod.invalid_value_single" | "material.zod.invalid_value_multiple" | "material.zod.too_big_inclusive" | "material.zod.too_big_exclusive" | "material.zod.too_big_no_unit_inclusive" | "material.zod.too_big_no_unit_exclusive" | "material.zod.too_small_inclusive" | "material.zod.too_small_exclusive" | "material.zod.too_small_no_unit_inclusive" | "material.zod.too_small_no_unit_exclusive" | "material.zod.not_multiple_of" | "material.zod.unrecognized_keys_single" | "material.zod.unrecognized_keys_multiple" | "material.zod.invalid_key" | "material.zod.invalid_union" | "material.zod.invalid_element" | "material.zod.invalid_type.string" | "material.zod.invalid_type.number" | "material.zod.invalid_type.bigint" | "material.zod.invalid_type.boolean" | "material.zod.invalid_type.symbol" | "material.zod.invalid_type.undefined" | "material.zod.invalid_type.object" | "material.zod.invalid_type.function" | "material.zod.invalid_type.default" | "material.zod.invalid_type.date" | "material.zod.invalid_type.array" | "material.zod.invalid_type.null" | "material.zod.invalid_type.enum" | "material.zod.invalid_format.includes" | "material.zod.invalid_format.default" | "material.zod.invalid_format.starts_with" | "material.zod.invalid_format.ends_with" | "material.zod.invalid_format.regex" | "material.zod.nouns.time" | "material.zod.nouns.url" | "material.zod.nouns.email" | "material.zod.nouns.date" | "material.zod.nouns.emoji" | "material.zod.nouns.nanoid" | "material.zod.nouns.cuid" | "material.zod.nouns.cuid2" | "material.zod.nouns.duration" | "material.zod.nouns.datetime" | "material.zod.nouns.regex" | "material.zod.nouns.uuid" | "material.zod.nouns.uuidv4" | "material.zod.nouns.uuidv6" | "material.zod.nouns.guid" | "material.zod.nouns.ulid" | "material.zod.nouns.xid" | "material.zod.nouns.ksuid" | "material.zod.nouns.ipv4" | "material.zod.nouns.ipv6" | "material.zod.nouns.mac" | "material.zod.nouns.cidrv4" | "material.zod.nouns.cidrv6" | "material.zod.nouns.base64" | "material.zod.nouns.base64url" | "material.zod.nouns.json_string" | "material.zod.nouns.e164" | "material.zod.nouns.jwt" | "material.zod.nouns.template_literal" | "material.zod.sizing.string.unit" | "material.zod.sizing.string.verb" | "material.zod.sizing.set.unit" | "material.zod.sizing.set.verb" | "material.zod.sizing.file.unit" | "material.zod.sizing.file.verb" | "material.zod.sizing.array.unit" | "material.zod.sizing.array.verb" | "material.pdf-reader.label" | "material.pdf-reader.search" | "material.pdf-reader.rotate" | "material.pdf-reader.error" | "material.pdf-reader.loading" | "material.pdf-reader.download" | "material.pdf-reader.print" | "material.pdf-reader.sidebar" | "material.pdf-reader.unlock" | "material.pdf-reader.empty" | "material.pdf-reader.zoom-in" | "material.pdf-reader.zoom-out" | "material.pdf-reader.fullscreen" | "material.pdf-reader.exit-fullscreen" | "material.pdf-reader.password" | "material.pdf-reader.password-placeholder" | "material.pdf-reader.pages" | "material.pdf-reader.outline" | "material.pdf-reader.outline-empty" | "material.pdf-reader.fit-width" | "material.pdf-reader.fit-page" | "material.pdf-reader.fit-width-full" | "material.pdf-reader.fit-page-full" | "material.pdf-reader.sidebar-toggle" | "material.pdf-reader.previous-page" | "material.pdf-reader.next-page" | "material.pdf-reader.current-page" | "material.pdf-reader.search-shortcut" | "material.pdf-reader.search-next" | "material.pdf-reader.search-prev" | "material.pdf-reader.night" | "material.pdf-reader.day" | "material.pdf-reader.thumbnails" | "material.pdf-reader.go-to-page" | "material.image-cropper.title" | "material.image-cropper.error" | "material.image-cropper.cancel" | "material.image-cropper.rotate-left" | "material.image-cropper.rotate-right" | "material.image-cropper.zoom" | "material.image-cropper.apply" | "material.image-cropper.free" | "material.avatar-group.more" | "material.search-field.placeholder" | "material.search-field.clear" | "material.password-field.strong" | "material.password-field.show" | "material.password-field.hide" | "material.password-field.too-weak" | "material.password-field.weak" | "material.password-field.fair" | "material.password-field.very-strong" | "material.stat-card.increase" | "material.stat-card.decrease" | "material.stat-card.unchanged" | "material.color-field.open" | "material.split-button.more" | "material.file-list.label" | "material.file-list.replace" | "material.file-list.download" | "material.file-list.remove" | "material.file-list.empty" | "material.file-list.retry" | "material.inline-edit.cancel" | "material.inline-edit.edit" | "material.inline-edit.save" | "material.inline-edit.placeholder" | "material.number-field.increase" | "material.number-field.decrease" | "material.textarea-field.count" | "material.chip.dismiss" | "material.pagination.page" | "material.pagination.more" | "material.phone-field.search" | "material.phone-field.empty" | "material.phone-field.placeholder" | "material.phone-field.country" | "material.rating-field.star" | "material.theme-toggle.light" | "material.theme-toggle.dark" | "material.theme-toggle.system" | "material.language-switcher.label" | "material.email-field.invalid" | "material.email-field.mailto" | "material.url-field.open" | "material.url-field.invalid" | "material.stepper.step" | "material.combobox-field.empty" | "material.combobox-field.placeholder" | "material.avatar.online" | "material.avatar.offline" | "material.avatar.away" | "material.avatar.busy" | "material.avatar.active" | "material.country-field.placeholder" | "material.duration-field.hours" | "material.duration-field.minutes" | "material.count-badge.label" | "material.timezone-field.placeholder" | "material.app-shell.home" | "material.app-shell.open-menu" | "material.transfer-list.search" | "material.transfer-list.max" | "material.transfer-list.selected" | "material.transfer-list.count" | "material.transfer-list.available" | "material.transfer-list.select-all" | "material.transfer-list.move-to-selected" | "material.transfer-list.move-all-to-selected" | "material.transfer-list.move-to-available" | "material.transfer-list.move-all-to-available" | "material.transfer-list.move-up" | "material.transfer-list.move-down" | "material.transfer-list.empty-available" | "material.transfer-list.empty-selected" | "material.transfer-list.empty-filter" | "material.transfer-list.locked" | "material.transfer-list.drag" | "material.sortable-list.search" | "material.sortable-list.empty" | "material.sortable-list.move-up" | "material.sortable-list.move-down" | "material.sortable-list.empty-filter" | "material.sortable-list.drag" | "material.event-calendar.search" | "material.event-calendar.title" | "material.event-calendar.color" | "material.event-calendar.next" | "material.event-calendar.previous" | "material.event-calendar.add" | "material.event-calendar.delete-confirm" | "material.event-calendar.description" | "material.event-calendar.empty" | "material.event-calendar.delete" | "material.event-calendar.more" | "material.event-calendar.day" | "material.event-calendar.drag" | "material.event-calendar.today" | "material.event-calendar.month" | "material.event-calendar.week" | "material.event-calendar.workweek" | "material.event-calendar.agenda" | "material.event-calendar.all-day" | "material.event-calendar.events" | "material.event-calendar.resize" | "material.event-calendar.new-event" | "material.event-calendar.new-all-day" | "material.event-calendar.pick-date" | "material.event-calendar.no-results" | "material.dnd.drag" | "material.kanban.search" | "material.kanban.empty" | "material.kanban.drag" | "material.kanban.no-results" | "material.kanban.wip" | "material.kanban.drag-column" | "material.kanban.ungrouped" | "material.kanban.collapse-group" | "material.kanban.expand-group" | "material.kanban.collapse-column" | "material.kanban.expand-column" | "material.kanban.add-card" | "material.kanban.new-card" | "material.kanban.card-title" | "material.kanban.subtitle" | "material.kanban.wip-full">;

package/dist/lib/i18n/translator.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/i18n/types.d.ts

@@ -0,0 +1,43 @@
+import { resources } from './resources';
+type PathImpl<T, K extends keyof T> = K extends string ? T[K] extends Record<string, any> ? `${K}.${Path<T[K]>}` : K : never;
+/**
+ * Union of every dot-separated leaf path of `T`.
+ *
+ * @example
+ * ```ts
+ * type Keys = Path<{ a: { b: string } }>; // 'a.b'
+ * ```
+ */
+export type Path<T> = PathImpl<T, keyof T>;
+/**
+ * Flattens `T` into a record whose keys are every dot-separated leaf path of
+ * `T` and whose values are all `R`. Used to derive the `LocaleKey` union of a
+ * resource bundle:
+ *
+ * @example
+ * ```ts
+ * type LocaleKey = keyof FlatObject<typeof resources.en, string>;
+ * ```
+ */
+export type FlatObject<T, R> = {
+    [K in Path<T>]: R;
+};
+/** Languages supported by the base bundle shipped with `@nxgt/material`. */
+export type Language = keyof typeof resources;
+/** Every translation key owned by `@nxgt/material` itself (`material.*`). */
+export type MaterialLocaleKey = keyof FlatObject<typeof resources.en, string>;
+/** Values interpolated into an ICU message. */
+export type TranslationContext = {
+    [k: string]: ((children: any) => any) | string | number | boolean | object | Record<string, any>;
+} | undefined;
+/** Either a language, or a function resolving the current language lazily. */
+export type LanguageProvider = (() => Language) | Language;
+/** A translate function produced by `createTranslator`. */
+export type Translate<TLocaleKey extends string> = (key: TLocaleKey, context?: TranslationContext, provideLanguage?: LanguageProvider) => string;
+/** Shared language state exposed by `I18nProvider`. */
+export type I18nContextValue = {
+    language: Language;
+    changeLanguage: (value: Language) => void;
+    supportedLanguages: Language[];
+};
+export {};

package/dist/lib/i18n/use-material-translation.d.ts

@@ -0,0 +1,21 @@
+import { MaterialLocaleKey, TranslationContext } from './types';
+/**
+ * useMaterialTranslation - Translation hook for components shipped by this
+ * package, resilient to the provider being absent.
+ *
+ * Components in `lib/components/` must keep rendering their historical English
+ * copy in apps that have not mounted {@link I18nProvider} yet, so `t` always
+ * takes an explicit `fallback` and returns it when either no provider is
+ * mounted or the key is missing from the bundle.
+ *
+ * @example
+ * ```tsx
+ * const { t } = useMaterialTranslation();
+ * <span>{t('material.command.title', 'Command Palette')}</span>
+ * ```
+ */
+export declare function useMaterialTranslation(): {
+    t: (key: MaterialLocaleKey, fallback: string, options?: TranslationContext) => string;
+    language: "fr" | "en" | undefined;
+    hasProvider: boolean;
+};

package/dist/lib/i18n/use-typed-translation.d.ts

@@ -0,0 +1,27 @@
+import { LanguageProvider, TranslationContext } from './types';
+/**
+ * createTypedTranslation - Builds an app's `useTranslation()` hook.
+ *
+ * Each consuming app instantiates this **once**, against a translator built
+ * from its own merged resources, and gets a fully typed hook back. The returned
+ * `t` re-binds on every language change, so all consumers re-render together.
+ *
+ * @example
+ * ```ts
+ * // app/i18n/hooks.ts
+ * import { createTranslator, createTypedTranslation, mergeResources } from '@nxgt/material/i18n';
+ *
+ * const resources = mergeResources(materialResources, appResources);
+ * type LocaleKey = keyof FlatObject<typeof resources.en, string>;
+ *
+ * export const translate = createTranslator<LocaleKey>(resources);
+ * export const useTranslation = createTypedTranslation<LocaleKey>(translate);
+ * ```
+ */
+export declare function createTypedTranslation<TLocaleKey extends string>(translate: (key: TLocaleKey, options?: TranslationContext, lang?: LanguageProvider) => string): () => {
+    t: (key: TLocaleKey, options?: TranslationContext) => string;
+    i18n: {
+        language: "fr" | "en";
+        changeLanguage: (value: import('./types').Language) => void;
+    };
+};

package/dist/lib/lib/array.utils.d.ts

@@ -0,0 +1,13 @@
+export declare function uniqueArray<T>(array: T[]): T[];
+export declare function findByKey<T extends object, K extends keyof T>(array: T[], path: K, value: T[K]): T | undefined;
+export declare function findByKeyIn<T extends object, K extends keyof T>(array: T[], path: K, values: T[K][]): T[];
+export declare function useFindByKey<T extends Record<string, any>, K extends keyof T>(items: T[], key: K): {
+    findByKey: (value: T[K]) => T | undefined;
+    findByKeyIn: (values: T[K][]) => T[];
+};
+export declare function useFindById<T extends {
+    id: string;
+}>(items: T[]): {
+    findByKey: (value: T["id"]) => T | undefined;
+    findByKeyIn: (values: T["id"][]) => T[];
+};

package/dist/lib/lib/array.utils.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/lib/build-field-options.d.ts

@@ -0,0 +1,8 @@
+import { Path } from 'react-hook-form';
+export declare function buildFieldOptions<T extends string>(values: T[], { valueKey, label, }: {
+    valueKey: Path<T>;
+    label: Path<T> | ((data: T) => string);
+}): {
+    value: string extends Path<T> ? any : import('lodash').GetFieldType<T, Path<T>, "Path">;
+    label: any;
+}[];

package/dist/lib/lib/build-field-options.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/lib/client-only.utils.d.ts

@@ -0,0 +1,22 @@
+import { ComponentType } from 'react';
+/**
+ * Wraps a component so it renders only in the browser, after mount.
+ *
+ * For components whose dependencies are browser-only — pdf.js runs
+ * `new DOMMatrix()` at module scope, and the SSR consumers of this package
+ * evaluate every barrel in the server process at BOOT. The dependency itself
+ * must therefore be reached through a dynamic `import()` (see
+ * `components/ui/pdf-viewer/react-pdf.lazy.ts`); this wrapper supplies what
+ * that needs on the rendering side:
+ *
+ * - `useIsClient` is `false` on the server AND on the first client render, so
+ *   hydration compares `null` with `null` — no mismatch, no console error;
+ * - a `Suspense` boundary for the `lazy()` pieces inside, appearing only after
+ *   mount, where there is nothing to mismatch against;
+ * - a context so a wrapper nested in another wrapper's subtree renders
+ *   straight through instead of blanking one more frame.
+ *
+ * A `typeof window` guard around a statement is NOT an alternative when the
+ * import is the side effect; the module has been evaluated by then.
+ */
+export declare function clientOnly<P extends object>(Component: ComponentType<P>): ComponentType<P>;

package/dist/lib/lib/date.utils.d.ts

@@ -0,0 +1,28 @@
+import { Locale } from 'date-fns';
+/**
+ * Formats an ISO string, optionally in a given date-fns locale.
+ *
+ * Pass `locale` to render month/day names in the user's language — the
+ * `useLocalizedDate()` hook pre-binds it from the current `I18nProvider`
+ * language, so components rarely need to resolve it themselves.
+ *
+ * @example
+ * ```ts
+ * DATE_UTILS.format('2023-10-01T12:00:00'); // 'Oct 1, 2023'
+ * DATE_UTILS.format('2023-10-01T12:00:00', 'PP', fr); // '1 oct. 2023'
+ * ```
+ */
+declare function formatFromISO(value?: string | null, formatStr?: string, locale?: Locale): string;
+declare function parseFromTimestring(timeString: string): Date;
+declare function parseFromISOString(isoString?: string): Date | null;
+export declare function formatDateRangeFilter(value: any): {
+    from: string | undefined;
+    to: string | undefined;
+} | undefined;
+export declare const DATE_UTILS: {
+    format: typeof formatFromISO;
+    parseFromTimestring: typeof parseFromTimestring;
+    parseFromISOString: typeof parseFromISOString;
+    formatDateRangeFilter: typeof formatDateRangeFilter;
+};
+export {};

package/dist/lib/lib/date.utils.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/lib/format.utils.d.ts

@@ -0,0 +1,4 @@
+export declare function ifEmptyString<T extends string, R>(value?: T | null, fallbackValue?: R): T | R | undefined;
+export declare function ifEmptyList<T extends string[], R>(value?: T | null, fallbackValue?: R): T | R | undefined;
+export declare function objectToFormData<T extends object>(data: T): FormData;
+export declare function formDataToObject<T extends object>(formData: FormData): T;

package/dist/lib/lib/format.utils.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/lib/index.d.ts

@@ -0,0 +1,17 @@
+export * from './array.utils';
+export * from './build-field-options';
+export * from './client-only.utils';
+export * from './date.utils';
+export * from './format.utils';
+export * from './number.utils';
+export * from './object.utils';
+export * from './promise.utils';
+export * from './redux';
+export * from './storage.utils';
+export * from './string.utils';
+export * from './styles.utils';
+export * from './ui.utils';
+export * from './upload.utils';
+export * from './url.utils';
+export * from './utils';
+export * from './zod-error-map';

package/dist/lib/lib/number.utils.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Formats a number with `Intl.NumberFormat`.
+ *
+ * `language` is per-call on purpose: this helper stays framework-free. When
+ * translation context is available, source it from `useI18nContext()` (or
+ * `useOptionalI18nContext()` inside components that must render without a
+ * provider) rather than hardcoding a locale.
+ *
+ * @example
+ * ```ts
+ * const { language } = useI18nContext();
+ * formatNumber(1234.5, { language, style: 'currency', currency: 'EUR' });
+ * ```
+ */
+export declare function formatNumber(value: number, options?: Intl.NumberFormatOptions & {
+    language?: string;
+}): string;

package/dist/lib/lib/number.utils.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/lib/object.utils.d.ts

@@ -0,0 +1,11 @@
+export declare function pick<Data extends object, Key extends keyof Data>(data: Data, keys: Key | Key[]): Pick<Data, Key>;
+export declare function omit<Data extends object, Key extends keyof Data>(data: Data, keys: Key | Key[]): Omit<Data, Key>;
+export declare function cast<T>(value: any): T;
+export declare function castAsync<T>(value: Promise<any>): Promise<T>;
+/**
+ * Removes properties with undefined values from an object. If the cleanNulls parameter is set to true, it also removes properties with null values.
+ * @param obj - The object to be cleaned.
+ * @param cleanNulls - A boolean indicating whether to also remove properties with null values. Defaults to false.
+ * @returns A new object with the specified properties removed.
+ */
+export declare function cleanObject<T extends object>(obj: T, cleanNulls?: boolean): Partial<T>;

package/dist/lib/lib/object.utils.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/lib/promise.utils.d.ts

@@ -0,0 +1 @@
+export declare function delay(ms: number): Promise<unknown>;

package/dist/lib/lib/promise.utils.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/lib/redux/async-slice.d.ts

@@ -0,0 +1,6 @@
+export type AsyncRejected = {
+    rejectValue: {
+        message: string;
+    };
+};
+export declare const createAsyncSlice: <State, CaseReducers extends import('@reduxjs/toolkit').SliceCaseReducers<State>, Name extends string, Selectors extends import('@reduxjs/toolkit').SliceSelectors<State>, ReducerPath extends string = Name>(options: import('@reduxjs/toolkit').CreateSliceOptions<State, CaseReducers, Name, ReducerPath, Selectors>) => import('@reduxjs/toolkit').Slice<State, CaseReducers, Name, ReducerPath, Selectors>;

package/dist/lib/lib/redux/filter-slice.d.ts

@@ -0,0 +1,23 @@
+import { ReducerCreators, SliceCaseReducers, SliceSelectors } from '@reduxjs/toolkit';
+export declare function createSliceWithFilter<T extends {
+    filter?: any;
+    sort?: any;
+}, Reducers extends SliceCaseReducers<T>, Selectors extends SliceSelectors<T>, Name extends string>({ name, initialState, reducers, selectors, }: {
+    name: Name;
+    initialState: T;
+    reducers?: (creators: ReducerCreators<T>) => Reducers;
+    selectors?: Selectors;
+}): import('@reduxjs/toolkit').Slice<T, {
+    updateFilter: import('@reduxjs/toolkit').CaseReducer<T, {
+        payload: Pick<T, "sort" | "filter">;
+        type: string;
+    }> & {
+        _reducerDefinitionType: import("@reduxjs/toolkit").ReducerType.reducer;
+    };
+    resetFilter: import('@reduxjs/toolkit').CaseReducer<T, {
+        payload: void;
+        type: string;
+    }> & {
+        _reducerDefinitionType: import("@reduxjs/toolkit").ReducerType.reducer;
+    };
+}, Name, Name, Selectors>;

package/dist/lib/lib/redux/filter-slice.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/lib/redux/index.d.ts

@@ -0,0 +1,7 @@
+export * from './async-slice';
+export * from './filter-slice';
+export * from './status-slice';
+export * from './step-form-slice';
+export * from './use-actions';
+export * from './use-slice-reducer';
+export * from './use-slice-selector';

package/dist/lib/lib/redux/status-slice.d.ts

@@ -0,0 +1,50 @@
+import { PayloadAction, SliceCaseReducers, SliceSelectors, ValidateSliceCaseReducers } from '@reduxjs/toolkit';
+import { Status } from '../../models';
+export declare const createStatusSlice: <T, Reducers extends SliceCaseReducers<Status<T>>, Selectors extends SliceSelectors<Status<T>>, Name extends string>({ name, initialState, reducers, selectors, }: {
+    name: Name;
+    initialState?: Status<T>;
+    reducers?: ValidateSliceCaseReducers<Status<T>, Reducers>;
+    selectors?: Selectors;
+}) => import('@reduxjs/toolkit').Slice<Status<T>, {
+    reset(state: {
+        data?: (T extends object ? import('immer').Draft<T> : T) | null | undefined;
+        status: "success" | "loading" | "idle" | "error";
+        error?: string | undefined;
+    }): void;
+    start(state: {
+        data?: (T extends object ? import('immer').Draft<T> : T) | null | undefined;
+        status: "success" | "loading" | "idle" | "error";
+        error?: string | undefined;
+    }): void;
+    success(state: Status<T>, action: PayloadAction<T>): void;
+    error(state: Status<T>, action: PayloadAction<string>): void;
+} & Reducers & { [T_1 in keyof Reducers]: Reducers[T_1] extends {
+    reducer(s: Status<T>, action?: infer A): any;
+} ? {
+    prepare(...a: never[]): Omit<A, "type">;
+} : {}; }, Name, Name, Selectors>;
+type InferValue<T> = T extends Status<infer V> ? V : never;
+export declare const createStatusesSlice: <T extends Record<string, Status<any>>, Reducers extends SliceCaseReducers<T>, Selectors extends SliceSelectors<T>, Name extends string>({ name, initialState, reducers, selectors, }: {
+    name: Name;
+    initialState: T;
+    reducers?: ValidateSliceCaseReducers<T, Reducers>;
+    selectors?: Selectors;
+}) => import('@reduxjs/toolkit').Slice<T, {
+    reset<K extends keyof T>(state: T, action: PayloadAction<K>): void;
+    start<K extends keyof T>(state: T, action: PayloadAction<K>): void;
+    success<K extends keyof T>(state: T, action: PayloadAction<{
+        path: K;
+        data: InferValue<T[K]>;
+    }>): void;
+    error<K extends keyof T>(state: T, action: PayloadAction<{
+        path: K;
+        message: string;
+    }>): void;
+} & Reducers & { [T_1 in keyof Reducers]: Reducers[T_1] extends {
+    reducer(s: T, action?: infer A): any;
+} ? {
+    prepare(...a: never[]): Omit<A, "type">;
+} : {}; }, Name, Name, Selectors & {
+    status(state: T, path: any): "error" | "success" | "loading" | "idle";
+}>;
+export {};

package/dist/lib/lib/redux/status-slice.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/lib/redux/step-form-slice.d.ts

@@ -0,0 +1,48 @@
+import { ReducerCreators, SliceCaseReducers, SliceSelectors } from '@reduxjs/toolkit';
+import { FunctionOr } from '../../types';
+export type StepFormState<T extends Record<string, any>> = {
+    isDirty: boolean;
+    step: number;
+    values: Partial<T>;
+};
+export declare const createStepFormSlice: <T extends Record<string, any>, Reducers extends SliceCaseReducers<StepFormState<T>> = SliceCaseReducers<StepFormState<T>>, Selectors extends SliceSelectors<StepFormState<T>> = SliceSelectors<StepFormState<T>>, Name extends string = string>({ name, initialState, reducers, selectors, }: {
+    name: Name;
+    initialState?: Partial<T>;
+    reducers?: (creators: ReducerCreators<StepFormState<T>>) => Reducers;
+    selectors?: Selectors;
+}) => import('@reduxjs/toolkit').Slice<{
+    values: {};
+    isDirty: boolean;
+    step: number;
+}, {
+    updateStep: import('@reduxjs/toolkit').CaseReducer<{
+        values: {};
+        isDirty: boolean;
+        step: number;
+    }, {
+        payload: FunctionOr<number>;
+        type: string;
+    }> & {
+        _reducerDefinitionType: import("@reduxjs/toolkit").ReducerType.reducer;
+    };
+    updateFormValues: import('@reduxjs/toolkit').CaseReducer<{
+        values: {};
+        isDirty: boolean;
+        step: number;
+    }, {
+        payload: FunctionOr<Partial<T>>;
+        type: string;
+    }> & {
+        _reducerDefinitionType: import("@reduxjs/toolkit").ReducerType.reducer;
+    };
+    reset: import('@reduxjs/toolkit').CaseReducer<{
+        values: {};
+        isDirty: boolean;
+        step: number;
+    }, {
+        payload: void;
+        type: string;
+    }> & {
+        _reducerDefinitionType: import("@reduxjs/toolkit").ReducerType.reducer;
+    };
+}, Name, Name, Selectors>;

package/dist/lib/lib/redux/step-form-slice.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/lib/redux/use-actions.d.ts

@@ -0,0 +1,2 @@
+import { ActionCreatorsMapObject } from '@reduxjs/toolkit';
+export declare function useActions<T extends ActionCreatorsMapObject>(actions: T, deps?: unknown[]): T;

package/dist/lib/lib/redux/use-slice-reducer.d.ts

@@ -0,0 +1,3 @@
+import { CaseReducerActions, Slice, SliceCaseReducers, SliceSelectors } from '@reduxjs/toolkit';
+export declare function resolveSliceState<State extends object>(base: State, overrides?: Partial<State>): State;
+export declare function useSliceReducer<State extends object, CaseReducers extends SliceCaseReducers<State>, Name extends string, Selectors extends SliceSelectors<State>, ReducerPath extends string = Name>(slice: Slice<State, CaseReducers, Name, ReducerPath, Selectors>, initialState?: Partial<State>): readonly [State, { [K in keyof CaseReducerActions<CaseReducers, Name>]: (...args: Parameters<CaseReducerActions<CaseReducers, Name>[K]>) => void; }];

package/dist/lib/lib/redux/use-slice-reducer.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/lib/redux/use-slice-selector.d.ts

@@ -0,0 +1,5 @@
+/**
+ *
+ *
+ */
+export declare function useSliceSelector<S, T>(state: S, selector: (state: S) => T): T;

package/dist/lib/lib/storage.utils.d.ts

@@ -0,0 +1,8 @@
+export declare function safeGetItem<T>(key: string, defaultValue: T): T;
+export declare function safeSetItem<T>(key: string, value: T): void;
+export declare function safeRemoveItem(key: string): void;
+export declare const LOCALE_STORE_UTILS: {
+    safeGetItem: typeof safeGetItem;
+    safeSetItem: typeof safeSetItem;
+    safeRemoveItem: typeof safeRemoveItem;
+};

package/dist/lib/lib/storage.utils.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/lib/string.utils.d.ts

@@ -0,0 +1,6 @@
+export declare function enumToKebabCase(value?: string): string;
+export declare function joinTruthyParts(parts: Array<string | null | undefined | false>, separator?: string): string;
+export declare const STRING_UTILS: {
+    enumToKebabCase: typeof enumToKebabCase;
+    joinTruthyParts: typeof joinTruthyParts;
+};

package/dist/lib/lib/string.utils.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/lib/styles.utils.d.ts

@@ -0,0 +1,3 @@
+export declare const STYLES_UTILS: {
+    colorFromVariable(name: string, alpha?: number): string;
+};

package/dist/lib/lib/styles.utils.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/lib/ui.utils.d.ts

@@ -0,0 +1,7 @@
+import { ReactNode } from 'react';
+/**
+ * A slot is a piece of content that can be either a ReactNode or a function that returns a ReactNode given some context.
+ */
+export type ContentSlot<T> = ReactNode | ((context: T) => ReactNode);
+/** Resolves either form of a slot. */
+export declare const renderSlot: <T>(slot: ContentSlot<T> | undefined, context: T) => ReactNode;

package/dist/lib/lib/upload.utils.d.ts

@@ -0,0 +1 @@
+export declare const convertToFormData: <T extends object = FormData>(data: File | (File | undefined)[], fieldName?: string) => T;

package/dist/lib/lib/upload.utils.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/lib/url.utils.d.ts

@@ -0,0 +1,2 @@
+export declare function searchParams(request: Request): URLSearchParams;
+export declare function searchParam(request: Request, key: string): string | null;

package/dist/lib/lib/url.utils.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/lib/utils.d.ts

@@ -0,0 +1,2 @@
+import { ClassValue } from 'clsx';
+export declare function cn(...inputs: ClassValue[]): string;

package/dist/lib/lib/utils.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/lib/zod-error-map.d.ts

@@ -0,0 +1,26 @@
+/**
+ * parsedType - Best-effort runtime type name for a Zod issue's `input`.
+ *
+ * Mirrors Zod's own `parsedType` helper (not exported by the `zod` package),
+ * used to interpolate `{received}` into the `invalid_type` message.
+ */
+export declare const parsedType: (data: any) => string;
+/**
+ * zodLocaleError - Zod v4 issue-code -> message error map, i18n'd through
+ * `@nxgt/material`'s own reserved `material.zod.*` namespace.
+ *
+ * Self-contained on purpose: it reads the current language directly from
+ * `localStorage` (the same key `I18nProvider` persists to) and formats
+ * against this package's own base bundle, so it produces sensible
+ * (English-fallback) messages even in an app that hasn't merged material's
+ * i18n resources or mounted `I18nProvider`.
+ *
+ * @example
+ * ```ts
+ * import { z } from 'zod';
+ * import { zodLocaleError } from '@nxgt/material/lib';
+ *
+ * z.config({ customError: zodLocaleError() });
+ * ```
+ */
+export declare const zodLocaleError: () => any;

package/dist/lib/lib/zod-error-map.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/main.d.ts

@@ -0,0 +1,6 @@
+export * from './components';
+export * from './hooks';
+export * from './i18n';
+export * from './lib';
+export * from './models';
+export * from './types';

package/dist/lib/models/index.d.ts

@@ -0,0 +1 @@
+export * from './status';

package/dist/lib/models/status.d.ts

@@ -0,0 +1,5 @@
+export type Status<T> = {
+    data?: T | null;
+    status: 'success' | 'loading' | 'idle' | 'error';
+    error?: string;
+};