@vaneui/ui 1.4.0 → 1.4.1

package/dist/types/components/ui/field/fieldControls.d.mts

@@ -0,0 +1,14 @@
+import type React from 'react';
+import { ComponentKeys } from "../props/index.mjs";
+export type ControlKey = typeof ComponentKeys.control[number];
+export type FieldControlDescriptor = {
+    Component: React.ElementType;
+    layout: 'stacked' | 'inline';
+    inputType?: string;
+};
+export declare const FIELD_CONTROLS: Record<ControlKey, FieldControlDescriptor>;
+export declare function resolveControl(props: Record<string, unknown>, defaults: Record<string, unknown>): {
+    key: ControlKey;
+    descriptor: FieldControlDescriptor;
+    inputType?: string;
+} | undefined;

package/dist/types/components/ui/field/fieldControls.d.ts

@@ -0,0 +1,14 @@
+import type React from 'react';
+import { ComponentKeys } from "../props";
+export type ControlKey = typeof ComponentKeys.control[number];
+export type FieldControlDescriptor = {
+    Component: React.ElementType;
+    layout: 'stacked' | 'inline';
+    inputType?: string;
+};
+export declare const FIELD_CONTROLS: Record<ControlKey, FieldControlDescriptor>;
+export declare function resolveControl(props: Record<string, unknown>, defaults: Record<string, unknown>): {
+    key: ControlKey;
+    descriptor: FieldControlDescriptor;
+    inputType?: string;
+} | undefined;

package/dist/types/components/ui/field/fieldDefaults.d.cts

@@ -1,3 +1,3 @@
 import type { FieldProps } from "./FieldProps.cjs";
-/** Default props for Field component */
+/** Default props for Field component. No `control` default: one would force every Field to self-render. */
 export declare const fieldDefaults: Partial<FieldProps>;

package/dist/types/components/ui/field/fieldDefaults.d.mts

@@ -1,3 +1,3 @@
 import type { FieldProps } from "./FieldProps.mjs";
-/** Default props for Field component */
+/** Default props for Field component. No `control` default: one would force every Field to self-render. */
 export declare const fieldDefaults: Partial<FieldProps>;

package/dist/types/components/ui/field/fieldDefaults.d.ts

@@ -1,3 +1,3 @@
 import type { FieldProps } from "./FieldProps";
-/** Default props for Field component */
+/** Default props for Field component. No `control` default: one would force every Field to self-render. */
 export declare const fieldDefaults: Partial<FieldProps>;

package/dist/types/components/ui/field/index.d.cts

@@ -1,13 +1,15 @@
 export { Field } from './Field.cjs';
-export type { FieldProps } from './FieldProps.cjs';
+export type { FieldProps, FieldControlType } from './FieldProps.cjs';
 export { FIELD_CATEGORIES } from './FieldCategories.cjs';
 export type { FieldTheme } from './FieldTheme.cjs';
 export { fieldDefaults } from './fieldDefaults.cjs';
 export { fieldLabelDefaults } from './fieldLabelDefaults.cjs';
+export { fieldControlRowDefaults } from './fieldControlRowDefaults.cjs';
 export { fieldDescriptionDefaults } from './fieldDescriptionDefaults.cjs';
 export { fieldErrorDefaults } from './fieldErrorDefaults.cjs';
 export { defaultFieldTheme } from './defaultFieldTheme.cjs';
 export { defaultFieldLabelTheme } from './defaultFieldLabelTheme.cjs';
+export { defaultFieldControlRowTheme } from './defaultFieldControlRowTheme.cjs';
 export { defaultFieldDescriptionTheme } from './defaultFieldDescriptionTheme.cjs';
 export { defaultFieldErrorTheme } from './defaultFieldErrorTheme.cjs';
 export { FieldControlContext, useFieldControlProps, useFieldGroupProps } from './FieldContext.cjs';

package/dist/types/components/ui/field/index.d.mts

@@ -1,13 +1,15 @@
 export { Field } from './Field.mjs';
-export type { FieldProps } from './FieldProps.mjs';
+export type { FieldProps, FieldControlType } from './FieldProps.mjs';
 export { FIELD_CATEGORIES } from './FieldCategories.mjs';
 export type { FieldTheme } from './FieldTheme.mjs';
 export { fieldDefaults } from './fieldDefaults.mjs';
 export { fieldLabelDefaults } from './fieldLabelDefaults.mjs';
+export { fieldControlRowDefaults } from './fieldControlRowDefaults.mjs';
 export { fieldDescriptionDefaults } from './fieldDescriptionDefaults.mjs';
 export { fieldErrorDefaults } from './fieldErrorDefaults.mjs';
 export { defaultFieldTheme } from './defaultFieldTheme.mjs';
 export { defaultFieldLabelTheme } from './defaultFieldLabelTheme.mjs';
+export { defaultFieldControlRowTheme } from './defaultFieldControlRowTheme.mjs';
 export { defaultFieldDescriptionTheme } from './defaultFieldDescriptionTheme.mjs';
 export { defaultFieldErrorTheme } from './defaultFieldErrorTheme.mjs';
 export { FieldControlContext, useFieldControlProps, useFieldGroupProps } from './FieldContext.mjs';

package/dist/types/components/ui/field/index.d.ts

@@ -1,13 +1,15 @@
 export { Field } from './Field';
-export type { FieldProps } from './FieldProps';
+export type { FieldProps, FieldControlType } from './FieldProps';
 export { FIELD_CATEGORIES } from './FieldCategories';
 export type { FieldTheme } from './FieldTheme';
 export { fieldDefaults } from './fieldDefaults';
 export { fieldLabelDefaults } from './fieldLabelDefaults';
