haze-ui 1.33.0 → 1.34.1

package/dist/types/locales/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * `haze-ui/locales` — the LocaleProvider string packs standalone, without
+ * the component tree: every built-in pack (`enUS` — the same object as
+ * `defaultStrings` — plus `zhCN`, `jaJP`, `deDE`, `frFR`, `esES`, `itIT`,
+ * `ptBR`, `ruRU`, `koKR`, `arSA`), `defaultStrings` itself, the
+ * `createStrings(base, overrides)` pack deriver and the `HazeStrings` /
+ * `LocaleProviderProps` types. For bundle-splitting a single pack or
+ * type-checking a custom one — `LocaleProvider` and `useStrings` stay on
+ * the main `haze-ui` entry.
+ *
+ * The re-exports point at the pack modules directly, never the
+ * LocaleProvider barrel, so importing `haze-ui/locales` never pulls the
+ * React component into the chunk graph.
+ *
+ * Stable public API: this module carries the same semver commitment as
+ * the `haze-ui` component library — breaking changes land only on a
+ * major version.
+ */
+export { defaultStrings, enUS } from '../components/LocaleProvider/locale.js';
+export { zhCN } from '../components/LocaleProvider/zh-cn.js';
+export { jaJP } from '../components/LocaleProvider/ja-jp.js';
+export { deDE } from '../components/LocaleProvider/de-de.js';
+export { frFR } from '../components/LocaleProvider/fr-fr.js';
+export { esES } from '../components/LocaleProvider/es-es.js';
+export { itIT } from '../components/LocaleProvider/it-it.js';
+export { ptBR } from '../components/LocaleProvider/pt-br.js';
+export { ruRU } from '../components/LocaleProvider/ru-ru.js';
+export { koKR } from '../components/LocaleProvider/ko-kr.js';
+export { arSA } from '../components/LocaleProvider/ar-sa.js';
+export { createStrings } from '../components/LocaleProvider/strings.js';
+export type { HazeStrings } from '../components/LocaleProvider/locale.js';
+export type { LocaleProviderProps } from '../components/LocaleProvider/LocaleProvider.js';

package/dist/types/tokens/colors.d.ts

@@ -1,2 +1,17 @@
 export declare const lightTheme: import("@linaria/core").LinariaClassName;
 export declare const darkTheme: import("@linaria/core").LinariaClassName;
+/**
+ * Zero-JS system-following theme: the full light token set at top level,
+ * then the full dark token set re-declared on the same class inside a
+ * `prefers-color-scheme: dark` media block (Linaria hoists the media
+ * query and re-wraps it with this class selector, so no CSS nesting
+ * support is required). Both sets are complete replacements — the
+ * relative-color interaction formulas re-derive inside the media block
+ * because it re-declares the custom properties they read from.
+ *
+ * Use it alone on any container (`<html class={autoTheme}>`): the subtree
+ * follows the OS color scheme with no JS. Swapping to `lightTheme` /
+ * `darkTheme` (e.g. via `useDarkMode`) is a replacement, not a stack —
+ * never combine theme classes on one element.
+ */
+export declare const autoTheme: import("@linaria/core").LinariaClassName;

package/dist/types/tokens/density.d.ts

@@ -1,3 +1,3 @@
-import type { DensitySpaceTokenName } from './spacing';
+import type { DensitySpaceTokenName } from './spacing.js';
 export declare const COMPACT_OVERRIDES: Record<DensitySpaceTokenName, string>;
 export declare const compact: import("@linaria/core").LinariaClassName;

package/dist/types/tokens/index.d.ts

@@ -1,11 +1,11 @@
-export { lightTheme, darkTheme } from './colors';
-export { spacing } from './spacing';
-export { compact } from './density';
-export { motion } from './motion';
-export { motionPresets } from './motion';
-export type { MotionPreset } from './motion';
-export { typography } from './typography';
-export { PRIMITIVES, SEMANTIC_COLOR_TOKENS, createBrandTheme } from './palette';
-export type { Family, Mode, PrimitiveScales, SemanticColorToken, ScaleSeed, BrandSeedOverrides, CreateBrandThemeOptions, BrandThemeCss } from './palette';
-export { deltaE, formatOklch, oklchToHex, parseHex, parseOklch, wcagContrast } from './oklch';
-export type { Oklch } from './oklch';
+export { lightTheme, darkTheme, autoTheme } from './colors.js';
+export { spacing } from './spacing.js';
+export { compact } from './density.js';
+export { motion } from './motion.js';
+export { motionPresets } from './motion.js';
+export type { MotionPreset } from './motion.js';
+export { typography } from './typography.js';
+export { PRIMITIVES, SEMANTIC_COLOR_TOKENS, createBrandTheme } from './palette.js';
+export type { Family, Mode, PrimitiveScales, SemanticColorToken, ScaleSeed, BrandSeedOverrides, CreateBrandThemeOptions, BrandThemeCss } from './palette.js';
+export { deltaE, formatOklch, oklchToHex, parseHex, parseOklch, wcagContrast } from './oklch.js';
+export type { Oklch } from './oklch.js';

