@cube-dev/ui-kit 0.197.0 → 0.198.0

package/dist/components/form/Form/validation.js.map

@@ -1 +1 @@
-{"version":3,"file":"validation.js","names":["validate","validateEmail","validUrl","TYPE_CHECKERS","string","v","number","boolean","method","regexp","RegExp","integer","parseInt","String","array","Array","isArray","object","date","Date","url","isUri","hex","match","email","any","TYPE_LIST","Object","keys","VALIDATORS","required","value","rule","Promise","resolve","length","reject","whitespace","trim","pattern","enum","options","includes","len","max","min","validator","type","VALIDATOR_NAMES","applyRule","form","transform","validatorName","checker","applyRules","field","validationId","rules","catch","err","Error","message","delayValidationRule","timeout","timeoutId","ReturnType","setTimeout","storedResolve","clearTimeout"],"sources":["../../../../src/components/form/Form/validation.ts"],"sourcesContent":["import { validate as validateEmail } from 'email-validator';\nimport validUrl from 'valid-url';\n\nconst TYPE_CHECKERS = {\n  string(v) {\n    return typeof v === 'string';\n  },\n  number(v) {\n    return typeof v === 'number';\n  },\n  boolean(v) {\n    return typeof v === 'boolean';\n  },\n  method(v) {\n    return typeof v === 'function';\n  },\n  regexp(v) {\n    return v instanceof RegExp;\n  },\n  integer(v) {\n    return typeof v === 'number' && v === parseInt(String(v), 10);\n  },\n  array(v) {\n    return Array.isArray(v);\n  },\n  object(v) {\n    return typeof v === 'object' && !Array.isArray(v);\n  },\n  date(v) {\n    return v instanceof Date;\n  },\n  url(v) {\n    return typeof v === 'string' && validUrl.isUri(v);\n  },\n  hex(v) {\n    return typeof v === 'string' && v.match(/^#([0-9a-f]{3}|[0-9a-f]{6})$/);\n  },\n  email(v) {\n    return validateEmail(v);\n  },\n  any(v) {\n    return true;\n  },\n};\n\nconst TYPE_LIST = Object.keys(TYPE_CHECKERS);\n\nconst VALIDATORS = {\n  async required(value, rule) {\n    if (!rule.required) return Promise.resolve();\n\n    if (Array.isArray(value)) {\n      return value.length ? Promise.resolve() : Promise.reject();\n    }\n\n    return !!value || value === 0 ? Promise.resolve() : Promise.reject();\n  },\n  async whitespace(value) {\n    if (typeof value !== 'string' || value.trim()) return Promise.resolve();\n\n    return Promise.reject();\n  },\n  async pattern(value, rule) {\n    const pattern = rule.pattern;\n\n    if (typeof value !== 'string') return Promise.resolve();\n\n    return value.match(pattern) ? Promise.resolve() : Promise.reject();\n  },\n  async enum(value, rule) {\n    const options = rule.enum || [];\n\n    if (!value && value !== 0) return Promise.resolve();\n\n    return options.includes(value) ? Promise.resolve() : Promise.reject();\n  },\n  async len(value, rule) {\n    const len = rule.len;\n\n    if (typeof value === 'number') {\n      return value === len ? Promise.resolve() : Promise.reject();\n    }\n\n    if (!value || !('length' in value)) return Promise.resolve();\n\n    return value.length === len ? Promise.resolve() : Promise.reject();\n  },\n  async max(value, rule) {\n    const max = rule.max;\n\n    if (typeof value === 'number') {\n      return value <= max ? Promise.resolve() : Promise.reject();\n    }\n\n    if (!value || (typeof value !== 'string' && !Array.isArray(value)))\n      return Promise.resolve();\n\n    return value.length <= max ? Promise.resolve() : Promise.reject();\n  },\n  async min(value, rule) {\n    const min = rule.min;\n\n    if (typeof value === 'number') {\n      return value >= min ? Promise.resolve() : Promise.reject();\n    }\n\n    if (!value || (typeof value !== 'string' && !Array.isArray(value)))\n      return Promise.resolve();\n\n    return value.length >= min ? Promise.resolve() : Promise.reject();\n  },\n  async validator(value, rule) {\n    return rule.validator(rule, value);\n  },\n  async type(value, rule) {\n    const type = rule.type;\n\n    if (!TYPE_LIST.includes(type)) return Promise.resolve();\n\n    return TYPE_CHECKERS[type](value) ? Promise.resolve() : Promise.reject();\n  },\n};\n\nconst VALIDATOR_NAMES = Object.keys(VALIDATORS);\n\nexport async function applyRule(value, rule, form) {\n  if (typeof rule === 'function') {\n    rule = rule(form);\n  }\n\n  if (typeof rule.transform === 'function') {\n    value = rule.transform(value);\n  }\n\n  for (let validatorName of VALIDATOR_NAMES) {\n    if (!(validatorName in rule)) continue;\n\n    const checker = VALIDATORS[validatorName];\n\n    await checker(value, rule);\n  }\n}\n\nexport async function applyRules(field, form, validationId = 0) {\n  const { value, rules } = field;\n\n  if (!rules || !rules.length) return;\n\n  for (let rule of rules) {\n    if (field.validationId && validationId !== field.validationId) return;\n\n    await applyRule(value, rule, form).catch((err) => {\n      if (err instanceof Error) {\n        err = err?.message || rule.message;\n      }\n\n      throw err || rule.message;\n    });\n  }\n}\n\nexport const delayValidationRule = (timeout = 500) => {\n  let timeoutId: ReturnType<typeof setTimeout>;\n  let storedResolve: () => void;\n\n  return {\n    async validator(): Promise<void> {\n      clearTimeout(timeoutId);\n\n      if (storedResolve) {\n        storedResolve();\n      }\n\n      return new Promise((resolve) => {\n        storedResolve = resolve;\n\n        timeoutId = setTimeout(() => {\n          resolve();\n        }, timeout);\n      });\n    },\n  };\n};\n"],"mappings":"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"}
+{"version":3,"file":"validation.js","names":["validate","validateEmail","validUrl","TYPE_CHECKERS","string","v","number","boolean","method","regexp","RegExp","integer","parseInt","String","array","Array","isArray","object","date","Date","url","isUri","hex","match","email","any","TYPE_LIST","Object","keys","VALIDATORS","required","value","rule","Promise","resolve","length","reject","whitespace","trim","pattern","enum","options","includes","len","max","min","validator","type","VALIDATOR_NAMES","applyRule","form","transform","validatorName","checker","applyRules","field","validationId","rules","catch","err","Error","message","delayValidationRule","timeout","timeoutId","ReturnType","setTimeout","storedResolve","clearTimeout","validateEmail"],"sources":["../../../../src/components/form/Form/validation.ts"],"sourcesContent":["import { validate as validateEmail } from 'email-validator';\nimport validUrl from 'valid-url';\n\nconst TYPE_CHECKERS = {\n  string(v) {\n    return typeof v === 'string';\n  },\n  number(v) {\n    return typeof v === 'number';\n  },\n  boolean(v) {\n    return typeof v === 'boolean';\n  },\n  method(v) {\n    return typeof v === 'function';\n  },\n  regexp(v) {\n    return v instanceof RegExp;\n  },\n  integer(v) {\n    return typeof v === 'number' && v === parseInt(String(v), 10);\n  },\n  array(v) {\n    return Array.isArray(v);\n  },\n  object(v) {\n    return typeof v === 'object' && !Array.isArray(v);\n  },\n  date(v) {\n    return v instanceof Date;\n  },\n  url(v) {\n    return typeof v === 'string' && validUrl.isUri(v);\n  },\n  hex(v) {\n    return typeof v === 'string' && v.match(/^#([0-9a-f]{3}|[0-9a-f]{6})$/);\n  },\n  email(v) {\n    return validateEmail(v);\n  },\n  any(v) {\n    return true;\n  },\n};\n\nconst TYPE_LIST = Object.keys(TYPE_CHECKERS);\n\nconst VALIDATORS = {\n  async required(value, rule) {\n    if (!rule.required) return Promise.resolve();\n\n    if (Array.isArray(value)) {\n      return value.length ? Promise.resolve() : Promise.reject();\n    }\n\n    return !!value || value === 0 ? Promise.resolve() : Promise.reject();\n  },\n  async whitespace(value) {\n    if (typeof value !== 'string' || value.trim()) return Promise.resolve();\n\n    return Promise.reject();\n  },\n  async pattern(value, rule) {\n    const pattern = rule.pattern;\n\n    if (typeof value !== 'string') return Promise.resolve();\n\n    return value.match(pattern) ? Promise.resolve() : Promise.reject();\n  },\n  async enum(value, rule) {\n    const options = rule.enum || [];\n\n    if (!value && value !== 0) return Promise.resolve();\n\n    return options.includes(value) ? Promise.resolve() : Promise.reject();\n  },\n  async len(value, rule) {\n    const len = rule.len;\n\n    if (typeof value === 'number') {\n      return value === len ? Promise.resolve() : Promise.reject();\n    }\n\n    if (!value || !('length' in value)) return Promise.resolve();\n\n    return value.length === len ? Promise.resolve() : Promise.reject();\n  },\n  async max(value, rule) {\n    const max = rule.max;\n\n    if (typeof value === 'number') {\n      return value <= max ? Promise.resolve() : Promise.reject();\n    }\n\n    if (!value || (typeof value !== 'string' && !Array.isArray(value)))\n      return Promise.resolve();\n\n    return value.length <= max ? Promise.resolve() : Promise.reject();\n  },\n  async min(value, rule) {\n    const min = rule.min;\n\n    if (typeof value === 'number') {\n      return value >= min ? Promise.resolve() : Promise.reject();\n    }\n\n    if (!value || (typeof value !== 'string' && !Array.isArray(value)))\n      return Promise.resolve();\n\n    return value.length >= min ? Promise.resolve() : Promise.reject();\n  },\n  async validator(value, rule) {\n    return rule.validator(rule, value);\n  },\n  async type(value, rule) {\n    const type = rule.type;\n\n    if (!TYPE_LIST.includes(type)) return Promise.resolve();\n\n    return TYPE_CHECKERS[type](value) ? Promise.resolve() : Promise.reject();\n  },\n};\n\nconst VALIDATOR_NAMES = Object.keys(VALIDATORS);\n\nexport async function applyRule(value, rule, form) {\n  if (typeof rule === 'function') {\n    rule = rule(form);\n  }\n\n  if (typeof rule.transform === 'function') {\n    value = rule.transform(value);\n  }\n\n  for (let validatorName of VALIDATOR_NAMES) {\n    if (!(validatorName in rule)) continue;\n\n    const checker = VALIDATORS[validatorName];\n\n    await checker(value, rule);\n  }\n}\n\nexport async function applyRules(field, form, validationId = 0) {\n  const { value, rules } = field;\n\n  if (!rules || !rules.length) return;\n\n  for (let rule of rules) {\n    if (field.validationId && validationId !== field.validationId) return;\n\n    await applyRule(value, rule, form).catch((err) => {\n      if (err instanceof Error) {\n        err = err?.message || rule.message;\n      }\n\n      throw err || rule.message;\n    });\n  }\n}\n\nexport const delayValidationRule = (timeout = 500) => {\n  let timeoutId: ReturnType<typeof setTimeout>;\n  let storedResolve: () => void;\n\n  return {\n    async validator(): Promise<void> {\n      clearTimeout(timeoutId);\n\n      if (storedResolve) {\n        storedResolve();\n      }\n\n      return new Promise((resolve) => {\n        storedResolve = resolve;\n\n        timeoutId = setTimeout(() => {\n          resolve();\n        }, timeout);\n      });\n    },\n  };\n};\n"],"mappings":"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"}