+export { fieldControlRowDefaults } from './fieldControlRowDefaults';
 export { fieldDescriptionDefaults } from './fieldDescriptionDefaults';
 export { fieldErrorDefaults } from './fieldErrorDefaults';
 export { defaultFieldTheme } from './defaultFieldTheme';
 export { defaultFieldLabelTheme } from './defaultFieldLabelTheme';
+export { defaultFieldControlRowTheme } from './defaultFieldControlRowTheme';
 export { defaultFieldDescriptionTheme } from './defaultFieldDescriptionTheme';
 export { defaultFieldErrorTheme } from './defaultFieldErrorTheme';
 export { FieldControlContext, useFieldControlProps, useFieldGroupProps } from './FieldContext';

package/dist/types/components/ui/props/categoryBuilders.d.cts

@@ -38,6 +38,7 @@ export declare const INHERIT_SIZE: readonly ["inheritSize"];
 export declare const INHERIT_COLOR: readonly ["inheritColor"];
 export declare const INHERIT_BG: readonly ["inheritBg"];
 export declare const INHERIT_BORDER: readonly ["inheritBorder"];
+export declare const CONTROL: readonly ["control"];
 export declare const LAYOUT_FULL: readonly ["size", "hide", "items", "justify", "position", "display", "overflow", "wrap", "gap", "flexDirection", "flex", "shrink"];
 export declare const VISUAL_FULL: readonly ["appearance", "border", "shadow", "ring", "focusVisible", "shape"];
 export declare const VISUAL_LAYOUT: readonly ["appearance", "border", "shadow", "ring", "shape"];

package/dist/types/components/ui/props/categoryBuilders.d.mts

@@ -38,6 +38,7 @@ export declare const INHERIT_SIZE: readonly ["inheritSize"];
 export declare const INHERIT_COLOR: readonly ["inheritColor"];
 export declare const INHERIT_BG: readonly ["inheritBg"];
 export declare const INHERIT_BORDER: readonly ["inheritBorder"];
+export declare const CONTROL: readonly ["control"];
 export declare const LAYOUT_FULL: readonly ["size", "hide", "items", "justify", "position", "display", "overflow", "wrap", "gap", "flexDirection", "flex", "shrink"];
 export declare const VISUAL_FULL: readonly ["appearance", "border", "shadow", "ring", "focusVisible", "shape"];
 export declare const VISUAL_LAYOUT: readonly ["appearance", "border", "shadow", "ring", "shape"];

package/dist/types/components/ui/props/categoryBuilders.d.ts

@@ -38,6 +38,7 @@ export declare const INHERIT_SIZE: readonly ["inheritSize"];
 export declare const INHERIT_COLOR: readonly ["inheritColor"];
 export declare const INHERIT_BG: readonly ["inheritBg"];
 export declare const INHERIT_BORDER: readonly ["inheritBorder"];
+export declare const CONTROL: readonly ["control"];
 export declare const LAYOUT_FULL: readonly ["size", "hide", "items", "justify", "position", "display", "overflow", "wrap", "gap", "flexDirection", "flex", "shrink"];
 export declare const VISUAL_FULL: readonly ["appearance", "border", "shadow", "ring", "focusVisible", "shape"];
 export declare const VISUAL_LAYOUT: readonly ["appearance", "border", "shadow", "ring", "shape"];

package/dist/types/components/ui/props/controlProps.d.cts

@@ -0,0 +1,15 @@
+/** Which form control a Field renders itself; omit all of them to pass the control as a child. */
+export interface ControlProps {
+    /** Render a text input (the default control kind); pair with `type` for a specific input type */
+    textInput?: boolean;
+    /** Render a multi-line textarea */
+    textarea?: boolean;
+    /** Render a select; pass the options as children */
+    select?: boolean;
+    /** Render a checkbox, laid out inline with its label */
+    checkbox?: boolean;
+    /** Render a switch, laid out inline with its label */
+    switch?: boolean;
+    /** Render a radio group; pass the radios as children */
+    radiogroup?: boolean;
+}

package/dist/types/components/ui/props/controlProps.d.mts

@@ -0,0 +1,15 @@
+/** Which form control a Field renders itself; omit all of them to pass the control as a child. */
+export interface ControlProps {
+    /** Render a text input (the default control kind); pair with `type` for a specific input type */
+    textInput?: boolean;
+    /** Render a multi-line textarea */
+    textarea?: boolean;
+    /** Render a select; pass the options as children */
+    select?: boolean;
+    /** Render a checkbox, laid out inline with its label */
+    checkbox?: boolean;
+    /** Render a switch, laid out inline with its label */
+    switch?: boolean;
+    /** Render a radio group; pass the radios as children */
+    radiogroup?: boolean;
+}

package/dist/types/components/ui/props/controlProps.d.ts

@@ -0,0 +1,15 @@
+/** Which form control a Field renders itself; omit all of them to pass the control as a child. */
+export interface ControlProps {
+    /** Render a text input (the default control kind); pair with `type` for a specific input type */
+    textInput?: boolean;
+    /** Render a multi-line textarea */
+    textarea?: boolean;
+    /** Render a select; pass the options as children */
+    select?: boolean;
+    /** Render a checkbox, laid out inline with its label */
+    checkbox?: boolean;
+    /** Render a switch, laid out inline with its label */
+    switch?: boolean;
+    /** Render a radio group; pass the radios as children */
+    radiogroup?: boolean;
+}

package/dist/types/components/ui/props/keys.d.cts

