@timeax/form-palette 0.0.20 → 0.0.22

package/dist/index.d.mts

@@ -2,14 +2,14 @@ import * as React from 'react';
 import React__default, { RefObject, ComponentType } from 'react';
 import { z } from 'zod';
 import { Method, AdapterResult, AdapterKey, AdapterProps, AdapterSubmit } from './adapters.mjs';
-export { AdapterCallbacks, AdapterConfig, AdapterError, AdapterFactory, AdapterOk, Adapters, NamedAdapterConfig, NamedAdapterFactory, createAxiosAdapter, createInertiaAdapter, getAdapter, hasAdapter, localAdapter, registerAdapter, registerAxiosAdapter, registerInertiaAdapter, registerKnownAdapter } from './adapters.mjs';
+export { AdapterCallbacks, AdapterConfig, AdapterError, AdapterFactory, AdapterOk, Adapters, NamedAdapterConfig, NamedAdapterFactory, createAxiosAdapter, createInertiaAdapter, getAdapter, hasAdapter, localAdapter, registerAdapter, registerAllAdapters, registerAxiosAdapter, registerInertiaAdapter, registerKnownAdapter } from './adapters.mjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { DayPicker } from 'react-day-picker';
 import * as class_variance_authority_types from 'class-variance-authority/types';
 import { VariantProps } from 'class-variance-authority';
 import * as SwitchPrimitive from '@radix-ui/react-switch';
 import { $ZodError } from 'zod/v4/core';