package/dist/types/tokens/palette.d.ts

@@ -9,7 +9,7 @@
  * CSS relative-color formulas so consumer overrides of a base color propagate
  * to its derived states at runtime.
  */
-import type { Oklch } from './oklch';
+import type { Oklch } from './oklch.js';
 export type Mode = 'light' | 'dark';
 export type Family = 'gray' | 'blue' | 'green' | 'amber' | 'red';
 /** Brand families available as preset themes — see BRAND_SEEDS / brands.ts. */

package/dist/types/tokens/registry.d.ts

@@ -1,6 +1,6 @@
 type TokenDef = {
     name: string;
-    category: 'color' | 'typography' | 'spacing' | 'radius' | 'shadow';
+    category: 'color' | 'typography' | 'spacing' | 'radius' | 'shadow' | 'z-index';
     label: string;
     type: 'color' | 'size' | 'font' | 'number' | 'shadow';
     light: string;

package/dist/types/tokens/z-index.d.ts

@@ -0,0 +1,33 @@
+export declare const Z_INDEX_TOKENS: readonly [{
+    readonly name: "--haze-z-local-1";
+    readonly label: "Z Local 1";
+    readonly value: "1";
+}, {
+    readonly name: "--haze-z-local-2";
+    readonly label: "Z Local 2";
+    readonly value: "2";
+}, {
+    readonly name: "--haze-z-local-3";
+    readonly label: "Z Local 3";
+    readonly value: "3";
+}, {
+    readonly name: "--haze-z-overlay";
+    readonly label: "Z Overlay";
+    readonly value: "100";
+}, {
+    readonly name: "--haze-z-overlay-fallback";
+    readonly label: "Z Overlay Fallback";
+    readonly value: "1000";
+}, {
+    readonly name: "--haze-z-toast";
+    readonly label: "Z Toast";
+    readonly value: "9999";
+}];
+export type ZIndexToken = (typeof Z_INDEX_TOKENS)[number];
+/**
+ * The z-index declarations the spacing css template emits, one per tier.
+ * Exported for the token tests — the css template interpolates this exact
+ * function and Linaria evaluates it at build time (colors.ts /
+ * spacingDeclarations precedent).
+ */
+export declare function zIndexDeclarations(): string;

package/dist/types/utils/floating.d.ts

@@ -1,5 +1,5 @@
 import type { ComponentProps, CSSProperties, Dispatch, ReactNode, RefObject, SetStateAction } from 'react';
-import type { CollisionStrategy } from './collision';
+import type { CollisionStrategy } from './collision.js';
 /** Lazy feature detection so tests can flip between native and fallback. */
 export declare function supportsNativePopover(): boolean;
 /**

package/dist/types/utils/native-form.d.ts

@@ -0,0 +1,32 @@
+type NativeBooleanFieldProps = {
+    /** Form field name; absent → nothing renders. */
+    name?: string;
+    type: 'checkbox' | 'radio';
+    /** Submitted value; omitted → the native default (`'on'`). */
+    value?: string;
+    checked: boolean;
+};
+/**
+ * Boolean bridge: a clipped, non-interactive checkbox/radio that
+ * submits `value` (default `'on'`) exactly when `checked` — the native
+ * successful-control rule, so unchecked fields stay absent from
+ * FormData without conditional unmounting.
+ */
+export declare function NativeBooleanField({ name, type, value, checked, }: NativeBooleanFieldProps): import("react").JSX.Element | null;
+type NativeHiddenFieldsProps = {
+    /** Form field name; absent → nothing renders. */
+    name?: string;
+    /** One entry per submitted value — a scalar is a one-entry array, an
+     * array field repeats the name (native repeated-field semantics).
+     * Empty entries are the caller's call: skip them at the call site
+     * when emptiness means “no value”. */
+    values: readonly (string | number)[];
+};
+/**
+ * Scalar/array bridge: one `<input type='hidden'>` per value under the
+ * same `name`. `getAll(name)` yields the entries in order — the
+ * native repeated-field contract array-valued fields (Select multiple,
+ * TagInput) are expected to speak.
+ */
+export declare function NativeHiddenFields({ name, values }: NativeHiddenFieldsProps): import("react").JSX.Element | null;
+export type { NativeBooleanFieldProps, NativeHiddenFieldsProps };

package/dist/types/utils/presence.d.ts