@@ -1,5 +1,5 @@
-import { LAYOUT_CORE, LAYOUT_FLEX, PADDING, MARGIN, BREAKPOINT, VISUAL_CORE, BORDER, VISUAL_DECORATION, VISUAL_DECORATION_LAYOUT, SHAPE, TEXT_ALIGN, TRUNCATE, TYPOGRAPHY_STYLE_CORE, TYPOGRAPHY_STYLE, LIST_STYLE, LIST_POSITION, VARIANT, TRANSPARENT, RESPONSIVE, WIDTH, COMMON_MODIFIERS, LAYOUT_FULL, VISUAL_FULL, VISUAL_LAYOUT, TYPOGRAPHY_FULL, PLACEMENT, DISABLED, READONLY, MIN_WIDTH, MAX_HEIGHT, INHERIT_SIZE, INHERIT_COLOR, INHERIT_BG, INHERIT_BORDER } from './categoryBuilders.cjs';
-export { LAYOUT_CORE, LAYOUT_FLEX, PADDING, MARGIN, BREAKPOINT, VISUAL_CORE, BORDER, VISUAL_DECORATION, VISUAL_DECORATION_LAYOUT, SHAPE, TEXT_ALIGN, TRUNCATE, TYPOGRAPHY_STYLE_CORE, TYPOGRAPHY_STYLE, LIST_STYLE, LIST_POSITION, VARIANT, TRANSPARENT, RESPONSIVE, WIDTH, COMMON_MODIFIERS, LAYOUT_FULL, VISUAL_FULL, VISUAL_LAYOUT, TYPOGRAPHY_FULL, PLACEMENT, DISABLED, READONLY, MIN_WIDTH, MAX_HEIGHT, INHERIT_SIZE, INHERIT_COLOR, INHERIT_BG, INHERIT_BORDER, };
+import { LAYOUT_CORE, LAYOUT_FLEX, PADDING, MARGIN, BREAKPOINT, VISUAL_CORE, BORDER, VISUAL_DECORATION, VISUAL_DECORATION_LAYOUT, SHAPE, TEXT_ALIGN, TRUNCATE, TYPOGRAPHY_STYLE_CORE, TYPOGRAPHY_STYLE, LIST_STYLE, LIST_POSITION, VARIANT, TRANSPARENT, RESPONSIVE, WIDTH, COMMON_MODIFIERS, LAYOUT_FULL, VISUAL_FULL, VISUAL_LAYOUT, TYPOGRAPHY_FULL, PLACEMENT, DISABLED, READONLY, MIN_WIDTH, MAX_HEIGHT, INHERIT_SIZE, INHERIT_COLOR, INHERIT_BG, INHERIT_BORDER, CONTROL } from './categoryBuilders.cjs';
+export { LAYOUT_CORE, LAYOUT_FLEX, PADDING, MARGIN, BREAKPOINT, VISUAL_CORE, BORDER, VISUAL_DECORATION, VISUAL_DECORATION_LAYOUT, SHAPE, TEXT_ALIGN, TRUNCATE, TYPOGRAPHY_STYLE_CORE, TYPOGRAPHY_STYLE, LIST_STYLE, LIST_POSITION, VARIANT, TRANSPARENT, RESPONSIVE, WIDTH, COMMON_MODIFIERS, LAYOUT_FULL, VISUAL_FULL, VISUAL_LAYOUT, TYPOGRAPHY_FULL, PLACEMENT, DISABLED, READONLY, MIN_WIDTH, MAX_HEIGHT, INHERIT_SIZE, INHERIT_COLOR, INHERIT_BG, INHERIT_BORDER, CONTROL, };
 import { BADGE_CATEGORIES, BUTTON_CATEGORIES, CHIP_CATEGORIES, CODE_CATEGORIES, CONTAINER_CATEGORIES, GRID_CATEGORIES, ICON_CATEGORIES, ROW_CATEGORIES, STACK_CATEGORIES } from './categoryBuilders.cjs';
 import { CARD_CATEGORIES } from '../card/CardCategories.cjs';
 import { COL_CATEGORIES } from '../col/ColCategories.cjs';
@@ -81,7 +81,7 @@ export declare const HEIGHT: readonly ["height"];
 /** Letter spacing property for text tracking */
 export declare const LETTER_SPACING: readonly ["letterSpacing"];
 /** All available component property categories combined */
-export declare const COMPONENT_PROPS_CATEGORY: readonly ["appearance", "wrap", "gap", "flexDirection", "flex", "shrink", "fontWeight", "fontStyle", "textDecoration", "textTransform", "fontFamily", "textAlign", "truncate", "listStyle", "listPosition", "size", "hide", "items", "justify", "position", "display", "overflow", "alignSelf", "justifySelf", "breakpoint", "padding", "margin", "border", "shadow", "ring", "focusVisible", "shape", "variant", "transparent", "responsiveSizing", "blur", "pointerEvents", "cursor", "transition", "whitespace", "wordBreak", "objectFit", "width", "height", "truncate", "validity", "orientation", "letterSpacing", "placement", "disabled", "readOnly", "constrainWidth", "clampHeight", "inheritSize", "inheritColor", "inheritBg", "inheritBorder"];
+export declare const COMPONENT_PROPS_CATEGORY: readonly ["appearance", "wrap", "gap", "flexDirection", "flex", "shrink", "fontWeight", "fontStyle", "textDecoration", "textTransform", "fontFamily", "textAlign", "truncate", "listStyle", "listPosition", "size", "hide", "items", "justify", "position", "display", "overflow", "alignSelf", "justifySelf", "breakpoint", "padding", "margin", "border", "shadow", "ring", "focusVisible", "shape", "variant", "transparent", "responsiveSizing", "blur", "pointerEvents", "cursor", "transition", "whitespace", "wordBreak", "objectFit", "width", "height", "truncate", "validity", "orientation", "letterSpacing", "placement", "disabled", "readOnly", "constrainWidth", "clampHeight", "inheritSize", "inheritColor", "inheritBg", "inheritBorder", "control"];
 /**
  * Describes category for which the appearance can be applied
  * @see ComponentKeys.appearance
@@ -100,6 +100,8 @@ export declare const ComponentKeys: {
     /** Breakpoint below which Row/Stack stacks into a column (desktop-first: that tier and below).
         Widest-first so combining several resolves to the widest = their union (desktopStack ⊃ tabletStack ⊃ mobileStack). */
     readonly breakpoint: readonly ["desktopStack", "tabletStack", "mobileStack"];