package/dist/components/form/Label.d.ts

@@ -2,10 +2,8 @@
 import { LabelPosition, NecessityIndicator, ValidationProps } from "../../shared/form.js";
 import "../../shared/index.js";
 import { BaseProps, ContainerStyleProps, Styles } from "@tenphi/tasty";
-import * as react from "react";
-
 //#region src/components/form/Label.d.ts
-interface CubeNecessityIndicatorProps {
+export interface CubeNecessityIndicatorProps {
   /**
    * `'icon'` renders the asterisk, `'label'` the `(required)` / `(optional)`
    * text. Defaults to `'icon'`, which has no optional form and so only ever
@@ -41,10 +39,10 @@ interface CubeNecessityIndicatorProps {
  * Both marks are opt-in: nothing renders unless the call site passed
  * `isRequired` or `isOptional`.
  */
-declare function NecessityIndicatorMark(props: CubeNecessityIndicatorProps): react.JSX.Element | null;
-declare const INLINE_LABEL_STYLES: Styles;
-declare const LABEL_STYLES: Styles;
-interface CubeLabelProps extends BaseProps, ContainerStyleProps, ValidationProps {
+export declare function NecessityIndicatorMark(props: CubeNecessityIndicatorProps): import("react").JSX.Element | null;
+export declare const INLINE_LABEL_STYLES: Styles;
+export declare const LABEL_STYLES: Styles;
+export interface CubeLabelProps extends BaseProps, ContainerStyleProps, ValidationProps {
   labelPosition?: LabelPosition;
   necessityIndicator?: NecessityIndicator | null;
   isRequired?: boolean;
@@ -54,7 +52,7 @@ interface CubeLabelProps extends BaseProps, ContainerStyleProps, ValidationProps
   for?: string;
   size?: 'medium' | 'small';
 }
-declare let _Label: react.ForwardRefExoticComponent<CubeLabelProps & react.RefAttributes<unknown>>;
+declare let _Label: import("react").ForwardRefExoticComponent<CubeLabelProps & import("react").RefAttributes<unknown>>;
 //#endregion
-export { CubeLabelProps, CubeNecessityIndicatorProps, INLINE_LABEL_STYLES, LABEL_STYLES, NecessityIndicatorMark, _Label };
+export { _Label as Label };
 //# sourceMappingURL=Label.d.ts.map

package/dist/components/form/Label.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.197.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.198.0 | Cube Dev Team */
 import { extractStyles } from "../../utils/styles.js";
 import { useProviderProps } from "../../provider.js";
 import { useI18n } from "../../i18n/useI18n.js";
@@ -8,7 +8,6 @@ import { CONTAINER_STYLES, filterBaseProps, tasty } from "@tenphi/tasty";
 import { forwardRef } from "react";
 import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
 import { useObjectRef } from "@react-aria/utils";
-
 //#region src/components/form/Label.tsx
 const REQUIRED_ICON = /* @__PURE__ */ jsx("svg", {
 	xmlns: "http://www.w3.org/2000/svg",
@@ -227,7 +226,7 @@ function Label(props, ref) {
 }
 let _Label = forwardRef(Label);
 _Label.displayName = "Label";
-
 //#endregion
-export { INLINE_LABEL_STYLES, LABEL_STYLES, NecessityIndicatorMark, _Label };
+export { INLINE_LABEL_STYLES, LABEL_STYLES, _Label as Label, NecessityIndicatorMark };
+
 //# sourceMappingURL=Label.js.map

package/dist/components/form/Label.js.map

@@ -1 +1 @@
-{"version":3,"file":"Label.js","names":["useObjectRef","BaseProps","CONTAINER_STYLES","ContainerStyleProps","filterBaseProps","Styles","tasty","forwardRef","useI18n","useProviderProps","LabelPosition","NecessityIndicator","ValidationProps","extractStyles","getValidationMods","REQUIRED_ICON","enableBackground","width","height","transform","NecessityLabelElement","as","qa","styles","preset","color","fontWeight","CubeNecessityIndicatorProps","necessityIndicator","isRequired","isOptional","includeNecessityIndicatorInAccessibilityName","NecessityIndicatorMark","props","$","_c","t0","t1","undefined","t","t2","requiredLabel","t3","separator","role","t4","INLINE_LABEL_STYLES","invalid","const","LABEL_STYLES","display","side","split","LabelElement","CubeLabelProps","labelPosition","htmlFor","for","size","Label","ref","children","isDisabled","isInvalid","isValid","labelFor","otherProps","domRef","mark","T0","t5","t6","t7","t8","disabled","t9","t10","_Label","displayName"],"sources":["../../../src/components/form/Label.tsx"],"sourcesContent":["import { useObjectRef } from '@react-aria/utils';\nimport {\n  BaseProps,\n  CONTAINER_STYLES,\n  ContainerStyleProps,\n  filterBaseProps,\n  Styles,\n  tasty,\n} from '@tenphi/tasty';\nimport { forwardRef } from 'react';\n\nimport { useI18n } from '../../i18n';\nimport { useProviderProps } from '../../provider';\nimport {\n  LabelPosition,\n  NecessityIndicator,\n  ValidationProps,\n} from '../../shared/index';\nimport { extractStyles } from '../../utils/styles';\n\nimport { getValidationMods } from './validation/index';\n\nconst REQUIRED_ICON = (\n  <svg\n    xmlns=\"http://www.w3.org/2000/svg\"\n    version=\"1.1\"\n    x=\"0px\"\n    y=\"0px\"\n    viewBox=\"0 0 100 125\"\n    style={{\n      // @ts-ignore\n      enableBackground: 'new 0 0 100 100',\n      width: '.8em',\n      height: '.8em',\n      transform: 'rotate(-5deg)',\n    }}\n  >\n    <switch>\n      <g>\n        <polygon\n          fill=\"currentColor\"\n          points=\"97.5,47.5 90.5,26.1 61.3,35.6 61.3,4.8 38.7,4.8 38.7,35.6 9.5,26.1 2.5,47.5 31.8,57 13.7,82 31.9,95.2     50,70.3 68.1,95.2 86.3,82 68.2,57\"\n        />\n      </g>\n    </switch>\n  </svg>\n);\n\n/**\n * The `(required)` / `(optional)` note. Deliberately quieter than the label it\n * follows: it is an aside about the field, not part of its name.\n *\n * `t4` / `#dark-03` is the same tier `FieldWrapper` already gives `description`\n * and `message`, so the note joins the established secondary text rather than\n * inventing a size of its own. The weight is dropped back to 400 — `t4` carries\n * 500, the same weight as the label — because that contrast is what makes the\n * note read as an aside at a glance.\n */\nconst NecessityLabelElement = tasty({\n  as: 'span',\n  qa: 'NecessityLabel',\n  styles: {\n    preset: 't4',\n    color: '#dark-03',\n    fontWeight: 400,\n  },\n});\n\nexport interface CubeNecessityIndicatorProps {\n  /**\n   * `'icon'` renders the asterisk, `'label'` the `(required)` / `(optional)`\n   * text. Defaults to `'icon'`, which has no optional form and so only ever\n   * marks a required field. `null` suppresses the indicator entirely.\n   */\n  necessityIndicator?: NecessityIndicator | null;\n  /**\n   * Marks the label as required. Only an `isRequired` authored on the input,\n   * the label or the `Form` reaches this — a `required` validation rule drives\n   * validation and `aria-required` without decorating the label.\n   */\n  isRequired?: boolean;\n  /**\n   * Marks the label as optional. Purely presentational, and ignored when the\n   * field is required.\n   */\n  isOptional?: boolean;\n  /**\n   * Whether the indicator contributes to the field's accessible name. Off by\n   * default because a required field already announces `aria-required`, and\n   * repeating it in the name is noise.\n   */\n  includeNecessityIndicatorInAccessibilityName?: boolean;\n}\n\n/**\n * The `*` or `(required)` / `(optional)` marker that follows a field label.\n *\n * Its own component because two places render it and both need the same\n * strings: `Label` when it is given plain text, and `FieldWrapper`, which\n * builds a element tree around the label and therefore has to place the marker\n * beside the label text itself rather than after the whole tree.\n *\n * Both marks are opt-in: nothing renders unless the call site passed\n * `isRequired` or `isOptional`.\n */\nexport function NecessityIndicatorMark(props: CubeNecessityIndicatorProps) {\n  const {\n    isRequired,\n    isOptional,\n    necessityIndicator = 'icon',\n    includeNecessityIndicatorInAccessibilityName = false,\n  } = props;\n  const { t } = useI18n();\n\n  const requiredLabel = t('form.required', '(required)');\n\n  // A plain space would collapse against the label text in a flex container,\n  // and the zero-width space keeps the pair from being split across lines.\n  const separator = ' ​';\n\n  // Anything that is not one of the two shapes means \"no indicator\" — `null`,\n  // and also any stray falsy value a caller might still be passing.\n  if (necessityIndicator !== 'icon' && necessityIndicator !== 'label') {\n    return null;\n  }\n\n  if (isRequired) {\n    if (necessityIndicator === 'icon') {\n      return (\n        <>\n          {separator}\n          {/*\n            An image named \"(required)\" when it belongs in the name, hidden\n            otherwise — never a bare `<svg>`, which a screen reader announces\n            as an unnamed graphic.\n          */}\n          <span\n            {...(includeNecessityIndicatorInAccessibilityName\n              ? { role: 'img', 'aria-label': requiredLabel }\n              : { 'aria-hidden': true })}\n          >\n            {REQUIRED_ICON}\n          </span>\n        </>\n      );\n    }\n\n    // Hidden from screen readers by default, because `aria-required` on the\n    // input already announces it and repeating it in the name is noise.\n    return (\n      <>\n        {separator}\n        <NecessityLabelElement\n          aria-hidden={\n            !includeNecessityIndicatorInAccessibilityName ? true : undefined\n          }\n        >\n          {requiredLabel}\n        </NecessityLabelElement>\n      </>\n    );\n  }\n\n  // There is no icon form of \"optional\", so the note is rendered whichever\n  // indicator was asked for. Nothing else tells a screen reader the field is\n  // optional, so this one stays in the accessible name.\n  if (!isOptional) return null;\n\n  return (\n    <>\n      {separator}\n      <NecessityLabelElement>\n        {t('form.optional', '(optional)')}\n      </NecessityLabelElement>\n    </>\n  );\n}\n\nexport const INLINE_LABEL_STYLES: Styles = {\n  preset: 't3',\n  color: {\n    '': '#dark-02',\n    invalid: '#danger-text',\n  },\n} as const;\n\nexport const LABEL_STYLES: Styles = {\n  display: 'block',\n  preset: {\n    '': 't3m',\n    'size=small': 't4',\n  },\n  color: {\n    '': '#dark',\n    invalid: '#danger-text',\n  },\n  width: {\n    '': 'initial',\n    side: '($label-width, initial)',\n    split: 'initial',\n  },\n};\n\nconst LabelElement = tasty({\n  as: 'label',\n  qa: 'Label',\n  styles: LABEL_STYLES,\n});\n\nexport interface CubeLabelProps\n  extends BaseProps,\n    ContainerStyleProps,\n    ValidationProps {\n  labelPosition?: LabelPosition;\n  necessityIndicator?: NecessityIndicator | null;\n  isRequired?: boolean;\n  isOptional?: boolean;\n  includeNecessityIndicatorInAccessibilityName?: boolean;\n  htmlFor?: string;\n  for?: string;\n  size?: 'medium' | 'small';\n}\n\nfunction Label(props: CubeLabelProps, ref) {\n  props = useProviderProps<CubeLabelProps>(props);\n\n  const { t } = useI18n();\n\n  let {\n    as,\n    qa,\n    children,\n    labelPosition = 'top',\n    isRequired,\n    isOptional,\n    necessityIndicator,\n    includeNecessityIndicatorInAccessibilityName = false,\n    htmlFor,\n    isDisabled,\n    isInvalid,\n    isValid,\n    size = 'medium',\n    for: labelFor,\n    ...otherProps\n  } = props;\n\n  let domRef = useObjectRef(ref);\n\n  const styles = extractStyles(otherProps, CONTAINER_STYLES);\n\n  const mark = (\n    <NecessityIndicatorMark\n      isRequired={isRequired}\n      isOptional={isOptional}\n      necessityIndicator={necessityIndicator}\n      includeNecessityIndicatorInAccessibilityName={\n        includeNecessityIndicatorInAccessibilityName\n      }\n    />\n  );\n\n  return (\n    <LabelElement\n      {...filterBaseProps(otherProps)}\n      ref={domRef}\n      styles={styles}\n      htmlFor={labelFor || htmlFor}\n      data-size={size}\n      mods={{\n        side: labelPosition === 'side',\n        disabled: isDisabled,\n        ...getValidationMods({ isInvalid, isValid }),\n      }}\n    >\n      {/*\n        A non-string child is a tree the caller laid out \\u2014 `FieldWrapper`'s\n        full-width `Flex`, for one \\u2014 and appending the marker after it would put\n        it at the far end of that layout rather than next to the label text. So\n        the marker is only appended here for plain-text labels; callers that\n        build their own tree place `NecessityIndicatorMark` where it belongs.\n      */}\n      {typeof children !== 'string' ? (\n        children\n      ) : (\n        <>\n          {children}\n          {mark}\n        </>\n      )}\n    </LabelElement>\n  );\n}\n\nlet _Label = forwardRef(Label);\n\n_Label.displayName = 'Label';\n\nexport { _Label as Label };\n"],"mappings":"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"}
+{"version":3,"file":"Label.js","names":["useObjectRef","BaseProps","CONTAINER_STYLES","ContainerStyleProps","filterBaseProps","Styles","tasty","forwardRef","useI18n","useProviderProps","LabelPosition","NecessityIndicator","ValidationProps","extractStyles","getValidationMods","REQUIRED_ICON","enableBackground","width","height","transform","NecessityLabelElement","as","qa","styles","preset","color","fontWeight","CubeNecessityIndicatorProps","necessityIndicator","isRequired","isOptional","includeNecessityIndicatorInAccessibilityName","NecessityIndicatorMark","props","$","_c","t0","t1","undefined","t","t2","requiredLabel","t3","separator","role","t4","INLINE_LABEL_STYLES","invalid","const","LABEL_STYLES","display","side","split","LabelElement","CubeLabelProps","labelPosition","htmlFor","for","size","Label","ref","children","isDisabled","isInvalid","isValid","labelFor","otherProps","domRef","mark","T0","t5","t6","t7","t8","disabled","t9","t10","_Label","displayName","_c"],"sources":["../../../src/components/form/Label.tsx"],"sourcesContent":["import { useObjectRef } from '@react-aria/utils';\nimport {\n  BaseProps,\n  CONTAINER_STYLES,\n  ContainerStyleProps,\n  filterBaseProps,\n  Styles,\n  tasty,\n} from '@tenphi/tasty';\nimport { forwardRef } from 'react';\n\nimport { useI18n } from '../../i18n';\nimport { useProviderProps } from '../../provider';\nimport {\n  LabelPosition,\n  NecessityIndicator,\n  ValidationProps,\n} from '../../shared/index';\nimport { extractStyles } from '../../utils/styles';\n\nimport { getValidationMods } from './validation/index';\n\nconst REQUIRED_ICON = (\n  <svg\n    xmlns=\"http://www.w3.org/2000/svg\"\n    version=\"1.1\"\n    x=\"0px\"\n    y=\"0px\"\n    viewBox=\"0 0 100 125\"\n    style={{\n      // @ts-ignore\n      enableBackground: 'new 0 0 100 100',\n      width: '.8em',\n      height: '.8em',\n      transform: 'rotate(-5deg)',\n    }}\n  >\n    <switch>\n      <g>\n        <polygon\n          fill=\"currentColor\"\n          points=\"97.5,47.5 90.5,26.1 61.3,35.6 61.3,4.8 38.7,4.8 38.7,35.6 9.5,26.1 2.5,47.5 31.8,57 13.7,82 31.9,95.2     50,70.3 68.1,95.2 86.3,82 68.2,57\"\n        />\n      </g>\n    </switch>\n  </svg>\n);\n\n/**\n * The `(required)` / `(optional)` note. Deliberately quieter than the label it\n * follows: it is an aside about the field, not part of its name.\n *\n * `t4` / `#dark-03` is the same tier `FieldWrapper` already gives `description`\n * and `message`, so the note joins the established secondary text rather than\n * inventing a size of its own. The weight is dropped back to 400 — `t4` carries\n * 500, the same weight as the label — because that contrast is what makes the\n * note read as an aside at a glance.\n */\nconst NecessityLabelElement = tasty({\n  as: 'span',\n  qa: 'NecessityLabel',\n  styles: {\n    preset: 't4',\n    color: '#dark-03',\n    fontWeight: 400,\n  },\n});\n\nexport interface CubeNecessityIndicatorProps {\n  /**\n   * `'icon'` renders the asterisk, `'label'` the `(required)` / `(optional)`\n   * text. Defaults to `'icon'`, which has no optional form and so only ever\n   * marks a required field. `null` suppresses the indicator entirely.\n   */\n  necessityIndicator?: NecessityIndicator | null;\n  /**\n   * Marks the label as required. Only an `isRequired` authored on the input,\n   * the label or the `Form` reaches this — a `required` validation rule drives\n   * validation and `aria-required` without decorating the label.\n   */\n  isRequired?: boolean;\n  /**\n   * Marks the label as optional. Purely presentational, and ignored when the\n   * field is required.\n   */\n  isOptional?: boolean;\n  /**\n   * Whether the indicator contributes to the field's accessible name. Off by\n   * default because a required field already announces `aria-required`, and\n   * repeating it in the name is noise.\n   */\n  includeNecessityIndicatorInAccessibilityName?: boolean;\n}\n\n/**\n * The `*` or `(required)` / `(optional)` marker that follows a field label.\n *\n * Its own component because two places render it and both need the same\n * strings: `Label` when it is given plain text, and `FieldWrapper`, which\n * builds a element tree around the label and therefore has to place the marker\n * beside the label text itself rather than after the whole tree.\n *\n * Both marks are opt-in: nothing renders unless the call site passed\n * `isRequired` or `isOptional`.\n */\nexport function NecessityIndicatorMark(props: CubeNecessityIndicatorProps) {\n  const {\n    isRequired,\n    isOptional,\n    necessityIndicator = 'icon',\n    includeNecessityIndicatorInAccessibilityName = false,\n  } = props;\n  const { t } = useI18n();\n\n  const requiredLabel = t('form.required', '(required)');\n\n  // A plain space would collapse against the label text in a flex container,\n  // and the zero-width space keeps the pair from being split across lines.\n  const separator = ' ​';\n\n  // Anything that is not one of the two shapes means \"no indicator\" — `null`,\n  // and also any stray falsy value a caller might still be passing.\n  if (necessityIndicator !== 'icon' && necessityIndicator !== 'label') {\n    return null;\n  }\n\n  if (isRequired) {\n    if (necessityIndicator === 'icon') {\n      return (\n        <>\n          {separator}\n          {/*\n            An image named \"(required)\" when it belongs in the name, hidden\n            otherwise — never a bare `<svg>`, which a screen reader announces\n            as an unnamed graphic.\n          */}\n          <span\n            {...(includeNecessityIndicatorInAccessibilityName\n              ? { role: 'img', 'aria-label': requiredLabel }\n              : { 'aria-hidden': true })}\n          >\n            {REQUIRED_ICON}\n          </span>\n        </>\n      );\n    }\n\n    // Hidden from screen readers by default, because `aria-required` on the\n    // input already announces it and repeating it in the name is noise.\n    return (\n      <>\n        {separator}\n        <NecessityLabelElement\n          aria-hidden={\n            !includeNecessityIndicatorInAccessibilityName ? true : undefined\n          }\n        >\n          {requiredLabel}\n        </NecessityLabelElement>\n      </>\n    );\n  }\n\n  // There is no icon form of \"optional\", so the note is rendered whichever\n  // indicator was asked for. Nothing else tells a screen reader the field is\n  // optional, so this one stays in the accessible name.\n  if (!isOptional) return null;\n\n  return (\n    <>\n      {separator}\n      <NecessityLabelElement>\n        {t('form.optional', '(optional)')}\n      </NecessityLabelElement>\n    </>\n  );\n}\n\nexport const INLINE_LABEL_STYLES: Styles = {\n  preset: 't3',\n  color: {\n    '': '#dark-02',\n    invalid: '#danger-text',\n  },\n} as const;\n\nexport const LABEL_STYLES: Styles = {\n  display: 'block',\n  preset: {\n    '': 't3m',\n    'size=small': 't4',\n  },\n  color: {\n    '': '#dark',\n    invalid: '#danger-text',\n  },\n  width: {\n    '': 'initial',\n    side: '($label-width, initial)',\n    split: 'initial',\n  },\n};\n\nconst LabelElement = tasty({\n  as: 'label',\n  qa: 'Label',\n  styles: LABEL_STYLES,\n});\n\nexport interface CubeLabelProps\n  extends BaseProps, ContainerStyleProps, ValidationProps {\n  labelPosition?: LabelPosition;\n  necessityIndicator?: NecessityIndicator | null;\n  isRequired?: boolean;\n  isOptional?: boolean;\n  includeNecessityIndicatorInAccessibilityName?: boolean;\n  htmlFor?: string;\n  for?: string;\n  size?: 'medium' | 'small';\n}\n\nfunction Label(props: CubeLabelProps, ref) {\n  props = useProviderProps<CubeLabelProps>(props);\n\n  const { t } = useI18n();\n\n  let {\n    as,\n    qa,\n    children,\n    labelPosition = 'top',\n    isRequired,\n    isOptional,\n    necessityIndicator,\n    includeNecessityIndicatorInAccessibilityName = false,\n    htmlFor,\n    isDisabled,\n    isInvalid,\n    isValid,\n    size = 'medium',\n    for: labelFor,\n    ...otherProps\n  } = props;\n\n  let domRef = useObjectRef(ref);\n\n  const styles = extractStyles(otherProps, CONTAINER_STYLES);\n\n  const mark = (\n    <NecessityIndicatorMark\n      isRequired={isRequired}\n      isOptional={isOptional}\n      necessityIndicator={necessityIndicator}\n      includeNecessityIndicatorInAccessibilityName={\n        includeNecessityIndicatorInAccessibilityName\n      }\n    />\n  );\n\n  return (\n    <LabelElement\n      {...filterBaseProps(otherProps)}\n      ref={domRef}\n      styles={styles}\n      htmlFor={labelFor || htmlFor}\n      data-size={size}\n      mods={{\n        side: labelPosition === 'side',\n        disabled: isDisabled,\n        ...getValidationMods({ isInvalid, isValid }),\n      }}\n    >\n      {/*\n        A non-string child is a tree the caller laid out \\u2014 `FieldWrapper`'s\n        full-width `Flex`, for one \\u2014 and appending the marker after it would put\n        it at the far end of that layout rather than next to the label text. So\n        the marker is only appended here for plain-text labels; callers that\n        build their own tree place `NecessityIndicatorMark` where it belongs.\n      */}\n      {typeof children !== 'string' ? (\n        children\n      ) : (\n        <>\n          {children}\n          {mark}\n        </>\n      )}\n    </LabelElement>\n  );\n}\n\nlet _Label = forwardRef(Label);\n\n_Label.displayName = 'Label';\n\nexport { _Label as Label };\n"],"mappings":"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"}

package/dist/components/form/field-chrome.js

@@ -1,15 +1,55 @@
-/** @license MIT | @cube-dev/ui-kit v0.197.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.198.0 | Cube Dev Team */
 import { warn } from "../../utils/warnings.js";
-
 //#region src/components/form/field-chrome.ts
+/** Empty slot values suppress content; numeric zero is still text. */
+function hasFieldContent(content) {
+	return content != null && typeof content !== "boolean" && content !== "";
+}
+/**
+* The caller's props that give a field without a `label` something to show
+* under its control or something for the wrapper to do: texts for its slots,
+* styles for the wrapper, or hiding it.
+*/
+const FIELD_CHROME_PROPS = [
+	"description",
+	"errorMessage",
+	"message",
+	"fieldStyles",
+	"fieldProps",
+	"isHidden"
+];
+/**
+* Whether the caller of a field without a `label` passes one of
+* `FIELD_CHROME_PROPS`, so the field still needs its chrome. A form binding
+* needs it too; `useFieldProps` adds that. An explicit `isBare` overrides both
+* in `rendersFieldChrome`.
+*
+* It does not depend on what the field shows at the moment. A prop counts
+* whatever it holds — `undefined`, `null` and `''` too — because a decision
+* taken from the text would move the control in and out of the wrapper as an
+* error comes and goes, and React would remount it and drop its focus
+* mid-keystroke.
+*
+* Read the caller's own props: a form binding adds message props of its own.
+*/
+function asksForFieldChrome(props) {
+	return FIELD_CHROME_PROPS.some((key) => key in props);
+}
+/** Asks `wrapWithField` for the field chrome, unless the caller set `isBare`. */
+function withFieldChrome(props) {
+	return {
+		...props,
+		isBare: props.isBare ?? false
+	};
+}
 let hasWarnedAboutForceField = false;
-/** Warn once about the obsolete opt-in: field chrome is now the default. */
+/** Warn once about the obsolete opt-in: `isBare={false}` replaces it. */
 function warnAboutForceField(props) {
 	if (hasWarnedAboutForceField || props.forceField == null) return;
 	hasWarnedAboutForceField = true;
-	warn("A field received `forceField`, which is deprecated. Fields render chrome by default. Remove `forceField`, or pass `isBare` to render only the control.");
+	warn("A field received `forceField`, which is deprecated. Pass `isBare={false}` to render the field chrome even with nothing to show.");
 }
-
 //#endregion
-export { warnAboutForceField };
+export { asksForFieldChrome, hasFieldContent, warnAboutForceField, withFieldChrome };
+
 //# sourceMappingURL=field-chrome.js.map

package/dist/components/form/field-chrome.js.map

@@ -1 +1 @@
-{"version":3,"file":"field-chrome.js","names":["warn","hasWarnedAboutForceField","warnAboutForceField","props","forceField"],"sources":["../../../src/components/form/field-chrome.ts"],"sourcesContent":["import { warn } from '../../utils/warnings';\n\nlet hasWarnedAboutForceField = false;\n\n/** Warn once about the obsolete opt-in: field chrome is now the default. */\nexport function warnAboutForceField(props: { forceField?: boolean }) {\n  if (hasWarnedAboutForceField || props.forceField == null) return;\n\n  hasWarnedAboutForceField = true;\n\n  warn(\n    'A field received `forceField`, which is deprecated. Fields render chrome by default. Remove `forceField`, or pass `isBare` to render only the control.',\n  );\n}\n"],"mappings":";;;;AAEA,IAAIC,2BAA2B;;AAG/B,SAAgBC,oBAAoBC,OAAiC;AACnE,KAAIF,4BAA4BE,MAAMC,cAAc,KAAM;AAE1DH,4BAA2B;AAE3BD,MACE,yJACD"}
+{"version":3,"file":"field-chrome.js","names":["warn","ReactNode","hasFieldContent","content","FIELD_CHROME_PROPS","const","asksForFieldChrome","props","some","key","withFieldChrome","P","isBare","hasWarnedAboutForceField","warnAboutForceField","forceField"],"sources":["../../../src/components/form/field-chrome.ts"],"sourcesContent":["import { warn } from '../../utils/warnings';\n\nimport type { ReactNode } from 'react';\n\n/** Empty slot values suppress content; numeric zero is still text. */\nexport function hasFieldContent(content: ReactNode) {\n  return content != null && typeof content !== 'boolean' && content !== '';\n}\n\n/**\n * The caller's props that give a field without a `label` something to show\n * under its control or something for the wrapper to do: texts for its slots,\n * styles for the wrapper, or hiding it.\n */\nconst FIELD_CHROME_PROPS = [\n  'description',\n  'errorMessage',\n  'message',\n  'fieldStyles',\n  'fieldProps',\n  'isHidden',\n] as const;\n\n/**\n * Whether the caller of a field without a `label` passes one of\n * `FIELD_CHROME_PROPS`, so the field still needs its chrome. A form binding\n * needs it too; `useFieldProps` adds that. An explicit `isBare` overrides both\n * in `rendersFieldChrome`.\n *\n * It does not depend on what the field shows at the moment. A prop counts\n * whatever it holds — `undefined`, `null` and `''` too — because a decision\n * taken from the text would move the control in and out of the wrapper as an\n * error comes and goes, and React would remount it and drop its focus\n * mid-keystroke.\n *\n * Read the caller's own props: a form binding adds message props of its own.\n */\nexport function asksForFieldChrome(props: object) {\n  return FIELD_CHROME_PROPS.some((key) => key in props);\n}\n\n/** Asks `wrapWithField` for the field chrome, unless the caller set `isBare`. */\nexport function withFieldChrome<P extends object>(props: P): P {\n  return { ...props, isBare: (props as { isBare?: boolean }).isBare ?? false };\n}\n\nlet hasWarnedAboutForceField = false;\n\n/** Warn once about the obsolete opt-in: `isBare={false}` replaces it. */\nexport function warnAboutForceField(props: { forceField?: boolean }) {\n  if (hasWarnedAboutForceField || props.forceField == null) return;\n\n  hasWarnedAboutForceField = true;\n\n  warn(\n    'A field received `forceField`, which is deprecated. Pass `isBare={false}` to render the field chrome even with nothing to show.',\n  );\n}\n"],"mappings":";;;;AAKA,SAAgBE,gBAAgBC,SAAoB;CAClD,OAAOA,WAAW,QAAQ,OAAOA,YAAY,aAAaA,YAAY;AACxE;;;;;;AAOA,MAAMC,qBAAqB;CACzB;CACA;CACA;CACA;CACA;CACA;AAAU;;;;;;;;;;;;;;;AAiBZ,SAAgBE,mBAAmBC,OAAe;CAChD,OAAOH,mBAAmBI,MAAMC,QAAQA,OAAOF,KAAK;AACtD;;AAGA,SAAgBG,gBAAkCH,OAAa;CAC7D,OAAO;EAAE,GAAGA;EAAOK,QAASL,MAA+BK,UAAU;CAAM;AAC7E;AAEA,IAAIC,2BAA2B;;AAG/B,SAAgBC,oBAAoBP,OAAiC;CACnE,IAAIM,4BAA4BN,MAAMQ,cAAc,MAAM;CAE1DF,2BAA2B;CAE3Bb,KACE,iIACF;AACF"}

package/dist/components/form/index.d.ts

@@ -10,9 +10,9 @@ import { FieldTypes, Fields } from "./Form/types.js";
 import { CubeFormInstance, useForm } from "./Form/use-form.js";
 import { ModernFormProps } from "./Form/ModernFormRoot.js";
 import { CubeFormProps, FormContext, FormScopeMask, useFormProps } from "./Form/Form.js";
-import { CubeSubmitButtonProps, _SubmitButton } from "./Form/SubmitButton/SubmitButton.js";
-import { CubeResetButtonProps, _ResetButton } from "./Form/ResetButton/ResetButton.js";
-import { CubeSubmitErrorProps, _SubmitError } from "./Form/SubmitError.js";
+import { CubeSubmitButtonProps, SubmitButton as _SubmitButton } from "./Form/SubmitButton/SubmitButton.js";
+import { CubeResetButtonProps, ResetButton as _ResetButton } from "./Form/ResetButton/ResetButton.js";
+import { CubeSubmitErrorProps, SubmitError as _SubmitError } from "./Form/SubmitError.js";
 import { Field } from "./Form/Field.js";
 import { FormSelectorOptions, FormSubscribeProps } from "./Form/modern/react.js";
 import { FieldReturnValue, UseFieldProps } from "./Form/use-field/types.js";
@@ -20,11 +20,12 @@ import { UseFieldParams, useField } from "./Form/use-field/use-field.js";
 import { UseFieldPropsParams, useFieldProps } from "./Form/use-field/use-field-props.js";
 import { Form } from "./Form/index.js";
 import { rendersFieldChrome, wrapWithField } from "./wrapper.js";
-import { CubeLabelProps, CubeNecessityIndicatorProps, INLINE_LABEL_STYLES, LABEL_STYLES, NecessityIndicatorMark, _Label } from "./Label.js";
+import { CubeLabelProps, CubeNecessityIndicatorProps, INLINE_LABEL_STYLES, LABEL_STYLES, Label as _Label, NecessityIndicatorMark } from "./Label.js";
 import { FieldWrapper } from "./FieldWrapper/FieldWrapper.js";
 import { CubeFieldWrapperProps } from "./FieldWrapper/types.js";
 import "./FieldWrapper/index.js";
 import { ResolvableValidationProps, ResolvedValidationProps, getValidationMods, getValidationTheme, hasValidationState, resolveValidationProps } from "./validation/resolve-validation-props.js";
 import { useValidationProps } from "./validation/use-validation-props.js";
 import { ValidationIndicator, ValidationIndicatorProps, getValidationIcon, hasValidationIndicator } from "./validation/ValidationIndicator.js";
-import "./validation/index.js";
+import "./validation/index.js";
+export { CubeFieldWrapperProps, type CubeFormInstance, type CubeFormProps, CubeLabelProps, CubeNecessityIndicatorProps, CubeResetButtonProps, CubeSubmitButtonProps, CubeSubmitErrorProps, Field, FieldReturnValue, type FieldTypes, FieldWrapper, type Fields, Form, type FormChange, FormContext, type FormController, type FormField, type FormFieldContext, type FormFieldOptions, type FormPath, type FormReadValue, FormScopeMask, type FormSelectorOptions, type FormSubscribeProps, type FormValueAtPath, type FormValues, INLINE_LABEL_STYLES, LABEL_STYLES, _Label as Label, type ModernFieldState, type ModernFieldValidationResult, type ModernFormProps, type ModernFormState, type ModernSubmitContext, type ModernSubmitFailure, type ModernSubmitResult, type ModernValidationContext, type ModernValidationResult, type ModernValidationRule, NecessityIndicatorMark, _ResetButton as ResetButton, ResolvableValidationProps, ResolvedValidationProps, type SetValueOptions, _SubmitButton as SubmitButton, _SubmitError as SubmitError, UseFieldParams, UseFieldProps, UseFieldPropsParams, type UseFormControllerOptions, ValidationIndicator, ValidationIndicatorProps, getValidationIcon, getValidationMods, getValidationTheme, hasValidationIndicator, hasValidationState, rendersFieldChrome, resolveValidationProps, useField, useFieldProps, useForm, useFormProps, useValidationProps, wrapWithField };

package/dist/components/form/legacy-tooltip.js

@@ -1,6 +1,5 @@
-/** @license MIT | @cube-dev/ui-kit v0.197.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.198.0 | Cube Dev Team */
 import { warn } from "../../utils/warnings.js";
-
 //#region src/components/form/legacy-tooltip.ts
 let hasWarnedAboutLegacyTooltip = false;
 /**
@@ -22,7 +21,7 @@ function warnAboutLegacyTooltip(props) {
 	hasWarnedAboutLegacyTooltip = true;
 	warn("A field received `tooltip`, which no longer renders the info badge next to its label. Pass the badge content as `labelTooltip` instead.");
 }
-
 //#endregion
 export { warnAboutLegacyTooltip };
+
 //# sourceMappingURL=legacy-tooltip.js.map

package/dist/components/form/legacy-tooltip.js.map

@@ -1 +1 @@
-{"version":3,"file":"legacy-tooltip.js","names":["warn","hasWarnedAboutLegacyTooltip","warnAboutLegacyTooltip","props","tooltip"],"sources":["../../../src/components/form/legacy-tooltip.ts"],"sourcesContent":["import { warn } from '../../utils/warnings';\n\nlet hasWarnedAboutLegacyTooltip = false;\n\n/**\n * `tooltip` used to be the field-level prop for the label's info badge. It is\n * `labelTooltip` now, and TypeScript flags every old call site — but not a JS\n * caller, an `as any`, or an untyped spread. Those would lose the badge\n * without a word, so say it once.\n *\n * Called by `wrapWithField` once it knows a label renders (without one the old\n * prop did nothing either), and by the legacy `Field` and `FieldWrapper`,\n * which a caller can reach without going through `wrapWithField`.\n *\n * A migration aid; remove once consumers are off `tooltip`.\n */\nexport function warnAboutLegacyTooltip(props: object) {\n  if (hasWarnedAboutLegacyTooltip) return;\n\n  const { tooltip } = props as { tooltip?: unknown };\n\n  if (tooltip == null || tooltip === false) return;\n\n  hasWarnedAboutLegacyTooltip = true;\n\n  warn(\n    'A field received `tooltip`, which no longer renders the info badge next to its label. Pass the badge content as `labelTooltip` instead.',\n  );\n}\n"],"mappings":";;;;AAEA,IAAIC,8BAA8B;;;;;;;;;;;;;AAclC,SAAgBC,uBAAuBC,OAAe;AACpD,KAAIF,4BAA6B;CAEjC,MAAM,EAAEG,YAAYD;AAEpB,KAAIC,WAAW,QAAQA,YAAY,MAAO;AAE1CH,+BAA8B;AAE9BD,MACE,0IACD"}
+{"version":3,"file":"legacy-tooltip.js","names":["warn","hasWarnedAboutLegacyTooltip","warnAboutLegacyTooltip","props","tooltip"],"sources":["../../../src/components/form/legacy-tooltip.ts"],"sourcesContent":["import { warn } from '../../utils/warnings';\n\nlet hasWarnedAboutLegacyTooltip = false;\n\n/**\n * `tooltip` used to be the field-level prop for the label's info badge. It is\n * `labelTooltip` now, and TypeScript flags every old call site — but not a JS\n * caller, an `as any`, or an untyped spread. Those would lose the badge\n * without a word, so say it once.\n *\n * Called by `wrapWithField` once it knows a label renders (without one the old\n * prop did nothing either), and by the legacy `Field` and `FieldWrapper`,\n * which a caller can reach without going through `wrapWithField`.\n *\n * A migration aid; remove once consumers are off `tooltip`.\n */\nexport function warnAboutLegacyTooltip(props: object) {\n  if (hasWarnedAboutLegacyTooltip) return;\n\n  const { tooltip } = props as { tooltip?: unknown };\n\n  if (tooltip == null || tooltip === false) return;\n\n  hasWarnedAboutLegacyTooltip = true;\n\n  warn(\n    'A field received `tooltip`, which no longer renders the info badge next to its label. Pass the badge content as `labelTooltip` instead.',\n  );\n}\n"],"mappings":";;;AAEA,IAAIC,8BAA8B;;;;;;;;;;;;;AAclC,SAAgBC,uBAAuBC,OAAe;CACpD,IAAIF,6BAA6B;CAEjC,MAAM,EAAEG,YAAYD;CAEpB,IAAIC,WAAW,QAAQA,YAAY,OAAO;CAE1CH,8BAA8B;CAE9BD,KACE,yIACF;AACF"}

package/dist/components/form/validation/ValidationIndicator.d.ts

@@ -1,28 +1,22 @@
 
 import { ValidationProps } from "../../../shared/form.js";
 import "../../../shared/index.js";
-import * as react from "react";
 import { ReactElement } from "react";
-
 //#region src/components/form/validation/ValidationIndicator.d.ts
-interface ValidationIndicatorProps extends ValidationProps {
+export interface ValidationIndicatorProps extends ValidationProps {
   isLoading?: boolean;
 }
 /** The validation icon for the current state, or `null` when there is nothing to show */
-declare function getValidationIcon({
-  isInvalid,
-  isValid
-}: ValidationProps): ReactElement | null;
+export declare function getValidationIcon({ isInvalid, isValid }: ValidationProps): ReactElement | null;
 /**
  * Whether an input needs to render the `data-element="State"` block. The loading indicator replaces the
  * validation icon while the input is loading.
  */
-declare function hasValidationIndicator(props: ValidationIndicatorProps): boolean;
+export declare function hasValidationIndicator(props: ValidationIndicatorProps): boolean;
 /**
  * Renders the validation state of an input as a suffix: either the validation icon or, while loading, the
  * loading indicator.
  */
-declare function ValidationIndicator(props: ValidationIndicatorProps): react.JSX.Element | null;
+export declare function ValidationIndicator(props: ValidationIndicatorProps): import("react").JSX.Element | null;
 //#endregion
-export { ValidationIndicator, ValidationIndicatorProps, getValidationIcon, hasValidationIndicator };
 //# sourceMappingURL=ValidationIndicator.d.ts.map

package/dist/components/form/validation/ValidationIndicator.js

@@ -1,11 +1,10 @@
-/** @license MIT | @cube-dev/ui-kit v0.197.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.198.0 | Cube Dev Team */
 import { LoadingIcon } from "../../../icons/LoadingIcon.js";
 import { hasValidationState } from "./resolve-validation-props.js";
 import { InvalidIcon } from "../../shared/InvalidIcon.js";
 import { ValidIcon } from "../../shared/ValidIcon.js";
 import { c } from "react/compiler-runtime";
 import { jsx } from "react/jsx-runtime";
-
 //#region src/components/form/validation/ValidationIndicator.tsx
 /** The validation icon for the current state, or `null` when there is nothing to show */
 function getValidationIcon({ isInvalid, isValid }) {
@@ -46,7 +45,7 @@ function ValidationIndicator(props) {
 	} else t1 = $[4];
 	return t1;
 }
-
 //#endregion
 export { ValidationIndicator, getValidationIcon, hasValidationIndicator };
+
 //# sourceMappingURL=ValidationIndicator.js.map

package/dist/components/form/validation/ValidationIndicator.js.map

@@ -1 +1 @@
-{"version":3,"file":"ValidationIndicator.js","names":["ReactElement","LoadingIcon","ValidationProps","InvalidIcon","ValidIcon","hasValidationState","ValidationIndicatorProps","isLoading","getValidationIcon","isInvalid","isValid","hasValidationIndicator","props","ValidationIndicator","$","_c","t0","t1"],"sources":["../../../../src/components/form/validation/ValidationIndicator.tsx"],"sourcesContent":["import { ReactElement } from 'react';\n\nimport { LoadingIcon } from '../../../icons/LoadingIcon';\nimport { ValidationProps } from '../../../shared/index';\nimport { InvalidIcon } from '../../shared/InvalidIcon';\nimport { ValidIcon } from '../../shared/ValidIcon';\n\nimport { hasValidationState } from './resolve-validation-props';\n\nexport interface ValidationIndicatorProps extends ValidationProps {\n  isLoading?: boolean;\n}\n\n/** The validation icon for the current state, or `null` when there is nothing to show */\nexport function getValidationIcon({\n  isInvalid,\n  isValid,\n}: ValidationProps): ReactElement | null {\n  if (isInvalid) return InvalidIcon;\n  if (isValid) return ValidIcon;\n\n  return null;\n}\n\n/**\n * Whether an input needs to render the `data-element=\"State\"` block. The loading indicator replaces the\n * validation icon while the input is loading.\n */\nexport function hasValidationIndicator(props: ValidationIndicatorProps) {\n  return !!props.isLoading || hasValidationState(props);\n}\n\n/**\n * Renders the validation state of an input as a suffix: either the validation icon or, while loading, the\n * loading indicator.\n */\nexport function ValidationIndicator(props: ValidationIndicatorProps) {\n  const { isLoading } = props;\n\n  if (!hasValidationIndicator(props)) {\n    return null;\n  }\n\n  return (\n    <div data-element=\"State\">\n      {isLoading ? (\n        <LoadingIcon data-element=\"InputIcon\" />\n      ) : (\n        getValidationIcon(props)\n      )}\n    </div>\n  );\n}\n"],"mappings":";;;;;;;;;;AAcA,SAAgBQ,kBAAkB,EAChCC,WACAC,WACuC;AACvC,KAAID,UAAW,QAAON;AACtB,KAAIO,QAAS,QAAON;AAEpB,QAAO;;;;;;AAOT,SAAgBO,uBAAuBC,OAAiC;AACtE,QAAO,CAAC,CAACA,MAAML,aAAaF,mBAAmBO,MAAM;;;;;;AAOvD,SAAOC,oBAAAD,OAAA;CAAA,MAAAE,IAAAC,EAAA,EAAA;CACL,MAAA,EAAAR,cAAsBK;AAEtB,KAAI,CAACD,uBAAuBC,MAAM,CAAA,QACzB;CACR,IAAAI;AAAA,KAAAF,EAAA,OAAAP,aAAAO,EAAA,OAAAF,OAAA;AAIII,OAAAT,YACC,oBAAC,eAAyB,gBAAA,cAG3B,GADCC,kBAAkBI,MACnB;AAAAE,IAAA,KAAAP;AAAAO,IAAA,KAAAF;AAAAE,IAAA,KAAAE;OAAAA,MAAAF,EAAA;CAAA,IAAAG;AAAA,KAAAH,EAAA,OAAAE,IAAA;AALHC,OAAA,oBAAA;GAAkB,gBAAA;aACfD;IAKG;AAAAF,IAAA,KAAAE;AAAAF,IAAA,KAAAG;OAAAA,MAAAH,EAAA;AAAA,QANNG"}
+{"version":3,"file":"ValidationIndicator.js","names":["ReactElement","LoadingIcon","ValidationProps","InvalidIcon","ValidIcon","hasValidationState","ValidationIndicatorProps","isLoading","getValidationIcon","isInvalid","isValid","hasValidationIndicator","props","ValidationIndicator","$","_c","t0","t1","_c"],"sources":["../../../../src/components/form/validation/ValidationIndicator.tsx"],"sourcesContent":["import { ReactElement } from 'react';\n\nimport { LoadingIcon } from '../../../icons/LoadingIcon';\nimport { ValidationProps } from '../../../shared/index';\nimport { InvalidIcon } from '../../shared/InvalidIcon';\nimport { ValidIcon } from '../../shared/ValidIcon';\n\nimport { hasValidationState } from './resolve-validation-props';\n\nexport interface ValidationIndicatorProps extends ValidationProps {\n  isLoading?: boolean;\n}\n\n/** The validation icon for the current state, or `null` when there is nothing to show */\nexport function getValidationIcon({\n  isInvalid,\n  isValid,\n}: ValidationProps): ReactElement | null {\n  if (isInvalid) return InvalidIcon;\n  if (isValid) return ValidIcon;\n\n  return null;\n}\n\n/**\n * Whether an input needs to render the `data-element=\"State\"` block. The loading indicator replaces the\n * validation icon while the input is loading.\n */\nexport function hasValidationIndicator(props: ValidationIndicatorProps) {\n  return !!props.isLoading || hasValidationState(props);\n}\n\n/**\n * Renders the validation state of an input as a suffix: either the validation icon or, while loading, the\n * loading indicator.\n */\nexport function ValidationIndicator(props: ValidationIndicatorProps) {\n  const { isLoading } = props;\n\n  if (!hasValidationIndicator(props)) {\n    return null;\n  }\n\n  return (\n    <div data-element=\"State\">\n      {isLoading ? (\n        <LoadingIcon data-element=\"InputIcon\" />\n      ) : (\n        getValidationIcon(props)\n      )}\n    </div>\n  );\n}\n"],"mappings":";;;;;;;;;AAcA,SAAgBQ,kBAAkB,EAChCC,WACAC,WACuC;CACvC,IAAID,WAAW,OAAON;CACtB,IAAIO,SAAS,OAAON;CAEpB,OAAO;AACT;;;;;AAMA,SAAgBO,uBAAuBC,OAAiC;CACtE,OAAO,CAAC,CAACA,MAAML,aAAaF,mBAAmBO,KAAK;AACtD;;;;;AAMA,SAAOC,oBAAAD,OAAA;CAAA,MAAAE,IAAAC,EAAA,CAAA;CACL,MAAA,EAAAR,cAAsBK;CAEtB,IAAI,CAACD,uBAAuBC,KAAK,GAAC,OACzB;CACR,IAAAI;CAAA,IAAAF,EAAA,OAAAP,aAAAO,EAAA,OAAAF,OAAA;EAIII,KAAAT,YACC,oBAAC,aAAD,EAA0B,gBAAA,YAAW,CAAA,IAErCC,kBAAkBI,KACpB;EAACE,EAAA,KAAAP;EAAAO,EAAA,KAAAF;EAAAE,EAAA,KAAAE;CAAA,OAAAA,KAAAF,EAAA;CAAA,IAAAG;CAAA,IAAAH,EAAA,OAAAE,IAAA;EALHC,KAAA,oBAAA,OAAA;GAAkB,gBAAA;GACfD,UAAAA;EAKG,CAAA;EAAAF,EAAA,KAAAE;EAAAF,EAAA,KAAAG;CAAA,OAAAA,KAAAH,EAAA;CAAA,OANNG;AAMM"}

package/dist/components/form/validation/index.d.ts

@@ -1,4 +1,5 @@
 
 import { ResolvableValidationProps, ResolvedValidationProps, getValidationMods, getValidationTheme, hasValidationState, resolveValidationProps } from "./resolve-validation-props.js";
 import { useValidationProps } from "./use-validation-props.js";
-import { ValidationIndicator, ValidationIndicatorProps, getValidationIcon, hasValidationIndicator } from "./ValidationIndicator.js";
+import { ValidationIndicator, ValidationIndicatorProps, getValidationIcon, hasValidationIndicator } from "./ValidationIndicator.js";
+export { ResolvableValidationProps, ResolvedValidationProps, ValidationIndicator, ValidationIndicatorProps, getValidationIcon, getValidationMods, getValidationTheme, hasValidationIndicator, hasValidationState, resolveValidationProps, useValidationProps };

package/dist/components/form/validation/resolve-validation-props.d.ts

@@ -1,13 +1,12 @@
 
 import { ValidationProps, ValidationState } from "../../../shared/form.js";
 import "../../../shared/index.js";
-
 //#region src/components/form/validation/resolve-validation-props.d.ts
-interface ResolvableValidationProps extends ValidationProps {
+export interface ResolvableValidationProps extends ValidationProps {
   /** @deprecated Use `isInvalid` / `isValid` instead. */
   validationState?: ValidationState;
 }
-interface ResolvedValidationProps {
+export interface ResolvedValidationProps {
   isInvalid: boolean | undefined;
   isValid: boolean | undefined;
 }
@@ -20,17 +19,11 @@ interface ResolvedValidationProps {
  *
  * `isInvalid` always wins over `isValid`.
  */
-declare function resolveValidationProps(props: ResolvableValidationProps): ResolvedValidationProps;
+export declare function resolveValidationProps(props: ResolvableValidationProps): ResolvedValidationProps;
 /** Whether the field has a validation state worth rendering an indicator for */
-declare function hasValidationState({
-  isInvalid,
-  isValid
-}: ValidationProps): boolean;
+export declare function hasValidationState({ isInvalid, isValid }: ValidationProps): boolean;
 /** Tasty modifiers for the validation state. Use instead of hand-writing `invalid`/`valid` mods. */
-declare function getValidationMods({
-  isInvalid,
-  isValid
-}: ValidationProps): {
+export declare function getValidationMods({ isInvalid, isValid }: ValidationProps): {
   invalid: boolean;
   valid: boolean;
 };
@@ -40,12 +33,8 @@ declare function getValidationMods({
  * By default only the invalid state is mapped, which keeps neutral triggers neutral while the suffix icon
  * communicates the valid state. Pass `includeValid` to also map the valid state onto `success`.
  */
-declare function getValidationTheme<T extends string | undefined>(theme: T, {
-  isInvalid,
-  isValid
-}: ValidationProps, options?: {
+export declare function getValidationTheme<T extends string | undefined>(theme: T, { isInvalid, isValid }: ValidationProps, options?: {
   includeValid?: boolean;
 }): T | 'danger' | 'success';
 //#endregion
-export { ResolvableValidationProps, ResolvedValidationProps, getValidationMods, getValidationTheme, hasValidationState, resolveValidationProps };
 //# sourceMappingURL=resolve-validation-props.d.ts.map

package/dist/components/form/validation/resolve-validation-props.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.197.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.198.0 | Cube Dev Team */
 //#region src/components/form/validation/resolve-validation-props.ts
 /**
 * Normalizes the validation props of a field into a pair of booleans.
@@ -43,7 +43,7 @@ function getValidationTheme(theme, { isInvalid, isValid }, options = {}) {
 	if (options.includeValid && isValid) return "success";
 	return theme;
 }
-
 //#endregion
 export { getValidationMods, getValidationTheme, hasValidationState, resolveValidationProps };
+
 //# sourceMappingURL=resolve-validation-props.js.map

package/dist/components/form/validation/resolve-validation-props.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-validation-props.js","names":["ValidationProps","ValidationState","ResolvableValidationProps","validationState","ResolvedValidationProps","isInvalid","isValid","resolveValidationProps","props","undefined","resolvedIsInvalid","hasValidationState","getValidationMods","invalid","valid","getValidationTheme","theme","T","options","includeValid"],"sources":["../../../../src/components/form/validation/resolve-validation-props.ts"],"sourcesContent":["import { ValidationProps, ValidationState } from '../../../shared/index';\n\nexport interface ResolvableValidationProps extends ValidationProps {\n  /** @deprecated Use `isInvalid` / `isValid` instead. */\n  validationState?: ValidationState;\n}\n\nexport interface ResolvedValidationProps {\n  isInvalid: boolean | undefined;\n  isValid: boolean | undefined;\n}\n\n/**\n * Normalizes the validation props of a field into a pair of booleans.\n *\n * When none of `isInvalid`, `isValid` and the deprecated `validationState` is provided, both flags stay\n * `undefined` so the caller can fall back to a derived state (form errors, `showValid`, …). As soon as any\n * of them is provided, both flags become definite booleans and no fallback applies.\n *\n * `isInvalid` always wins over `isValid`.\n */\nexport function resolveValidationProps(\n  props: ResolvableValidationProps,\n): ResolvedValidationProps {\n  const { isInvalid, isValid, validationState } = props;\n\n  if (\n    isInvalid === undefined &&\n    isValid === undefined &&\n    validationState === undefined\n  ) {\n    return { isInvalid: undefined, isValid: undefined };\n  }\n\n  const resolvedIsInvalid = isInvalid ?? validationState === 'invalid';\n\n  return {\n    isInvalid: resolvedIsInvalid,\n    isValid: resolvedIsInvalid ? false : isValid ?? validationState === 'valid',\n  };\n}\n\n/** Whether the field has a validation state worth rendering an indicator for */\nexport function hasValidationState({\n  isInvalid,\n  isValid,\n}: ValidationProps): boolean {\n  return !!isInvalid || !!isValid;\n}\n\n/** Tasty modifiers for the validation state. Use instead of hand-writing `invalid`/`valid` mods. */\nexport function getValidationMods({ isInvalid, isValid }: ValidationProps) {\n  return {\n    invalid: !!isInvalid,\n    valid: !!isValid && !isInvalid,\n  };\n}\n\n/**\n * Maps the validation state onto a theme name for triggers and items.\n *\n * By default only the invalid state is mapped, which keeps neutral triggers neutral while the suffix icon\n * communicates the valid state. Pass `includeValid` to also map the valid state onto `success`.\n */\nexport function getValidationTheme<T extends string | undefined>(\n  theme: T,\n  { isInvalid, isValid }: ValidationProps,\n  options: { includeValid?: boolean } = {},\n): T | 'danger' | 'success' {\n  if (isInvalid) return 'danger';\n  if (options.includeValid && isValid) return 'success';\n\n  return theme;\n}\n"],"mappings":";;;;;;;;;;;AAqBA,SAAgBO,uBACdC,OACyB;CACzB,MAAM,EAAEH,WAAWC,SAASH,oBAAoBK;AAEhD,KACEH,cAAcI,UACdH,YAAYG,UACZN,oBAAoBM,OAEpB,QAAO;EAAEJ,WAAWI;EAAWH,SAASG;EAAW;CAGrD,MAAMC,oBAAoBL,aAAaF,oBAAoB;AAE3D,QAAO;EACLE,WAAWK;EACXJ,SAASI,oBAAoB,QAAQJ,WAAWH,oBAAoB;EACrE;;;AAIH,SAAgBQ,mBAAmB,EACjCN,WACAC,WAC2B;AAC3B,QAAO,CAAC,CAACD,aAAa,CAAC,CAACC;;;AAI1B,SAAgBM,kBAAkB,EAAEP,WAAWC,WAA4B;AACzE,QAAO;EACLO,SAAS,CAAC,CAACR;EACXS,OAAO,CAAC,CAACR,WAAW,CAACD;EACtB;;;;;;;;AASH,SAAgBU,mBACdC,OACA,EAAEX,WAAWC,WACbY,UAAsC,EAAE,EACd;AAC1B,KAAIb,UAAW,QAAO;AACtB,KAAIa,QAAQC,gBAAgBb,QAAS,QAAO;AAE5C,QAAOU"}
+{"version":3,"file":"resolve-validation-props.js","names":["ValidationProps","ValidationState","ResolvableValidationProps","validationState","ResolvedValidationProps","isInvalid","isValid","resolveValidationProps","props","undefined","resolvedIsInvalid","hasValidationState","getValidationMods","invalid","valid","getValidationTheme","theme","T","options","includeValid"],"sources":["../../../../src/components/form/validation/resolve-validation-props.ts"],"sourcesContent":["import { ValidationProps, ValidationState } from '../../../shared/index';\n\nexport interface ResolvableValidationProps extends ValidationProps {\n  /** @deprecated Use `isInvalid` / `isValid` instead. */\n  validationState?: ValidationState;\n}\n\nexport interface ResolvedValidationProps {\n  isInvalid: boolean | undefined;\n  isValid: boolean | undefined;\n}\n\n/**\n * Normalizes the validation props of a field into a pair of booleans.\n *\n * When none of `isInvalid`, `isValid` and the deprecated `validationState` is provided, both flags stay\n * `undefined` so the caller can fall back to a derived state (form errors, `showValid`, …). As soon as any\n * of them is provided, both flags become definite booleans and no fallback applies.\n *\n * `isInvalid` always wins over `isValid`.\n */\nexport function resolveValidationProps(\n  props: ResolvableValidationProps,\n): ResolvedValidationProps {\n  const { isInvalid, isValid, validationState } = props;\n\n  if (\n    isInvalid === undefined &&\n    isValid === undefined &&\n    validationState === undefined\n  ) {\n    return { isInvalid: undefined, isValid: undefined };\n  }\n\n  const resolvedIsInvalid = isInvalid ?? validationState === 'invalid';\n\n  return {\n    isInvalid: resolvedIsInvalid,\n    isValid: resolvedIsInvalid\n      ? false\n      : (isValid ?? validationState === 'valid'),\n  };\n}\n\n/** Whether the field has a validation state worth rendering an indicator for */\nexport function hasValidationState({\n  isInvalid,\n  isValid,\n}: ValidationProps): boolean {\n  return !!isInvalid || !!isValid;\n}\n\n/** Tasty modifiers for the validation state. Use instead of hand-writing `invalid`/`valid` mods. */\nexport function getValidationMods({ isInvalid, isValid }: ValidationProps) {\n  return {\n    invalid: !!isInvalid,\n    valid: !!isValid && !isInvalid,\n  };\n}\n\n/**\n * Maps the validation state onto a theme name for triggers and items.\n *\n * By default only the invalid state is mapped, which keeps neutral triggers neutral while the suffix icon\n * communicates the valid state. Pass `includeValid` to also map the valid state onto `success`.\n */\nexport function getValidationTheme<T extends string | undefined>(\n  theme: T,\n  { isInvalid, isValid }: ValidationProps,\n  options: { includeValid?: boolean } = {},\n): T | 'danger' | 'success' {\n  if (isInvalid) return 'danger';\n  if (options.includeValid && isValid) return 'success';\n\n  return theme;\n}\n"],"mappings":";;;;;;;;;;;AAqBA,SAAgBO,uBACdC,OACyB;CACzB,MAAM,EAAEH,WAAWC,SAASH,oBAAoBK;CAEhD,IACEH,cAAcI,KAAAA,KACdH,YAAYG,KAAAA,KACZN,oBAAoBM,KAAAA,GAEpB,OAAO;EAAEJ,WAAWI,KAAAA;EAAWH,SAASG,KAAAA;CAAU;CAGpD,MAAMC,oBAAoBL,aAAaF,oBAAoB;CAE3D,OAAO;EACLE,WAAWK;EACXJ,SAASI,oBACL,QACCJ,WAAWH,oBAAoB;CACtC;AACF;;AAGA,SAAgBQ,mBAAmB,EACjCN,WACAC,WAC2B;CAC3B,OAAO,CAAC,CAACD,aAAa,CAAC,CAACC;AAC1B;;AAGA,SAAgBM,kBAAkB,EAAEP,WAAWC,WAA4B;CACzE,OAAO;EACLO,SAAS,CAAC,CAACR;EACXS,OAAO,CAAC,CAACR,WAAW,CAACD;CACvB;AACF;;;;;;;AAQA,SAAgBU,mBACdC,OACA,EAAEX,WAAWC,WACbY,UAAsC,CAAC,GACb;CAC1B,IAAIb,WAAW,OAAO;CACtB,IAAIa,QAAQC,gBAAgBb,SAAS,OAAO;CAE5C,OAAOU;AACT"}

package/dist/components/form/validation/use-validation-props.d.ts

@@ -1,6 +1,5 @@
 
 import { ResolvableValidationProps } from "./resolve-validation-props.js";
-
 //#region src/components/form/validation/use-validation-props.d.ts
 /**
  * Resolves `isInvalid` / `isValid` from the props and removes the deprecated `validationState` prop, so
@@ -10,7 +9,6 @@ import { ResolvableValidationProps } from "./resolve-validation-props.js";
  * built with `Omit` over a `Props` index signature expose no named properties and would fail the weak type
  * check of an all-optional constraint.
  */
-declare function useValidationProps<T>(props: T & ResolvableValidationProps): T;
+export declare function useValidationProps<T>(props: T & ResolvableValidationProps): T;
 //#endregion
-export { useValidationProps };
 //# sourceMappingURL=use-validation-props.d.ts.map

package/dist/components/form/validation/use-validation-props.js

@@ -1,8 +1,7 @@
-/** @license MIT | @cube-dev/ui-kit v0.197.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.198.0 | Cube Dev Team */
 import { useWarn } from "../../../_internal/hooks/use-warn.js";
 import { resolveValidationProps } from "./resolve-validation-props.js";
 import { c } from "react/compiler-runtime";
-
 //#region src/components/form/validation/use-validation-props.ts
 /**
 * Resolves `isInvalid` / `isValid` from the props and removes the deprecated `validationState` prop, so
@@ -49,7 +48,7 @@ function useValidationProps(props) {
 	} else t2 = $[7];
 	return t2;
 }
-
 //#endregion
 export { useValidationProps };
+
 //# sourceMappingURL=use-validation-props.js.map

package/dist/components/form/validation/use-validation-props.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-validation-props.js","names":["useWarn","ResolvableValidationProps","resolveValidationProps","useValidationProps","props","$","_c","t0","Symbol","for","key","args","validationState","undefined","isInvalid","isValid","rest","_validationState","t1","t2","T"],"sources":["../../../../src/components/form/validation/use-validation-props.ts"],"sourcesContent":["import { useWarn } from '../../../_internal/index';\n\nimport {\n  ResolvableValidationProps,\n  resolveValidationProps,\n} from './resolve-validation-props';\n\n/**\n * Resolves `isInvalid` / `isValid` from the props and removes the deprecated `validationState` prop, so\n * component bodies only ever deal with booleans.\n *\n * The validation props are intersected into the parameter instead of constraining `T`, because prop types\n * built with `Omit` over a `Props` index signature expose no named properties and would fail the weak type\n * check of an all-optional constraint.\n */\nexport function useValidationProps<T>(props: T & ResolvableValidationProps): T {\n  useWarn(props.validationState !== undefined, {\n    key: 'validation-state-deprecated',\n    args: [\n      'The \"validationState\" property is deprecated. Use \"isInvalid\" and \"isValid\" instead.',\n    ],\n  });\n\n  if (\n    props.validationState === undefined &&\n    props.isInvalid === undefined &&\n    props.isValid === undefined\n  ) {\n    return props;\n  }\n\n  const { validationState: _validationState, ...rest } = props;\n\n  return { ...rest, ...resolveValidationProps(props) } as T;\n}\n"],"mappings":";;;;;;;;;;;;;;AAeA,SAAOG,mBAAAC,OAAA;CAAA,MAAAC,IAAAC,EAAA,EAAA;CAAA,IAAAC;AAAA,KAAAF,EAAA,OAAAG,OAAAC,IAAA,4BAAA,EAAA;AACwCF,OAAA;GAAAG,KACtC;GAA6BC,MAC5B,CACJ,6FAAsF;GAEzF;AAAAN,IAAA,KAAAE;OAAAA,MAAAF,EAAA;AALDL,SAAQI,MAAKQ,oBAAqBC,QAAWN,GAK3C;AAEF,KACEH,MAAKQ,oBAAqBC,UAC1BT,MAAKU,cAAeD,UACpBT,MAAKW,YAAaF,OAAS,QAEpBT;CACR,IAAAY;AAAA,KAAAX,EAAA,OAAAD,OAAA;EAED,MAAA,EAAAQ,iBAAAK,kBAAA,GAAAC,OAAuDd;AAAvDY,SAAAE;AAA6Db,IAAA,KAAAD;AAAAC,IAAA,KAAAW;OAAAA,QAAAX,EAAA;CAAA,IAAAa;AAAA,KAAAb,EAAA,OAAAD,OAAA;AAExCc,OAAAhB,uBAAuBE,MAAM;AAAAC,IAAA,KAAAD;AAAAC,IAAA,KAAAa;OAAAA,MAAAb,EAAA;CAAA,IAAAc;AAAA,KAAAd,EAAA,OAAAW,QAAAX,EAAA,OAAAa,IAAA;AAA3CC,OAAA;GAAA,GAAKH;GAAI,GAAKE;GAA+B;AAAAb,IAAA,KAAAW;AAAAX,IAAA,KAAAa;AAAAb,IAAA,KAAAc;OAAAA,MAAAd,EAAA;AAAA,QAA7Cc"}
+{"version":3,"file":"use-validation-props.js","names":["useWarn","ResolvableValidationProps","resolveValidationProps","useValidationProps","props","$","_c","t0","Symbol","for","key","args","validationState","undefined","isInvalid","isValid","rest","_validationState","t1","t2","T","_c"],"sources":["../../../../src/components/form/validation/use-validation-props.ts"],"sourcesContent":["import { useWarn } from '../../../_internal/index';\n\nimport {\n  ResolvableValidationProps,\n  resolveValidationProps,\n} from './resolve-validation-props';\n\n/**\n * Resolves `isInvalid` / `isValid` from the props and removes the deprecated `validationState` prop, so\n * component bodies only ever deal with booleans.\n *\n * The validation props are intersected into the parameter instead of constraining `T`, because prop types\n * built with `Omit` over a `Props` index signature expose no named properties and would fail the weak type\n * check of an all-optional constraint.\n */\nexport function useValidationProps<T>(props: T & ResolvableValidationProps): T {\n  useWarn(props.validationState !== undefined, {\n    key: 'validation-state-deprecated',\n    args: [\n      'The \"validationState\" property is deprecated. Use \"isInvalid\" and \"isValid\" instead.',\n    ],\n  });\n\n  if (\n    props.validationState === undefined &&\n    props.isInvalid === undefined &&\n    props.isValid === undefined\n  ) {\n    return props;\n  }\n\n  const { validationState: _validationState, ...rest } = props;\n\n  return { ...rest, ...resolveValidationProps(props) } as T;\n}\n"],"mappings":";;;;;;;;;;;;;AAeA,SAAOG,mBAAAC,OAAA;CAAA,MAAAC,IAAAC,EAAA,CAAA;CAAA,IAAAC;CAAA,IAAAF,EAAA,OAAAG,OAAAC,IAAA,2BAAA,GAAA;EACwCF,KAAA;GAAAG,KACtC;GAA6BC,MAC5B,CACJ,4FAAsF;EAE1F;EAACN,EAAA,KAAAE;CAAA,OAAAA,KAAAF,EAAA;CALDL,QAAQI,MAAKQ,oBAAqBC,KAAAA,GAAWN,EAK5C;CAED,IACEH,MAAKQ,oBAAqBC,KAAAA,KAC1BT,MAAKU,cAAeD,KAAAA,KACpBT,MAAKW,YAAaF,KAAAA,GAAS,OAEpBT;CACR,IAAAY;CAAA,IAAAX,EAAA,OAAAD,OAAA;EAED,MAAA,EAAAQ,iBAAAK,kBAAA,GAAAC,OAAuDd;EAAvDY,OAAAE;EAA6Db,EAAA,KAAAD;EAAAC,EAAA,KAAAW;CAAA,OAAAA,OAAAX,EAAA;CAAA,IAAAa;CAAA,IAAAb,EAAA,OAAAD,OAAA;EAExCc,KAAAhB,uBAAuBE,KAAK;EAACC,EAAA,KAAAD;EAAAC,EAAA,KAAAa;CAAA,OAAAA,KAAAb,EAAA;CAAA,IAAAc;CAAA,IAAAd,EAAA,OAAAW,QAAAX,EAAA,OAAAa,IAAA;EAA3CC,KAAA;GAAA,GAAKH;GAAI,GAAKE;EAA8B;EAACb,EAAA,KAAAW;EAAAX,EAAA,KAAAa;EAAAb,EAAA,KAAAc;CAAA,OAAAA,KAAAd,EAAA;CAAA,OAA7Cc;AAAkD"}

package/dist/components/form/wrapper.d.ts

@@ -2,18 +2,32 @@
 import { FieldBaseProps, FormBaseProps } from "../../shared/form.js";
 import "../../shared/index.js";
 import { BaseProps } from "@tenphi/tasty";
-import * as react from "react";
 import { ReactElement, RefObject } from "react";
 import { DOMRef, FocusableRef } from "@react-types/shared";
-
 //#region src/components/form/wrapper.d.ts
 interface WrapWithFieldProps extends FieldBaseProps, Omit<BaseProps, 'children'>, FormBaseProps {}
-/** Field chrome is the default; only an explicit bare mode opts out. */
-declare function rendersFieldChrome(props: {
-  isBare?: boolean;
-}): boolean;
-/** Wraps a control in its stable field presentation and forwards its chrome props. */
-declare function wrapWithField<T extends WrapWithFieldProps>(component: ReactElement, ref: RefObject<unknown> | FocusableRef<HTMLElement> | DOMRef<HTMLElement>, props: T): react.JSX.Element;
+/**
+ * Whether `wrapWithField` renders the field chrome for these props. An
+ * explicit `isBare` decides; `useFieldProps` sets `isBare={false}` on a bound
+ * field, one passed a chrome prop, or one with a `validate` whose errors the
+ * control shows (`withFieldChrome`).
+ * Otherwise a non-empty `label` renders it, as does the deprecated
+ * `forceField`.
+ */
+export declare function rendersFieldChrome(props: object): boolean;
+type LegacyFieldRef = RefObject<unknown> | FocusableRef<HTMLElement> | DOMRef<HTMLElement> | null | undefined;
+/**
+ * Wraps a control in its field chrome when it has one, and forwards its chrome
+ * props. The chrome takes no ref: the control attaches the field's `ref` to
+ * its own root, so the ref is the same element with or without the chrome, and
+ * `labelRef` reaches the label.
+ */
+export declare function wrapWithField<T extends WrapWithFieldProps>(component: ReactElement, props: T): ReactElement;
+/**
+ * @deprecated Attach the field's ref to the control's root and call
+ * `wrapWithField(component, props)`. The `ref` passed here is ignored.
+ */
+export declare function wrapWithField<T extends WrapWithFieldProps>(component: ReactElement, ref: LegacyFieldRef, props: T): ReactElement;
 //#endregion
-export { rendersFieldChrome, wrapWithField };
+export {};
 //# sourceMappingURL=wrapper.d.ts.map