-import './../../../../node_modules/@inertiajs/core/types/types.d';
+import '@inertiajs/core';
 import 'axios';
 
 /**
@@ -251,21 +251,40 @@ declare class BinderRegistry<V extends Dict = Dict> {
 /**
  * Central store for all fields registered with the core runtime.
  *
- * Responsibilities:
- * - Keep a stable list of Field instances (no duplicates).
- * - Only track fields that have at least one identifier:
- *   - name (non-empty, trimmed)
- *   - bindId
- *   - groupId
- * - Provide convenient lookup methods:
- *   - all / getAllNamed / getAllBound / getAllGrouped
- *   - getByName / getAllByName
- *   - getByGroupId / getAllByGroupId
- *   - getByBind / getAllByBind (binder semantics, prefer mounted)
+ * Goals:
+ * - Keep stable Field references (no cloning).
+ * - Prefer mounted fields for all “get” operations.
+ * - Prune stale/detached fields opportunistically.
  */
 declare class FieldRegistry {
     #private;
     private list;
+    private getEl;
+    /** Mounted = has an element and that element is currently in the DOM. */
+    private isMounted;
+    /**
+     * Detached = has an element but it is NOT currently in the DOM.
+     * Note: if ref.current is null, we treat it as “unknown” (do NOT prune).
+     */
+    private isDetached;
+    /** Mounted-first stable ordering (does not mutate input). */
+    private sortMountedFirst;
+    /** Prefer the first mounted candidate; else fall back to first candidate. */
+    private pickPreferred;
+    /**
+     * Remove detached fields.
+     *
+     * IMPORTANT: We only remove entries that have a non-null ref.current AND are
+     * not in the DOM. We do not remove “unknown” (null-ref) fields because they
+     * may be in the process of mounting.
+     */
+    private pruneDetached;
+    /**
+     * Remove detached fields that conflict with an incoming field by identifier.
+     * This prevents stale “same-name / same-bindId / same-groupId” entries from
+     * hijacking lookups.
+     */
+    private pruneDetachedConflicts;
     /**
      * Whether this field should be tracked at all.
      *
@@ -274,7 +293,12 @@ declare class FieldRegistry {
     hasIdentifier(field: Field): boolean;
     /**
      * Add a field to the registry if it has an identifier.
-     * Duplicate instances are ignored.
+     *
+     * Rules:
+     * - Opportunistically prune detached fields.
+     * - Prune detached conflicts (same name/bindId/groupId) before adding.
+     * - If the same field instance is already tracked, ignore.
+     * - If the same key already exists (rare), prefer mounted; otherwise replace.
      */
     add(field: Field): void;
     /**
@@ -286,40 +310,37 @@ declare class FieldRegistry {
      */
     clear(): void;
     /**
-     * All fields tracked by this registry.
+     * All fields tracked by this registry (mounted-first).
      */
     all(): Field[];
-    /** All fields that have a non-empty name. */
+    /** All fields that have a non-empty name (mounted-first). */
     getAllNamed(): Field[];
-    /** All fields that have a bindId. */
+    /** All fields that have a bindId (mounted-first). */
     getAllBound(): Field[];
-    /** All fields that have a groupId. */
+    /** All fields that have a groupId (mounted-first). */
     getAllGrouped(): Field[];
     /**
      * First field with a given name (exact, trimmed match).
      *
-     * Note: expects the raw name used by the field, e.g.:
-     *   "email"  or  "tags[]"
+     * Behaviour:
+     * - Prefer a field whose ref is currently in the DOM.
+     * - If none are mounted, fall back to the first matching field.
      */
     getByName(name: string): Field | undefined;
     /**
-     * All fields with a given name (exact, trimmed match).
+     * All fields with a given name (exact, trimmed match), mounted-first.
      */
     getAllByName(name: string): Field[];
-    /** First field with the given groupId. */
+    /** First field with the given groupId (prefer mounted). */
     getByGroupId(id: string): Field | undefined;
-    /** All fields with the given groupId. */
+    /** All fields with the given groupId (mounted-first). */
     getAllByGroupId(id: string): Field[];
     /**
-     * All fields that share the given bindId.
+     * All fields that share the given bindId (mounted-first).
      */
     getAllByBind(id: string): Field[];
     /**
-     * First field with the given bindId.
-     *
-     * Behaviour:
-     * - Prefer a field whose ref is currently in the DOM.
-     * - If none are mounted, fall back to the first matching field.
+     * First field with the given bindId (prefer mounted).
      */
     getByBind(id: string): Field | undefined;
     getBind(id: string): Field | undefined;
@@ -2194,6 +2215,11 @@ interface ShadcnCheckboxUiProps<TItem, TValue> {
      * Extra classes for the option label text.
      */
     labelClassName?: string;
+    /**
+     * Extra classes for the option label text in group mode only.
+     * This allows styling group item labels without affecting single mode labels.
+     */
+    optionLabelClassName?: string;
     /**
      * Extra classes for the option description text.
      */
@@ -2263,7 +2289,7 @@ type NormalizedMultiItem = {
     icon?: React.ReactNode;
     raw: MultiSelectOption;
 };
-interface ShadcnMultiSelectVariantProps extends Pick<VariantBaseProps<SelectPrimitive$1[] | undefined>, "value" | "onValue" | "error" | "disabled" | "readOnly" | "size" | "density"> {
+type MultiSelectBaseProps = Pick<VariantBaseProps<SelectPrimitive$1[] | undefined>, "value" | "onValue" | "error" | "disabled" | "readOnly" | "size" | "density"> & {
     /**
      * Options for the multi-select.
      *
@@ -2394,62 +2420,62 @@ interface ShadcnMultiSelectVariantProps extends Pick<VariantBaseProps<SelectPrim
      * Extra classes for the popover content.
      */
     contentClassName?: string;
-    /**
-     * One or more icons displayed inside the trigger, on the left.
-     *
-     * If not provided and `icon` is set, that single icon
-     * is treated as `leadingIcons[0]`.
-     */
+};
+type MultiSelectDefaultModeProps = {
+    mode?: "default";
     leadingIcons?: React.ReactNode[];
-    /**
-     * Icons displayed on the right side of the trigger,
-     * near the clear button / chevron area.
-     */
     trailingIcons?: React.ReactNode[];
-    /**
-     * Convenience single-icon prop for the left side.
-     */
     icon?: React.ReactNode;
-    /**
-     * Base gap between icons and text.
-     * Defaults to 4px-ish via `gap-1`.
-     */
     iconGap?: number;
-    /**
-     * Extra spacing to apply between leading icons and the text.
-     */
     leadingIconSpacing?: number;
-    /**
-     * Extra spacing to apply between trailing icons and the clear button.
-     */
     trailingIconSpacing?: number;
-    /**
-     * Arbitrary React node rendered before the select (e.g. a button).
-     */
     leadingControl?: React.ReactNode;
-    /**
-     * Arbitrary React node rendered after the select (e.g. a button).
-     */
     trailingControl?: React.ReactNode;
-    /**
-     * Extra classes for the leading control wrapper.
-     */
     leadingControlClassName?: string;
-    /**
-     * Extra classes for the trailing control wrapper.
-     */
     trailingControlClassName?: string;
-    /**
-     * If true and there are controls, the select trigger + controls share
-     * a single visual box (borders, radius, focus states).
-     */
     joinControls?: boolean;
-    /**
-     * When joinControls is true, whether the box styling extends over controls
-     * (true) or controls are visually separate (false).
-     */
     extendBoxToControls?: boolean;
-}
+    button?: never;
+    children?: never;
+    selectedBadge?: never;
+    selectedBadgeHiddenWhenZero?: never;
+    selectedBadgeClassName?: never;
+    selectedBadgePlacement?: never;
+};
+type MultiSelectButtonModeButton = React.ReactNode | ((ctx: {
+    open: boolean;
+    selectedItems: NormalizedMultiItem[];
+    selectedCount: number;
+}) => React.ReactNode);
+type MultiSelectButtonModeProps = {
+    mode: "button";
+    /**
+     * Used when mode="button". If provided, this is the trigger.
+     * If not provided, `children` is used.
+     */
+    button?: MultiSelectButtonModeButton;
+    children?: MultiSelectButtonModeButton;
+    /**
+     * Selected-count badge (mode="button" only)
+     */
+    selectedBadge?: boolean;
+    selectedBadgeHiddenWhenZero?: boolean;
+    selectedBadgeClassName?: string;
+    selectedBadgePlacement?: "end" | "corner";
+    leadingIcons?: never;
+    trailingIcons?: never;
+    icon?: never;
+    iconGap?: never;
+    leadingIconSpacing?: never;
+    trailingIconSpacing?: never;
+    leadingControl?: never;
+    trailingControl?: never;
+    leadingControlClassName?: never;
+    trailingControlClassName?: never;
+    joinControls?: never;
+    extendBoxToControls?: never;
+};
+type ShadcnMultiSelectVariantProps = MultiSelectBaseProps & (MultiSelectDefaultModeProps | MultiSelectButtonModeProps);
 
 type SliderValue$1 = number | undefined;
 interface ShadcnSliderVariantProps extends Pick<VariantBaseProps<SliderValue$1>, "value" | "onValue" | "error" | "disabled" | "readOnly" | "size" | "density"> {
@@ -2732,7 +2758,8 @@ type NormalizedTreeItem = {
     children: NormalizedTreeItem[];
     raw: TreeSelectOption;
 };
-interface ShadcnTreeSelectVariantProps extends Pick<VariantBaseProps<TreeValue>, "value" | "onValue" | "error" | "disabled" | "readOnly" | "size" | "density"> {
+type BadgeVariant$1 = "default" | "secondary" | "destructive" | "outline";
+type TreeSelectBaseProps = Pick<VariantBaseProps<TreeValue>, "value" | "onValue" | "error" | "disabled" | "readOnly" | "size" | "density"> & {
     options?: TreeSelectOption[];
     /**
      * If true, allows multiple selection (checkboxes).
@@ -2770,6 +2797,9 @@ interface ShadcnTreeSelectVariantProps extends Pick<VariantBaseProps<TreeValue>,
     expandAll?: boolean;
     defaultExpandedValues?: TreeKey[];
     leafOnly?: boolean;
+};
+type TreeSelectDefaultModeProps = {
+    mode?: "default";
     leadingIcons?: React.ReactNode[];
     trailingIcons?: React.ReactNode[];
     icon?: React.ReactNode;
@@ -2782,7 +2812,56 @@ interface ShadcnTreeSelectVariantProps extends Pick<VariantBaseProps<TreeValue>,
     trailingControlClassName?: string;
     joinControls?: boolean;
     extendBoxToControls?: boolean;
-}
+    button?: never;
+    children?: never;
+    selectedBadge?: never;
+    selectedBadgeHiddenWhenZero?: never;
+    selectedBadgeVariant?: never;
+    selectedBadgeClassName?: never;
+    selectedBadgePlacement?: never;
+};
+type TreeSelectButtonModeButton = React.ReactNode | ((ctx: {
+    open: boolean;
+    selectedItems: NormalizedTreeItem[];
+    selectedCount: number;
+}) => React.ReactNode);
+type TreeSelectButtonModeProps = {
+    mode: "button";
+    /**
+     * Used when mode="button". If provided, this is the trigger.
+     * If not provided, `children` is used.
+     */
+    button?: TreeSelectButtonModeButton;
+    children?: TreeSelectButtonModeButton;
+    /**
+     * Selected-count badge (mode="button" only)
+     */
+    selectedBadge?: boolean;
+    selectedBadgeHiddenWhenZero?: boolean;
+    selectedBadgeVariant?: BadgeVariant$1;
+    selectedBadgeClassName?: string;
+    selectedBadgePlacement?: "end" | "corner";
+    leadingIcons?: never;
+    trailingIcons?: never;
+    icon?: never;
+    iconGap?: never;
+    leadingIconSpacing?: never;
+    trailingIconSpacing?: never;
+    leadingControl?: never;
+    trailingControl?: never;
+    leadingControlClassName?: never;
+    trailingControlClassName?: never;
+    joinControls?: never;
+    extendBoxToControls?: never;
+};
+type ShadcnTreeSelectVariantProps = TreeSelectBaseProps & (TreeSelectDefaultModeProps | TreeSelectButtonModeProps);
+
+declare const badgeVariants: (props?: ({
+    variant?: "default" | "destructive" | "outline" | "secondary" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+declare function Badge({ className, variant, asChild, ...props }: React.ComponentProps<"span"> & VariantProps<typeof badgeVariants> & {
+    asChild?: boolean;
+}): react_jsx_runtime.JSX.Element;
 
 type FileSourceKind = "native" | "path" | "url" | "custom";
 interface FileItem {
@@ -2816,7 +2895,8 @@ type CustomFileLoader = (ctx: {
     multiple: boolean;
     current: FileItem[];
 }) => Promise<CustomFileLoaderResult> | CustomFileLoaderResult;
-interface ShadcnFileVariantProps extends Pick<VariantBaseProps<FileItem[]>, "value" | "onValue" | "error" | "disabled" | "readOnly" | "size" | "density"> {
+type BadgeVariant = React.ComponentProps<typeof Badge>["variant"];
+type FileVariantBaseProps = Pick<VariantBaseProps<FileItem[]>, "value" | "onValue" | "error" | "disabled" | "readOnly" | "size" | "density"> & {
     multiple?: boolean;
     accept?: string | string[];
     maxFiles?: number;
@@ -2848,6 +2928,10 @@ interface ShadcnFileVariantProps extends Pick<VariantBaseProps<FileItem[]>, "val
     className?: string;
     dropAreaClassName?: string;
     listClassName?: string;
+    triggerClassName?: string;
+};
+type FileDefaultModeProps = {
+    mode?: "default";
     leadingIcons?: React.ReactNode[];
     trailingIcons?: React.ReactNode[];
     icon?: React.ReactNode;
@@ -2857,7 +2941,42 @@ interface ShadcnFileVariantProps extends Pick<VariantBaseProps<FileItem[]>, "val
     trailingControlClassName?: string;
     joinControls?: boolean;
     extendBoxToControls?: boolean;
-}
+    button?: never;
+    children?: never;
+    selectedBadge?: never;
+    selectedBadgeHiddenWhenZero?: never;
+    selectedBadgeVariant?: never;
+    selectedBadgeClassName?: never;
+    selectedBadgePlacement?: never;
+};
+type FileButtonTrigger = React.ReactNode | ((ctx: {
+    open: boolean;
+    items: FileItem[];
+    selectedCount: number;
+    disabled: boolean;
+}) => React.ReactNode);
+type FileButtonModeProps = {
+    mode: "button";
+    /** Used when mode="button". If provided, this is the trigger. If not, `children` is used. */
+    button?: FileButtonTrigger;
+    children?: FileButtonTrigger;
+    /** Selected-count badge (mode="button" only) */
+    selectedBadge?: boolean;
+    selectedBadgeHiddenWhenZero?: boolean;
+    selectedBadgeVariant?: BadgeVariant;
+    selectedBadgeClassName?: string;
+    selectedBadgePlacement?: "end" | "corner";
+    leadingIcons?: never;
+    trailingIcons?: never;
+    icon?: never;
+    leadingControl?: never;
+    trailingControl?: never;
+    leadingControlClassName?: never;
+    trailingControlClassName?: never;
+    joinControls?: never;
+    extendBoxToControls?: never;
+};
+type ShadcnFileVariantProps = FileVariantBaseProps & (FileDefaultModeProps | FileButtonModeProps);
 
 type SelectPrimitive = string | number;
 type SelectOption = SelectPrimitive | {
@@ -3322,7 +3441,7 @@ type Props<V extends Dict, S extends z.ZodType | undefined, K extends AdapterKey
  *   - named inputs via `name`
  *   - bound inputs via `bindId`
  *   - grouped inputs via `groupId`
- * - Manages errors + uncaught messages
+ * - Manages errors and uncaught messages
  * - Builds values snapshots (including bucket values)
  * - Orchestrates submission via the adapter registry
  */