+    /** Which form control a Field renders itself; absent means the control is passed as a child */
+    readonly control: readonly ["textInput", "textarea", "select", "checkbox", "switch", "radiogroup"];
     /** CSS display property values for element layout behavior */
     readonly display: readonly ["inline", "block", "inlineBlock", "flex", "inlineFlex", "grid", "inlineGrid", "contents", "table", "tableCell", "hidden"];
     /** Flex direction: row (horizontal), column (vertical), or reversed variants */

package/dist/types/components/ui/props/keys.d.mts

@@ -1,5 +1,5 @@
-import { LAYOUT_CORE, LAYOUT_FLEX, PADDING, MARGIN, BREAKPOINT, VISUAL_CORE, BORDER, VISUAL_DECORATION, VISUAL_DECORATION_LAYOUT, SHAPE, TEXT_ALIGN, TRUNCATE, TYPOGRAPHY_STYLE_CORE, TYPOGRAPHY_STYLE, LIST_STYLE, LIST_POSITION, VARIANT, TRANSPARENT, RESPONSIVE, WIDTH, COMMON_MODIFIERS, LAYOUT_FULL, VISUAL_FULL, VISUAL_LAYOUT, TYPOGRAPHY_FULL, PLACEMENT, DISABLED, READONLY, MIN_WIDTH, MAX_HEIGHT, INHERIT_SIZE, INHERIT_COLOR, INHERIT_BG, INHERIT_BORDER } from './categoryBuilders.mjs';
-export { LAYOUT_CORE, LAYOUT_FLEX, PADDING, MARGIN, BREAKPOINT, VISUAL_CORE, BORDER, VISUAL_DECORATION, VISUAL_DECORATION_LAYOUT, SHAPE, TEXT_ALIGN, TRUNCATE, TYPOGRAPHY_STYLE_CORE, TYPOGRAPHY_STYLE, LIST_STYLE, LIST_POSITION, VARIANT, TRANSPARENT, RESPONSIVE, WIDTH, COMMON_MODIFIERS, LAYOUT_FULL, VISUAL_FULL, VISUAL_LAYOUT, TYPOGRAPHY_FULL, PLACEMENT, DISABLED, READONLY, MIN_WIDTH, MAX_HEIGHT, INHERIT_SIZE, INHERIT_COLOR, INHERIT_BG, INHERIT_BORDER, };
+import { LAYOUT_CORE, LAYOUT_FLEX, PADDING, MARGIN, BREAKPOINT, VISUAL_CORE, BORDER, VISUAL_DECORATION, VISUAL_DECORATION_LAYOUT, SHAPE, TEXT_ALIGN, TRUNCATE, TYPOGRAPHY_STYLE_CORE, TYPOGRAPHY_STYLE, LIST_STYLE, LIST_POSITION, VARIANT, TRANSPARENT, RESPONSIVE, WIDTH, COMMON_MODIFIERS, LAYOUT_FULL, VISUAL_FULL, VISUAL_LAYOUT, TYPOGRAPHY_FULL, PLACEMENT, DISABLED, READONLY, MIN_WIDTH, MAX_HEIGHT, INHERIT_SIZE, INHERIT_COLOR, INHERIT_BG, INHERIT_BORDER, CONTROL } from './categoryBuilders.mjs';
+export { LAYOUT_CORE, LAYOUT_FLEX, PADDING, MARGIN, BREAKPOINT, VISUAL_CORE, BORDER, VISUAL_DECORATION, VISUAL_DECORATION_LAYOUT, SHAPE, TEXT_ALIGN, TRUNCATE, TYPOGRAPHY_STYLE_CORE, TYPOGRAPHY_STYLE, LIST_STYLE, LIST_POSITION, VARIANT, TRANSPARENT, RESPONSIVE, WIDTH, COMMON_MODIFIERS, LAYOUT_FULL, VISUAL_FULL, VISUAL_LAYOUT, TYPOGRAPHY_FULL, PLACEMENT, DISABLED, READONLY, MIN_WIDTH, MAX_HEIGHT, INHERIT_SIZE, INHERIT_COLOR, INHERIT_BG, INHERIT_BORDER, CONTROL, };
 import { BADGE_CATEGORIES, BUTTON_CATEGORIES, CHIP_CATEGORIES, CODE_CATEGORIES, CONTAINER_CATEGORIES, GRID_CATEGORIES, ICON_CATEGORIES, ROW_CATEGORIES, STACK_CATEGORIES } from './categoryBuilders.mjs';
 import { CARD_CATEGORIES } from '../card/CardCategories.mjs';
 import { COL_CATEGORIES } from '../col/ColCategories.mjs';
@@ -81,7 +81,7 @@ export declare const HEIGHT: readonly ["height"];
 /** Letter spacing property for text tracking */
 export declare const LETTER_SPACING: readonly ["letterSpacing"];
 /** All available component property categories combined */