@@ -8,6 +8,8 @@ import type { ReactElement, Ref } from 'react';
 export declare function whenExitSettles(el: HTMLElement): Promise<void> | null;
 type PresenceChildProps = {
     'data-state'?: string;
+    hidden?: boolean;
+    inert?: boolean;
     ref?: Ref<HTMLElement>;
 };
 export type PresenceProps = {
@@ -15,8 +17,25 @@ export type PresenceProps = {
     present: boolean;
     /** Single element child; receives `data-state` and a merged ref. */
     children: ReactElement;
-    /** Called when the exit has settled and the child is about to unmount. */
+    /**
+     * Called when the exit has settled — right before the child unmounts,
+     * or (with `keepMounted`) when it goes dormant instead of unmounting.
+     */
     onExited?: () => void;
+    /**
+     * Keep the child mounted after the exit settles (Radix `forceMount` /
+     * Ark `hideMode="hidden"` semantics). The exit transition still runs
+     * to completion; afterwards the child stays in the tree with
+     * `data-state="closed"` plus the `hidden` and `inert` attributes —
+     * a display:none effect that keeps inner state and effects alive
+     * (form drafts, scroll containers, media) while excluding the subtree
+     * from the accessibility tree and tab order. Re-presenting removes
+     * the attributes and runs the enter transition again. A `keepMounted`
+     * child never unmounts, including when `present` starts false (it
+     * renders dormant from the first frame). Default `false` — behavior
+     * identical to the unmount-on-exit contract.
+     */
+    keepMounted?: boolean;
 };
-export declare function Presence({ present, children, onExited }: PresenceProps): ReactElement<PresenceChildProps, string | import("react").JSXElementConstructor<any>> | null;
+export declare function Presence({ present, children, onExited, keepMounted, }: PresenceProps): ReactElement<PresenceChildProps, string | import("react").JSXElementConstructor<any>> | null;
 export {};

package/dist/types/utils/sortable-shared.d.ts

@@ -22,6 +22,12 @@ import type { Transform } from '@dnd-kit/utilities';
  * keyboard coordinate getter — Space lifts, arrows walk one item per
  * press, Space drops, Escape cancels. */
 export declare function useSortableSensors(): import("@dnd-kit/core").SensorDescriptor<import("@dnd-kit/core").SensorOptions>[];
+/** The horizontal layout strategy, re-exported for drag surfaces that must
+ * keep their own static import graph free of `@dnd-kit` (the dist-esm
+ * contract's peer import rules) — DataTable's lazily loaded
+ * `column-reorder` kit reaches the sortable runtime only through the
+ * utils modules. A plain value re-export; nothing else leaks. */
+export { horizontalListSortingStrategy } from '@dnd-kit/sortable';
 /** Inline transform style for a sortable node; `transition` animates the
  * snap-back after a cancelled or completed drag. */
 export declare function sortableItemStyle(transform: Transform | null, transition: string | null | undefined): {

package/dist/types/utils/submenu.d.ts

@@ -22,7 +22,7 @@
  */
 import type { KeyboardEvent as ReactKeyboardEvent, RefObject } from 'react';
 import type { ControlOrValue } from 'react-use-control';
-import { type FloatingBehavior } from './floating';
+import { type FloatingBehavior } from './floating.js';
 /** Pointer rest time before a submenu opens on hover (intent, not rest). */
 export declare const SUBMENU_OPEN_DELAY_MS = 120;
 /** Grace before a hover-opened submenu closes after the pointer left it. */

package/dist/utils/direction.js

@@ -1,8 +1,9 @@
 "use client";
 import { LocaleContext as e } from "../components/LocaleProvider/LocaleContext.js";
-import { useContext as t } from "react";
+import { c as t } from "react/compiler-runtime";
+import { useContext as n } from "react";
 //#region src/lib/utils/direction.ts
-var n = /* @__PURE__ */ new Set([
+var r = /* @__PURE__ */ new Set([
 	"ar",
 	"ckb",
 	"dv",
@@ -16,19 +17,20 @@ var n = /* @__PURE__ */ new Set([
 	"ur",
 	"yi"
 ]);
-function r(e) {
+function i(e) {
 	if (!e) return;
 	let t = e.split(/[-_]/)[0].toLowerCase();
-	return n.has(t) ? "rtl" : "ltr";
+	return r.has(t) ? "rtl" : "ltr";
 }
-function i(e) {
+function a(e) {
 	let t = e?.closest("[dir]");
 	if (!t) return "ltr";
 	let n = t.getAttribute("dir")?.toLowerCase();
 	return n === "rtl" || n === "ltr" ? n : typeof getComputedStyle == "function" && getComputedStyle(t).direction === "rtl" ? "rtl" : "ltr";
 }
-function a() {
-	return t(e)?.direction ?? (typeof document > "u" ? "ltr" : i(document.documentElement));
+function o() {
+	let r = t(2), i = n(e), o;
+	return r[0] === i?.direction ? o = r[1] : (o = i?.direction ?? (typeof document > "u" ? "ltr" : a(document.documentElement)), r[0] = i?.direction, r[1] = o), o;
 }
 //#endregion
-export { i as getDirection, r as localeDirection, a as useDirection };
+export { a as getDirection, i as localeDirection, o as useDirection };