-export declare const COMPONENT_PROPS_CATEGORY: readonly ["appearance", "wrap", "gap", "flexDirection", "flex", "shrink", "fontWeight", "fontStyle", "textDecoration", "textTransform", "fontFamily", "textAlign", "truncate", "listStyle", "listPosition", "size", "hide", "items", "justify", "position", "display", "overflow", "alignSelf", "justifySelf", "breakpoint", "padding", "margin", "border", "shadow", "ring", "focusVisible", "shape", "variant", "transparent", "responsiveSizing", "blur", "pointerEvents", "cursor", "transition", "whitespace", "wordBreak", "objectFit", "width", "height", "truncate", "validity", "orientation", "letterSpacing", "placement", "disabled", "readOnly", "constrainWidth", "clampHeight", "inheritSize", "inheritColor", "inheritBg", "inheritBorder"];
+export declare const COMPONENT_PROPS_CATEGORY: readonly ["appearance", "wrap", "gap", "flexDirection", "flex", "shrink", "fontWeight", "fontStyle", "textDecoration", "textTransform", "fontFamily", "textAlign", "truncate", "listStyle", "listPosition", "size", "hide", "items", "justify", "position", "display", "overflow", "alignSelf", "justifySelf", "breakpoint", "padding", "margin", "border", "shadow", "ring", "focusVisible", "shape", "variant", "transparent", "responsiveSizing", "blur", "pointerEvents", "cursor", "transition", "whitespace", "wordBreak", "objectFit", "width", "height", "truncate", "validity", "orientation", "letterSpacing", "placement", "disabled", "readOnly", "constrainWidth", "clampHeight", "inheritSize", "inheritColor", "inheritBg", "inheritBorder", "control"];
 /**
  * Describes category for which the appearance can be applied
  * @see ComponentKeys.appearance
@@ -100,6 +100,8 @@ export declare const ComponentKeys: {
     /** Breakpoint below which Row/Stack stacks into a column (desktop-first: that tier and below).
         Widest-first so combining several resolves to the widest = their union (desktopStack ⊃ tabletStack ⊃ mobileStack). */
     readonly breakpoint: readonly ["desktopStack", "tabletStack", "mobileStack"];
+    /** Which form control a Field renders itself; absent means the control is passed as a child */
+    readonly control: readonly ["textInput", "textarea", "select", "checkbox", "switch", "radiogroup"];
     /** CSS display property values for element layout behavior */
     readonly display: readonly ["inline", "block", "inlineBlock", "flex", "inlineFlex", "grid", "inlineGrid", "contents", "table", "tableCell", "hidden"];
     /** Flex direction: row (horizontal), column (vertical), or reversed variants */

package/dist/types/components/ui/props/keys.d.ts

@@ -1,5 +1,5 @@
-import { LAYOUT_CORE, LAYOUT_FLEX, PADDING, MARGIN, BREAKPOINT, VISUAL_CORE, BORDER, VISUAL_DECORATION, VISUAL_DECORATION_LAYOUT, SHAPE, TEXT_ALIGN, TRUNCATE, TYPOGRAPHY_STYLE_CORE, TYPOGRAPHY_STYLE, LIST_STYLE, LIST_POSITION, VARIANT, TRANSPARENT, RESPONSIVE, WIDTH, COMMON_MODIFIERS, LAYOUT_FULL, VISUAL_FULL, VISUAL_LAYOUT, TYPOGRAPHY_FULL, PLACEMENT, DISABLED, READONLY, MIN_WIDTH, MAX_HEIGHT, INHERIT_SIZE, INHERIT_COLOR, INHERIT_BG, INHERIT_BORDER } from './categoryBuilders';
-export { LAYOUT_CORE, LAYOUT_FLEX, PADDING, MARGIN, BREAKPOINT, VISUAL_CORE, BORDER, VISUAL_DECORATION, VISUAL_DECORATION_LAYOUT, SHAPE, TEXT_ALIGN, TRUNCATE, TYPOGRAPHY_STYLE_CORE, TYPOGRAPHY_STYLE, LIST_STYLE, LIST_POSITION, VARIANT, TRANSPARENT, RESPONSIVE, WIDTH, COMMON_MODIFIERS, LAYOUT_FULL, VISUAL_FULL, VISUAL_LAYOUT, TYPOGRAPHY_FULL, PLACEMENT, DISABLED, READONLY, MIN_WIDTH, MAX_HEIGHT, INHERIT_SIZE, INHERIT_COLOR, INHERIT_BG, INHERIT_BORDER, };
+import { LAYOUT_CORE, LAYOUT_FLEX, PADDING, MARGIN, BREAKPOINT, VISUAL_CORE, BORDER, VISUAL_DECORATION, VISUAL_DECORATION_LAYOUT, SHAPE, TEXT_ALIGN, TRUNCATE, TYPOGRAPHY_STYLE_CORE, TYPOGRAPHY_STYLE, LIST_STYLE, LIST_POSITION, VARIANT, TRANSPARENT, RESPONSIVE, WIDTH, COMMON_MODIFIERS, LAYOUT_FULL, VISUAL_FULL, VISUAL_LAYOUT, TYPOGRAPHY_FULL, PLACEMENT, DISABLED, READONLY, MIN_WIDTH, MAX_HEIGHT, INHERIT_SIZE, INHERIT_COLOR, INHERIT_BG, INHERIT_BORDER, CONTROL } from './categoryBuilders';
+export { LAYOUT_CORE, LAYOUT_FLEX, PADDING, MARGIN, BREAKPOINT, VISUAL_CORE, BORDER, VISUAL_DECORATION, VISUAL_DECORATION_LAYOUT, SHAPE, TEXT_ALIGN, TRUNCATE, TYPOGRAPHY_STYLE_CORE, TYPOGRAPHY_STYLE, LIST_STYLE, LIST_POSITION, VARIANT, TRANSPARENT, RESPONSIVE, WIDTH, COMMON_MODIFIERS, LAYOUT_FULL, VISUAL_FULL, VISUAL_LAYOUT, TYPOGRAPHY_FULL, PLACEMENT, DISABLED, READONLY, MIN_WIDTH, MAX_HEIGHT, INHERIT_SIZE, INHERIT_COLOR, INHERIT_BG, INHERIT_BORDER, CONTROL, };
 import { BADGE_CATEGORIES, BUTTON_CATEGORIES, CHIP_CATEGORIES, CODE_CATEGORIES, CONTAINER_CATEGORIES, GRID_CATEGORIES, ICON_CATEGORIES, ROW_CATEGORIES, STACK_CATEGORIES } from './categoryBuilders';
 import { CARD_CATEGORIES } from '../card/CardCategories';
 import { COL_CATEGORIES } from '../col/ColCategories';
@@ -81,7 +81,7 @@ export declare const HEIGHT: readonly ["height"];
 /** Letter spacing property for text tracking */
 export declare const LETTER_SPACING: readonly ["letterSpacing"];
 /** All available component property categories combined */
-export declare const COMPONENT_PROPS_CATEGORY: readonly ["appearance", "wrap", "gap", "flexDirection", "flex", "shrink", "fontWeight", "fontStyle", "textDecoration", "textTransform", "fontFamily", "textAlign", "truncate", "listStyle", "listPosition", "size", "hide", "items", "justify", "position", "display", "overflow", "alignSelf", "justifySelf", "breakpoint", "padding", "margin", "border", "shadow", "ring", "focusVisible", "shape", "variant", "transparent", "responsiveSizing", "blur", "pointerEvents", "cursor", "transition", "whitespace", "wordBreak", "objectFit", "width", "height", "truncate", "validity", "orientation", "letterSpacing", "placement", "disabled", "readOnly", "constrainWidth", "clampHeight", "inheritSize", "inheritColor", "inheritBg", "inheritBorder"];
+export declare const COMPONENT_PROPS_CATEGORY: readonly ["appearance", "wrap", "gap", "flexDirection", "flex", "shrink", "fontWeight", "fontStyle", "textDecoration", "textTransform", "fontFamily", "textAlign", "truncate", "listStyle", "listPosition", "size", "hide", "items", "justify", "position", "display", "overflow", "alignSelf", "justifySelf", "breakpoint", "padding", "margin", "border", "shadow", "ring", "focusVisible", "shape", "variant", "transparent", "responsiveSizing", "blur", "pointerEvents", "cursor", "transition", "whitespace", "wordBreak", "objectFit", "width", "height", "truncate", "validity", "orientation", "letterSpacing", "placement", "disabled", "readOnly", "constrainWidth", "clampHeight", "inheritSize", "inheritColor", "inheritBg", "inheritBorder", "control"];
 /**
  * Describes category for which the appearance can be applied
  * @see ComponentKeys.appearance
@@ -100,6 +100,8 @@ export declare const ComponentKeys: {
     /** Breakpoint below which Row/Stack stacks into a column (desktop-first: that tier and below).
         Widest-first so combining several resolves to the widest = their union (desktopStack ⊃ tabletStack ⊃ mobileStack). */
     readonly breakpoint: readonly ["desktopStack", "tabletStack", "mobileStack"];
+    /** Which form control a Field renders itself; absent means the control is passed as a child */
+    readonly control: readonly ["textInput", "textarea", "select", "checkbox", "switch", "radiogroup"];
     /** CSS display property values for element layout behavior */
     readonly display: readonly ["inline", "block", "inlineBlock", "flex", "inlineFlex", "grid", "inlineGrid", "contents", "table", "tableCell", "hidden"];
     /** Flex direction: row (horizontal), column (vertical), or reversed variants */

package/dist/types/components/ui/props/props.d.cts

@@ -59,3 +59,4 @@ export * from './ReadOnlyProps.cjs';
 export * from './minWidthProps.cjs';
 export * from './maxHeightProps.cjs';
 export * from './inheritProps.cjs';
+export * from './controlProps.cjs';

package/dist/types/components/ui/props/props.d.mts

@@ -59,3 +59,4 @@ export * from './ReadOnlyProps.mjs';
 export * from './minWidthProps.mjs';
 export * from './maxHeightProps.mjs';
 export * from './inheritProps.mjs';
+export * from './controlProps.mjs';

package/dist/types/components/ui/props/props.d.ts

@@ -59,3 +59,4 @@ export * from './ReadOnlyProps';
 export * from './minWidthProps';
 export * from './maxHeightProps';
 export * from './inheritProps';
+export * from './controlProps';

package/dist/types/components/utils/componentUtils.d.cts

@@ -8,3 +8,5 @@ export declare const MULTI_VALUE_CATEGORIES: Set<string>;
  * the selection overrides all side toggles.
  */
 export declare function collectTruthyKeysByCategory<T extends ComponentCategoryKey>(props: Record<string, unknown>, defaults: Record<string, unknown>, category: T): string[];
+/** Reset key that wins when a multi-value category's truthy keys mix a `no*` reset with side toggles. */
+export declare function resetConflictKey(truthyKeys: readonly string[]): string | undefined;

package/dist/types/components/utils/componentUtils.d.mts

@@ -8,3 +8,5 @@ export declare const MULTI_VALUE_CATEGORIES: Set<string>;
  * the selection overrides all side toggles.
  */
 export declare function collectTruthyKeysByCategory<T extends ComponentCategoryKey>(props: Record<string, unknown>, defaults: Record<string, unknown>, category: T): string[];
+/** Reset key that wins when a multi-value category's truthy keys mix a `no*` reset with side toggles. */
+export declare function resetConflictKey(truthyKeys: readonly string[]): string | undefined;

package/dist/types/components/utils/componentUtils.d.ts

@@ -8,3 +8,5 @@ export declare const MULTI_VALUE_CATEGORIES: Set<string>;
  * the selection overrides all side toggles.
  */
 export declare function collectTruthyKeysByCategory<T extends ComponentCategoryKey>(props: Record<string, unknown>, defaults: Record<string, unknown>, category: T): string[];
+/** Reset key that wins when a multi-value category's truthy keys mix a `no*` reset with side toggles. */
+export declare function resetConflictKey(truthyKeys: readonly string[]): string | undefined;

package/dist/types/index.d.cts

@@ -9,7 +9,7 @@ export { Kbd, type KbdProps } from "./components/ui/kbd/index.cjs";
 export { Mark, type MarkProps } from "./components/ui/mark/index.cjs";
 export { Checkbox, type CheckboxProps } from "./components/ui/checkbox/index.cjs";
 export { Label, type LabelProps } from "./components/ui/label/index.cjs";
-export { Field, type FieldProps } from "./components/ui/field/index.cjs";
+export { Field, type FieldProps, type FieldControlType } from "./components/ui/field/index.cjs";
 export { Alert, type AlertProps } from "./components/ui/alert/index.cjs";
 export { Spinner, type SpinnerProps } from "./components/ui/spinner/index.cjs";
 export { Tooltip, type TooltipProps } from "./components/ui/tooltip/index.cjs";
@@ -46,4 +46,4 @@ export { ThemeProvider } from './components/ThemeProvider.cjs';
 export { defaultTheme } from './components/defaultTheme.cjs';
 export { useTheme, type ThemeProps, type ThemeDefaults, type ThemeExtraClasses, type ThemeProviderProps, type PartialTheme, } from './components/themeContext.cjs';
 export { themeDefaults } from './components/ui/theme/defaults.cjs';
-export type { BaseProps, SizeProps, AppearanceProps, VariantProps, ShapeProps, FontFamilyProps, FontWeightProps, FontStyleProps, TextDecorationProps, TextTransformProps, TextAlignProps, PaddingProps, GapProps, BorderProps, ShadowProps, RingProps, FocusVisibleProps, ItemsProps, JustifyProps, FlexDirectionProps, WrapProps, DisplayProps, PositionProps, OverflowProps, BreakpointProps, HideProps, ResponsiveProps, TransparentProps, BlurProps, PointerEventsProps, CursorProps, TransitionProps, WhitespaceProps, ObjectFitProps, ListStyleProps, WidthProps, TruncateProps, StatusProps, OrientationProps, HeightProps, LetterSpacingProps, PlacementProps, DisabledProps, MinWidthProps, MaxHeightProps, MarginProps, ReadOnlyProps, AlignSelfProps, JustifySelfProps, FlexProps, ShrinkProps, ListPositionProps, InheritSizeProps, InheritColorProps, InheritBgProps, InheritBorderProps, InheritProps, } from "./components/ui/props/props.cjs";
+export type { BaseProps, SizeProps, AppearanceProps, VariantProps, ShapeProps, FontFamilyProps, FontWeightProps, FontStyleProps, TextDecorationProps, TextTransformProps, TextAlignProps, PaddingProps, GapProps, BorderProps, ShadowProps, RingProps, FocusVisibleProps, ItemsProps, JustifyProps, FlexDirectionProps, WrapProps, DisplayProps, PositionProps, OverflowProps, BreakpointProps, HideProps, ResponsiveProps, TransparentProps, BlurProps, PointerEventsProps, CursorProps, TransitionProps, WhitespaceProps, ObjectFitProps, ListStyleProps, WidthProps, TruncateProps, StatusProps, OrientationProps, HeightProps, LetterSpacingProps, PlacementProps, DisabledProps, MinWidthProps, MaxHeightProps, MarginProps, ReadOnlyProps, AlignSelfProps, JustifySelfProps, FlexProps, ShrinkProps, ListPositionProps, InheritSizeProps, InheritColorProps, InheritBgProps, InheritBorderProps, InheritProps, ControlProps, } from "./components/ui/props/props.cjs";

package/dist/types/index.d.mts

@@ -9,7 +9,7 @@ export { Kbd, type KbdProps } from "./components/ui/kbd/index.mjs";
 export { Mark, type MarkProps } from "./components/ui/mark/index.mjs";
 export { Checkbox, type CheckboxProps } from "./components/ui/checkbox/index.mjs";
 export { Label, type LabelProps } from "./components/ui/label/index.mjs";
-export { Field, type FieldProps } from "./components/ui/field/index.mjs";
+export { Field, type FieldProps, type FieldControlType } from "./components/ui/field/index.mjs";
 export { Alert, type AlertProps } from "./components/ui/alert/index.mjs";
 export { Spinner, type SpinnerProps } from "./components/ui/spinner/index.mjs";
 export { Tooltip, type TooltipProps } from "./components/ui/tooltip/index.mjs";
@@ -46,4 +46,4 @@ export { ThemeProvider } from './components/ThemeProvider.mjs';
 export { defaultTheme } from './components/defaultTheme.mjs';
 export { useTheme, type ThemeProps, type ThemeDefaults, type ThemeExtraClasses, type ThemeProviderProps, type PartialTheme, } from './components/themeContext.mjs';
 export { themeDefaults } from './components/ui/theme/defaults.mjs';
-export type { BaseProps, SizeProps, AppearanceProps, VariantProps, ShapeProps, FontFamilyProps, FontWeightProps, FontStyleProps, TextDecorationProps, TextTransformProps, TextAlignProps, PaddingProps, GapProps, BorderProps, ShadowProps, RingProps, FocusVisibleProps, ItemsProps, JustifyProps, FlexDirectionProps, WrapProps, DisplayProps, PositionProps, OverflowProps, BreakpointProps, HideProps, ResponsiveProps, TransparentProps, BlurProps, PointerEventsProps, CursorProps, TransitionProps, WhitespaceProps, ObjectFitProps, ListStyleProps, WidthProps, TruncateProps, StatusProps, OrientationProps, HeightProps, LetterSpacingProps, PlacementProps, DisabledProps, MinWidthProps, MaxHeightProps, MarginProps, ReadOnlyProps, AlignSelfProps, JustifySelfProps, FlexProps, ShrinkProps, ListPositionProps, InheritSizeProps, InheritColorProps, InheritBgProps, InheritBorderProps, InheritProps, } from "./components/ui/props/props.mjs";
+export type { BaseProps, SizeProps, AppearanceProps, VariantProps, ShapeProps, FontFamilyProps, FontWeightProps, FontStyleProps, TextDecorationProps, TextTransformProps, TextAlignProps, PaddingProps, GapProps, BorderProps, ShadowProps, RingProps, FocusVisibleProps, ItemsProps, JustifyProps, FlexDirectionProps, WrapProps, DisplayProps, PositionProps, OverflowProps, BreakpointProps, HideProps, ResponsiveProps, TransparentProps, BlurProps, PointerEventsProps, CursorProps, TransitionProps, WhitespaceProps, ObjectFitProps, ListStyleProps, WidthProps, TruncateProps, StatusProps, OrientationProps, HeightProps, LetterSpacingProps, PlacementProps, DisabledProps, MinWidthProps, MaxHeightProps, MarginProps, ReadOnlyProps, AlignSelfProps, JustifySelfProps, FlexProps, ShrinkProps, ListPositionProps, InheritSizeProps, InheritColorProps, InheritBgProps, InheritBorderProps, InheritProps, ControlProps, } from "./components/ui/props/props.mjs";

package/dist/types/index.d.ts

@@ -9,7 +9,7 @@ export { Kbd, type KbdProps } from "./components/ui/kbd";
 export { Mark, type MarkProps } from "./components/ui/mark";
 export { Checkbox, type CheckboxProps } from "./components/ui/checkbox";
 export { Label, type LabelProps } from "./components/ui/label";
-export { Field, type FieldProps } from "./components/ui/field";
+export { Field, type FieldProps, type FieldControlType } from "./components/ui/field";
 export { Alert, type AlertProps } from "./components/ui/alert";
 export { Spinner, type SpinnerProps } from "./components/ui/spinner";
 export { Tooltip, type TooltipProps } from "./components/ui/tooltip";
@@ -46,4 +46,4 @@ export { ThemeProvider } from './components/ThemeProvider';
 export { defaultTheme } from './components/defaultTheme';
 export { useTheme, type ThemeProps, type ThemeDefaults, type ThemeExtraClasses, type ThemeProviderProps, type PartialTheme, } from './components/themeContext';
 export { themeDefaults } from './components/ui/theme/defaults';
-export type { BaseProps, SizeProps, AppearanceProps, VariantProps, ShapeProps, FontFamilyProps, FontWeightProps, FontStyleProps, TextDecorationProps, TextTransformProps, TextAlignProps, PaddingProps, GapProps, BorderProps, ShadowProps, RingProps, FocusVisibleProps, ItemsProps, JustifyProps, FlexDirectionProps, WrapProps, DisplayProps, PositionProps, OverflowProps, BreakpointProps, HideProps, ResponsiveProps, TransparentProps, BlurProps, PointerEventsProps, CursorProps, TransitionProps, WhitespaceProps, ObjectFitProps, ListStyleProps, WidthProps, TruncateProps, StatusProps, OrientationProps, HeightProps, LetterSpacingProps, PlacementProps, DisabledProps, MinWidthProps, MaxHeightProps, MarginProps, ReadOnlyProps, AlignSelfProps, JustifySelfProps, FlexProps, ShrinkProps, ListPositionProps, InheritSizeProps, InheritColorProps, InheritBgProps, InheritBorderProps, InheritProps, } from "./components/ui/props/props";
+export type { BaseProps, SizeProps, AppearanceProps, VariantProps, ShapeProps, FontFamilyProps, FontWeightProps, FontStyleProps, TextDecorationProps, TextTransformProps, TextAlignProps, PaddingProps, GapProps, BorderProps, ShadowProps, RingProps, FocusVisibleProps, ItemsProps, JustifyProps, FlexDirectionProps, WrapProps, DisplayProps, PositionProps, OverflowProps, BreakpointProps, HideProps, ResponsiveProps, TransparentProps, BlurProps, PointerEventsProps, CursorProps, TransitionProps, WhitespaceProps, ObjectFitProps, ListStyleProps, WidthProps, TruncateProps, StatusProps, OrientationProps, HeightProps, LetterSpacingProps, PlacementProps, DisabledProps, MinWidthProps, MaxHeightProps, MarginProps, ReadOnlyProps, AlignSelfProps, JustifySelfProps, FlexProps, ShrinkProps, ListPositionProps, InheritSizeProps, InheritColorProps, InheritBgProps, InheritBorderProps, InheritProps, ControlProps, } from "./components/ui/props/props";