@cube-dev/ui-kit 0.0.0-canary-4616d9b → 0.0.0-canary-bacd3ad

package/dist/components/form/Form/use-field/use-field.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-4616d9b | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-bacd3ad | Cube Dev Team */
 import { useEvent } from "../../../../_internal/hooks/use-event.js";
 import { useIsFirstRender } from "../../../../_internal/hooks/use-is-first-render.js";
 import { resolveValidationProps } from "../../validation/resolve-validation-props.js";
@@ -26,7 +26,7 @@ function removeId(name, id) {
 }
 function useField(props, params) {
 	props = useFormProps(props);
-	let { defaultValue, id, idPrefix, name, form, rules, message, description, errorMessage, validateTrigger = params.defaultValidationTrigger, validationDelay, showValid, shouldUpdate, isRequired: isRequiredProp, necessityIndicator: necessityIndicatorProp } = props;
+	let { defaultValue, id, idPrefix, name, form, rules, message, description, errorMessage, validateTrigger = params.defaultValidationTrigger, validationDelay, showValid, shouldUpdate, isRequired: isRequiredProp } = props;
 	const { isInvalid: isInvalidProp, isValid: isValidProp } = resolveValidationProps(props);
 	const processedRules = useMemo(() => {
 		let finalRules = rules;
@@ -58,7 +58,6 @@ function useField(props, params) {
 	let field = form?.getFieldInstance(fieldName);
 	if (field) field.rules = processedRules;
 	let isRequired = !!processedRules?.find((rule) => "required" in rule && rule.required === true);
-	const suppressNecessityIndicator = isRequired && !isRequiredProp && necessityIndicatorProp === void 0;
 	useEffect(() => {
 		if (!form) return;
 		if (field) form.forceReRender();
@@ -105,7 +104,6 @@ function useField(props, params) {
 		isInvalid: isInvalidProp ?? !!field?.errors?.length,
 		isValid: isValidProp ?? !!(showValid && field?.status === "valid"),
 		...isRequired && { isRequired },
-		...suppressNecessityIndicator && { necessityIndicator: null },
 		message: message !== void 0 ? message : field?.status === "invalid" && field?.errors?.[0],
 		description,
 		errorMessage: errorMessage !== void 0 ? errorMessage : field?.status === "invalid" && field?.errors?.length ? field.errors[0] : void 0,
@@ -120,7 +118,6 @@ function useField(props, params) {
 		fieldId,
 		fieldName,
 		isRequired,
-		suppressNecessityIndicator,
 		message,
 		description,
 		errorMessage,

package/dist/components/form/Form/use-field/use-field.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-field.js","names":[],"sources":["../../../../../src/components/form/Form/use-field/use-field.ts"],"sourcesContent":["import { useEffect, useMemo, useState } from 'react';\n\nimport { useEvent, useIsFirstRender } from '../../../../_internal/index';\nimport { ValidateTrigger } from '../../../../shared/index';\nimport { resolveValidationProps } from '../../validation/index';\nimport { useFormProps } from '../Form';\nimport { FieldTypes } from '../types';\nimport { delayValidationRule } from '../validation';\n\nimport { FieldReturnValue, UseFieldProps } from './types';\n\nconst ID_MAP = {};\n\nfunction createId(name) {\n  if (!name) return;\n\n  if (!ID_MAP[name]) {\n    ID_MAP[name] = [];\n  }\n\n  let i = 0;\n  let id;\n\n  do {\n    id = i ? `${name}_${i}` : name;\n    i++;\n  } while (ID_MAP[name].includes(id));\n\n  ID_MAP[name].push(id);\n\n  return id;\n}\n\nfunction removeId(name, id) {\n  if (!ID_MAP[name]) return;\n\n  ID_MAP[name] = ID_MAP[name].filter((_id) => _id !== id);\n}\n\nexport type UseFieldParams = {\n  defaultValidationTrigger?: ValidateTrigger;\n};\n\nexport function useField<T extends FieldTypes, Props extends UseFieldProps<T>>(\n  props: Props,\n  params: UseFieldParams,\n): FieldReturnValue<T> {\n  props = useFormProps(props);\n\n  let {\n    defaultValue,\n    id,\n    idPrefix,\n    name,\n    form,\n    rules,\n    message,\n    description,\n    errorMessage,\n    validateTrigger = params.defaultValidationTrigger,\n    validationDelay,\n    showValid,\n    shouldUpdate,\n    isRequired: isRequiredProp,\n    necessityIndicator: necessityIndicatorProp,\n  } = props;\n\n  const { isInvalid: isInvalidProp, isValid: isValidProp } =\n    resolveValidationProps(props);\n\n  const processedRules = useMemo(() => {\n    let finalRules = rules;\n\n    // If isRequired prop is set, ensure there's a required rule\n    if (isRequiredProp) {\n      const hasRequiredRule = finalRules?.some(\n        (rule) => 'required' in rule && rule.required === true,\n      );\n\n      if (!hasRequiredRule) {\n        finalRules = finalRules\n          ? [{ required: true }, ...finalRules]\n          : [{ required: true }];\n      }\n    }\n\n    // Add delay rule if needed\n    if (finalRules && finalRules.length && validationDelay) {\n      return [delayValidationRule(validationDelay), ...finalRules];\n    }\n\n    return finalRules;\n  }, [rules, validationDelay, isRequiredProp]);\n\n  const nonInput = !name;\n  const fieldName: string = name != null ? name : '';\n\n  const isFirstRender = useIsFirstRender();\n  let [fieldId, setFieldId] = useState(\n    id || (idPrefix ? `${idPrefix}_${fieldName}` : fieldName),\n  );\n\n  useEffect(() => {\n    let newId;\n\n    if (!id && !nonInput) {\n      newId = createId(fieldId);\n\n      setFieldId(newId);\n    }\n\n    return () => {\n      if (!id) {\n        removeId(idPrefix ? `${idPrefix}_${fieldName}` : fieldName, newId);\n      }\n\n      if (fieldName && form) {\n        form.removeField(fieldName);\n      }\n    };\n  }, [fieldName]);\n\n  let field = form?.getFieldInstance(fieldName);\n\n  if (field) {\n    field.rules = processedRules;\n  }\n\n  let isRequired = !!processedRules?.find(\n    (rule) => 'required' in rule && rule.required === true,\n  );\n\n  // `isRequired` has two sources with different intent. A `required` rule states\n  // how the field behaves: it is what validation runs, and `aria-required` is\n  // its programmatic mirror, so the flag has to reach the input either way. The\n  // `isRequired` prop additionally states what the label should say. So unless\n  // the prop itself asked for the marker, suppress it — an absent prop and an\n  // explicit `isRequired={false}` both mean \"do not mark this\", the latter\n  // rather more loudly. An explicit `necessityIndicator` overrides either way,\n  // being a request for the marker in its own right.\n  const suppressNecessityIndicator =\n    isRequired && !isRequiredProp && necessityIndicatorProp === undefined;\n\n  useEffect(() => {\n    if (!form) return;\n\n    if (field) {\n      form.forceReRender();\n    } else {\n      field = form.createField(fieldName);\n    }\n  }, [field]);\n\n  if (form) {\n    if (isFirstRender) {\n      if (!field) {\n        field = form.createField(fieldName, true);\n      }\n\n      if (field?.value == null && defaultValue != null) {\n        form.setFieldValue(fieldName, defaultValue, false, true);\n        form.updateInitialFieldsValue({ [fieldName]: defaultValue });\n\n        field = form?.getFieldInstance(fieldName);\n      }\n    }\n\n    if (!field?.touched && defaultValue != null) {\n      form.setFieldValue(fieldName, defaultValue, false, true);\n    }\n  }\n\n  const onChangeHandler = useEvent((val: any, dontTouch: boolean) => {\n    if (!form) return;\n\n    const field = form.getFieldInstance(fieldName);\n\n    if (shouldUpdate) {\n      const fieldsValue = form.getFieldsValue();\n\n      // check if we should update the value of the field\n      const shouldNotBeUpdated =\n        typeof shouldUpdate === 'boolean'\n          ? !shouldUpdate\n          : !shouldUpdate(fieldsValue, {\n              ...fieldsValue,\n              [fieldName]: val,\n            });\n\n      if (shouldNotBeUpdated) {\n        return;\n      }\n    }\n\n    form.setFieldValue(fieldName, val, !dontTouch);\n\n    if (\n      !dontTouch &&\n      (validateTrigger === 'onChange' ||\n        (field && field.errors && field.errors.length))\n    ) {\n      form.validateField(fieldName).catch(() => {}); // do nothing on fail\n    }\n  });\n\n  const onBlurHandler = useEvent(() => {\n    if (validateTrigger === 'onBlur') {\n      // We need a timeout so the change event can be done.\n      setTimeout(() => {\n        form?.validateField(fieldName).catch(() => {}); // do nothing on fail\n      });\n    }\n  });\n\n  let value = field?.value;\n\n  return useMemo(\n    () => ({\n      id: fieldId,\n      name: fieldName,\n      value,\n      validateTrigger,\n      form,\n      field,\n      nonInput,\n\n      // Explicit validation props always win over the state derived from the form\n      isInvalid: isInvalidProp ?? !!field?.errors?.length,\n      isValid: isValidProp ?? !!(showValid && field?.status === 'valid'),\n      ...(isRequired && { isRequired }),\n      ...(suppressNecessityIndicator && { necessityIndicator: null }),\n      message:\n        message !== undefined\n          ? message\n          : field?.status === 'invalid' && field?.errors?.[0],\n      description,\n      errorMessage:\n        errorMessage !== undefined\n          ? errorMessage\n          : field?.status === 'invalid' && field?.errors?.length\n            ? field.errors[0]\n            : undefined,\n      onBlur: onBlurHandler,\n      onChange: onChangeHandler,\n    }),\n    [\n      form,\n      field,\n      field?.value,\n      field?.errors?.length,\n      field?.status,\n      fieldId,\n      fieldName,\n      isRequired,\n      suppressNecessityIndicator,\n      message,\n      description,\n      errorMessage,\n      onBlurHandler,\n      onChangeHandler,\n      validateTrigger,\n      isInvalidProp,\n      isValidProp,\n      showValid,\n      nonInput,\n    ],\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"use-field.js","names":[],"sources":["../../../../../src/components/form/Form/use-field/use-field.ts"],"sourcesContent":["import { useEffect, useMemo, useState } from 'react';\n\nimport { useEvent, useIsFirstRender } from '../../../../_internal/index';\nimport { ValidateTrigger } from '../../../../shared/index';\nimport { resolveValidationProps } from '../../validation/index';\nimport { useFormProps } from '../Form';\nimport { FieldTypes } from '../types';\nimport { delayValidationRule } from '../validation';\n\nimport { FieldReturnValue, UseFieldProps } from './types';\n\nconst ID_MAP = {};\n\nfunction createId(name) {\n  if (!name) return;\n\n  if (!ID_MAP[name]) {\n    ID_MAP[name] = [];\n  }\n\n  let i = 0;\n  let id;\n\n  do {\n    id = i ? `${name}_${i}` : name;\n    i++;\n  } while (ID_MAP[name].includes(id));\n\n  ID_MAP[name].push(id);\n\n  return id;\n}\n\nfunction removeId(name, id) {\n  if (!ID_MAP[name]) return;\n\n  ID_MAP[name] = ID_MAP[name].filter((_id) => _id !== id);\n}\n\nexport type UseFieldParams = {\n  defaultValidationTrigger?: ValidateTrigger;\n};\n\nexport function useField<T extends FieldTypes, Props extends UseFieldProps<T>>(\n  props: Props,\n  params: UseFieldParams,\n): FieldReturnValue<T> {\n  props = useFormProps(props);\n\n  let {\n    defaultValue,\n    id,\n    idPrefix,\n    name,\n    form,\n    rules,\n    message,\n    description,\n    errorMessage,\n    validateTrigger = params.defaultValidationTrigger,\n    validationDelay,\n    showValid,\n    shouldUpdate,\n    isRequired: isRequiredProp,\n  } = props;\n\n  const { isInvalid: isInvalidProp, isValid: isValidProp } =\n    resolveValidationProps(props);\n\n  const processedRules = useMemo(() => {\n    let finalRules = rules;\n\n    // If isRequired prop is set, ensure there's a required rule\n    if (isRequiredProp) {\n      const hasRequiredRule = finalRules?.some(\n        (rule) => 'required' in rule && rule.required === true,\n      );\n\n      if (!hasRequiredRule) {\n        finalRules = finalRules\n          ? [{ required: true }, ...finalRules]\n          : [{ required: true }];\n      }\n    }\n\n    // Add delay rule if needed\n    if (finalRules && finalRules.length && validationDelay) {\n      return [delayValidationRule(validationDelay), ...finalRules];\n    }\n\n    return finalRules;\n  }, [rules, validationDelay, isRequiredProp]);\n\n  const nonInput = !name;\n  const fieldName: string = name != null ? name : '';\n\n  const isFirstRender = useIsFirstRender();\n  let [fieldId, setFieldId] = useState(\n    id || (idPrefix ? `${idPrefix}_${fieldName}` : fieldName),\n  );\n\n  useEffect(() => {\n    let newId;\n\n    if (!id && !nonInput) {\n      newId = createId(fieldId);\n\n      setFieldId(newId);\n    }\n\n    return () => {\n      if (!id) {\n        removeId(idPrefix ? `${idPrefix}_${fieldName}` : fieldName, newId);\n      }\n\n      if (fieldName && form) {\n        form.removeField(fieldName);\n      }\n    };\n  }, [fieldName]);\n\n  let field = form?.getFieldInstance(fieldName);\n\n  if (field) {\n    field.rules = processedRules;\n  }\n\n  let isRequired = !!processedRules?.find(\n    (rule) => 'required' in rule && rule.required === true,\n  );\n\n  useEffect(() => {\n    if (!form) return;\n\n    if (field) {\n      form.forceReRender();\n    } else {\n      field = form.createField(fieldName);\n    }\n  }, [field]);\n\n  if (form) {\n    if (isFirstRender) {\n      if (!field) {\n        field = form.createField(fieldName, true);\n      }\n\n      if (field?.value == null && defaultValue != null) {\n        form.setFieldValue(fieldName, defaultValue, false, true);\n        form.updateInitialFieldsValue({ [fieldName]: defaultValue });\n\n        field = form?.getFieldInstance(fieldName);\n      }\n    }\n\n    if (!field?.touched && defaultValue != null) {\n      form.setFieldValue(fieldName, defaultValue, false, true);\n    }\n  }\n\n  const onChangeHandler = useEvent((val: any, dontTouch: boolean) => {\n    if (!form) return;\n\n    const field = form.getFieldInstance(fieldName);\n\n    if (shouldUpdate) {\n      const fieldsValue = form.getFieldsValue();\n\n      // check if we should update the value of the field\n      const shouldNotBeUpdated =\n        typeof shouldUpdate === 'boolean'\n          ? !shouldUpdate\n          : !shouldUpdate(fieldsValue, {\n              ...fieldsValue,\n              [fieldName]: val,\n            });\n\n      if (shouldNotBeUpdated) {\n        return;\n      }\n    }\n\n    form.setFieldValue(fieldName, val, !dontTouch);\n\n    if (\n      !dontTouch &&\n      (validateTrigger === 'onChange' ||\n        (field && field.errors && field.errors.length))\n    ) {\n      form.validateField(fieldName).catch(() => {}); // do nothing on fail\n    }\n  });\n\n  const onBlurHandler = useEvent(() => {\n    if (validateTrigger === 'onBlur') {\n      // We need a timeout so the change event can be done.\n      setTimeout(() => {\n        form?.validateField(fieldName).catch(() => {}); // do nothing on fail\n      });\n    }\n  });\n\n  let value = field?.value;\n\n  return useMemo(\n    () => ({\n      id: fieldId,\n      name: fieldName,\n      value,\n      validateTrigger,\n      form,\n      field,\n      nonInput,\n\n      // Explicit validation props always win over the state derived from the form\n      isInvalid: isInvalidProp ?? !!field?.errors?.length,\n      isValid: isValidProp ?? !!(showValid && field?.status === 'valid'),\n      ...(isRequired && { isRequired }),\n      message:\n        message !== undefined\n          ? message\n          : field?.status === 'invalid' && field?.errors?.[0],\n      description,\n      errorMessage:\n        errorMessage !== undefined\n          ? errorMessage\n          : field?.status === 'invalid' && field?.errors?.length\n            ? field.errors[0]\n            : undefined,\n      onBlur: onBlurHandler,\n      onChange: onChangeHandler,\n    }),\n    [\n      form,\n      field,\n      field?.value,\n      field?.errors?.length,\n      field?.status,\n      fieldId,\n      fieldName,\n      isRequired,\n      message,\n      description,\n      errorMessage,\n      onBlurHandler,\n      onChangeHandler,\n      validateTrigger,\n      isInvalidProp,\n      isValidProp,\n      showValid,\n      nonInput,\n    ],\n  );\n}\n"],"mappings":"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"}

package/dist/components/form/Form/use-form.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-4616d9b | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-bacd3ad | Cube Dev Team */
 import { applyRules } from "./validation.js";
 import { dotize } from "@tenphi/tasty";
 import { useRef, useState } from "react";

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

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-4616d9b | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-bacd3ad | Cube Dev Team */
 import { validate } from "email-validator";
 import validUrl from "valid-url";
 

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

@@ -9,21 +9,11 @@ import * as react_jsx_runtime0 from "react/jsx-runtime";
 interface CubeNecessityIndicatorProps {
   /**
    * `'icon'` renders the asterisk, `'label'` the `(required)` / `(optional)`
-   * text. Defaults to `'icon'`, which has no optional form and so only ever
-   * marks a required field. `null` suppresses the indicator entirely.
+   * text. `null` suppresses it — `Label` resolves its own default to that when
+   * `isRequired` was never passed, and forwards the result here.
    */
   necessityIndicator?: NecessityIndicator | null;
-  /**
-   * Marks the label as required. Only an `isRequired` authored on the input,
-   * the label or the `Form` reaches this — a `required` validation rule drives
-   * validation and `aria-required` without decorating the label.
-   */
   isRequired?: boolean;
-  /**
-   * Marks the label as optional. Purely presentational, and ignored when the
-   * field is required.
-   */
-  isOptional?: boolean;
   /**
    * Whether the indicator contributes to the field's accessible name. Off by
    * default because a required field already announces `aria-required`, and
@@ -39,17 +29,15 @@ interface CubeNecessityIndicatorProps {
  * builds a element tree around the label and therefore has to place the marker
  * beside the label text itself rather than after the whole tree.
  *
- * Both marks are opt-in: nothing renders unless the call site passed
- * `isRequired` or `isOptional`.
+ * Renders nothing unless a marker was actually asked for.
  */
 declare function NecessityIndicatorMark(props: CubeNecessityIndicatorProps): react_jsx_runtime0.JSX.Element | null;
 declare const INLINE_LABEL_STYLES: Styles;
 declare const LABEL_STYLES: Styles;
 interface CubeLabelProps extends BaseProps, ContainerStyleProps, ValidationProps {
   labelPosition?: LabelPosition;
-  necessityIndicator?: NecessityIndicator | null;
+  necessityIndicator?: NecessityIndicator;
   isRequired?: boolean;
-  isOptional?: boolean;
   includeNecessityIndicatorInAccessibilityName?: boolean;
   htmlFor?: string;
   for?: string;

package/dist/components/form/Label.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-4616d9b | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-bacd3ad | Cube Dev Team */
 import { extractStyles } from "../../utils/styles.js";
 import { useProviderProps } from "../../provider.js";
 import { useI18n } from "../../i18n/useI18n.js";
@@ -27,18 +27,6 @@ const REQUIRED_ICON = /* @__PURE__ */ jsx("svg", {
 	}) }) })
 });
 /**
-* The `(required)` / `(optional)` note. Deliberately quieter than the label it
-* follows: it is an aside about the field, not part of its name.
-*/
-const NecessityLabelElement = tasty({
-	as: "span",
-	qa: "NecessityLabel",
-	styles: {
-		color: "#dark-03",
-		fontWeight: 400
-	}
-});
-/**
 * The `*` or `(required)` / `(optional)` marker that follows a field label.
 *
 * Its own component because two places render it and both need the same
@@ -46,27 +34,25 @@ const NecessityLabelElement = tasty({
 * builds a element tree around the label and therefore has to place the marker
 * beside the label text itself rather than after the whole tree.
 *
-* Both marks are opt-in: nothing renders unless the call site passed
-* `isRequired` or `isOptional`.
+* Renders nothing unless a marker was actually asked for.
 */
 function NecessityIndicatorMark(props) {
-	const { isRequired, isOptional, necessityIndicator = "icon", includeNecessityIndicatorInAccessibilityName = false } = props;
+	const { isRequired, necessityIndicator = isRequired != null ? "icon" : null, includeNecessityIndicatorInAccessibilityName = false } = props;
 	const { t } = useI18n();
 	const requiredLabel = t("form.required", "(required)");
 	const separator = " ​";
-	if (necessityIndicator === null) return null;
-	if (isRequired) {
-		if (necessityIndicator === "icon") return /* @__PURE__ */ jsxs(Fragment$1, { children: [separator, /* @__PURE__ */ jsx("span", {
+	if (necessityIndicator === "icon") {
+		if (!isRequired) return null;
+		return /* @__PURE__ */ jsxs(Fragment$1, { children: [separator, /* @__PURE__ */ jsx("span", {
 			"aria-label": includeNecessityIndicatorInAccessibilityName ? requiredLabel : void 0,
 			children: REQUIRED_ICON
 		})] });
-		return /* @__PURE__ */ jsxs(Fragment$1, { children: [separator, /* @__PURE__ */ jsx(NecessityLabelElement, {
-			"aria-hidden": !includeNecessityIndicatorInAccessibilityName ? true : void 0,
-			children: requiredLabel
-		})] });
 	}
-	if (!isOptional) return null;
-	return /* @__PURE__ */ jsxs(Fragment$1, { children: [separator, /* @__PURE__ */ jsx(NecessityLabelElement, { children: t("form.optional", "(optional)") })] });
+	if (necessityIndicator !== "label") return null;
+	return /* @__PURE__ */ jsxs(Fragment$1, { children: [separator, /* @__PURE__ */ jsx("span", {
+		"aria-hidden": !includeNecessityIndicatorInAccessibilityName ? isRequired : void 0,
+		children: isRequired ? requiredLabel : t("form.optional", "(optional)")
+	})] });
 }
 const INLINE_LABEL_STYLES = {
 	preset: "t3",
@@ -99,12 +85,11 @@ const LabelElement = tasty({
 function Label(props, ref) {
 	props = useProviderProps(props);
 	const { t } = useI18n();
-	let { as, qa, children, labelPosition = "top", isRequired, isOptional, necessityIndicator, includeNecessityIndicatorInAccessibilityName = false, htmlFor, isDisabled, isInvalid, isValid, size = "medium", for: labelFor, ...otherProps } = props;
+	let { as, qa, children, labelPosition = "top", isRequired, necessityIndicator = isRequired != null ? "icon" : null, includeNecessityIndicatorInAccessibilityName = false, htmlFor, isDisabled, isInvalid, isValid, size = "medium", for: labelFor, ...otherProps } = props;
 	let domRef = useObjectRef(ref);
 	const styles = extractStyles(otherProps, CONTAINER_STYLES);
 	const mark = /* @__PURE__ */ jsx(NecessityIndicatorMark, {
 		isRequired,
-		isOptional,
 		necessityIndicator,
 		includeNecessityIndicatorInAccessibilityName
 	});

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

@@ -1 +1 @@
-{"version":3,"file":"Label.js","names":[],"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 */\nconst NecessityLabelElement = tasty({\n  as: 'span',\n  qa: 'NecessityLabel',\n  styles: {\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  if (necessityIndicator === null) return null;\n\n  if (isRequired) {\n    if (necessityIndicator === 'icon') {\n      return (\n        <>\n          {separator}\n          <span\n            aria-label={\n              includeNecessityIndicatorInAccessibilityName\n                ? requiredLabel\n                : undefined\n            }\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":";;;;;;;;;;;AAsBA,MAAM,gBACJ,oBAAC;CACC,OAAM;CACN,SAAQ;CACR,GAAE;CACF,GAAE;CACF,SAAQ;CACR,OAAO;EAEL,kBAAkB;EAClB,OAAO;EACP,QAAQ;EACR,WAAW;EACZ;WAED,oBAAC,sBACC,oBAAC,iBACC,oBAAC;EACC,MAAK;EACL,QAAO;GACP,GACA,GACG;EACL;;;;;AAOR,MAAM,wBAAwB,MAAM;CAClC,IAAI;CACJ,IAAI;CACJ,QAAQ;EACN,OAAO;EACP,YAAY;EACb;CACF,CAAC;;;;;;;;;;;;AAuCF,SAAgB,uBAAuB,OAAoC;CACzE,MAAM,EACJ,YACA,YACA,qBAAqB,QACrB,+CAA+C,UAC7C;CACJ,MAAM,EAAE,MAAM,SAAS;CAEvB,MAAM,gBAAgB,EAAE,iBAAiB,aAAa;CAItD,MAAM,YAAY;AAElB,KAAI,uBAAuB,KAAM,QAAO;AAExC,KAAI,YAAY;AACd,MAAI,uBAAuB,OACzB,QACE,8CACG,WACD,oBAAC;GACC,cACE,+CACI,gBACA;aAGL;IACI,IACN;AAMP,SACE,8CACG,WACD,oBAAC;GACC,eACE,CAAC,+CAA+C,OAAO;aAGxD;IACqB,IACvB;;AAOP,KAAI,CAAC,WAAY,QAAO;AAExB,QACE,8CACG,WACD,oBAAC,mCACE,EAAE,iBAAiB,aAAa,GACX,IACvB;;AAIP,MAAa,sBAA8B;CACzC,QAAQ;CACR,OAAO;EACL,IAAI;EACJ,SAAS;EACV;CACF;AAED,MAAa,eAAuB;CAClC,SAAS;CACT,QAAQ;EACN,IAAI;EACJ,cAAc;EACf;CACD,OAAO;EACL,IAAI;EACJ,SAAS;EACV;CACD,OAAO;EACL,IAAI;EACJ,MAAM;EACN,OAAO;EACR;CACF;AAED,MAAM,eAAe,MAAM;CACzB,IAAI;CACJ,IAAI;CACJ,QAAQ;CACT,CAAC;AAgBF,SAAS,MAAM,OAAuB,KAAK;AACzC,SAAQ,iBAAiC,MAAM;CAE/C,MAAM,EAAE,MAAM,SAAS;CAEvB,IAAI,EACF,IACA,IACA,UACA,gBAAgB,OAChB,YACA,YACA,oBACA,+CAA+C,OAC/C,SACA,YACA,WACA,SACA,OAAO,UACP,KAAK,UACL,GAAG,eACD;CAEJ,IAAI,SAAS,aAAa,IAAI;CAE9B,MAAM,SAAS,cAAc,YAAY,iBAAiB;CAE1D,MAAM,OACJ,oBAAC;EACa;EACA;EACQ;EAElB;GAEF;AAGJ,QACE,oBAAC;EACC,GAAI,gBAAgB,WAAW;EAC/B,KAAK;EACG;EACR,SAAS,YAAY;EACrB,aAAW;EACX,MAAM;GACJ,MAAM,kBAAkB;GACxB,UAAU;GACV,GAAG,kBAAkB;IAAE;IAAW;IAAS,CAAC;GAC7C;YASA,OAAO,aAAa,WACnB,WAEA,8CACG,UACA,QACA;GAEQ;;AAInB,IAAI,SAAS,WAAW,MAAM;AAE9B,OAAO,cAAc"}
+{"version":3,"file":"Label.js","names":[],"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\nexport interface CubeNecessityIndicatorProps {\n  /**\n   * `'icon'` renders the asterisk, `'label'` the `(required)` / `(optional)`\n   * text. `null` suppresses it — `Label` resolves its own default to that when\n   * `isRequired` was never passed, and forwards the result here.\n   */\n  necessityIndicator?: NecessityIndicator | null;\n  isRequired?: 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 * Renders nothing unless a marker was actually asked for.\n */\nexport function NecessityIndicatorMark(props: CubeNecessityIndicatorProps) {\n  const {\n    isRequired,\n    // Same default as `Label`'s own prop: passing `isRequired` at all opts into\n    // the asterisk, and `'label'` has to be asked for. Applied here so the two\n    // call sites cannot disagree about what an omitted prop means.\n    necessityIndicator = isRequired != null ? 'icon' : null,\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  if (necessityIndicator === 'icon') {\n    if (!isRequired) return null;\n\n    return (\n      <>\n        {separator}\n        <span\n          aria-label={\n            includeNecessityIndicatorInAccessibilityName\n              ? requiredLabel\n              : undefined\n          }\n        >\n          {REQUIRED_ICON}\n        </span>\n      </>\n    );\n  }\n\n  if (necessityIndicator !== 'label') return null;\n\n  // Hidden from screen readers when the field is required, because\n  // `aria-required` on the input already announces it. When the field is\n  // optional there is nothing else saying so, so that one is announced.\n  return (\n    <>\n      {separator}\n      <span\n        aria-hidden={\n          !includeNecessityIndicatorInAccessibilityName ? isRequired : undefined\n        }\n      >\n        {isRequired ? requiredLabel : t('form.optional', '(optional)')}\n      </span>\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;\n  isRequired?: 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    necessityIndicator = isRequired != null ? 'icon' : null,\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      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":";;;;;;;;;;;AAsBA,MAAM,gBACJ,oBAAC;CACC,OAAM;CACN,SAAQ;CACR,GAAE;CACF,GAAE;CACF,SAAQ;CACR,OAAO;EAEL,kBAAkB;EAClB,OAAO;EACP,QAAQ;EACR,WAAW;EACZ;WAED,oBAAC,sBACC,oBAAC,iBACC,oBAAC;EACC,MAAK;EACL,QAAO;GACP,GACA,GACG;EACL;;;;;;;;;;;AA6BR,SAAgB,uBAAuB,OAAoC;CACzE,MAAM,EACJ,YAIA,qBAAqB,cAAc,OAAO,SAAS,MACnD,+CAA+C,UAC7C;CACJ,MAAM,EAAE,MAAM,SAAS;CAEvB,MAAM,gBAAgB,EAAE,iBAAiB,aAAa;CAItD,MAAM,YAAY;AAElB,KAAI,uBAAuB,QAAQ;AACjC,MAAI,CAAC,WAAY,QAAO;AAExB,SACE,8CACG,WACD,oBAAC;GACC,cACE,+CACI,gBACA;aAGL;IACI,IACN;;AAIP,KAAI,uBAAuB,QAAS,QAAO;AAK3C,QACE,8CACG,WACD,oBAAC;EACC,eACE,CAAC,+CAA+C,aAAa;YAG9D,aAAa,gBAAgB,EAAE,iBAAiB,aAAa;GACzD,IACN;;AAIP,MAAa,sBAA8B;CACzC,QAAQ;CACR,OAAO;EACL,IAAI;EACJ,SAAS;EACV;CACF;AAED,MAAa,eAAuB;CAClC,SAAS;CACT,QAAQ;EACN,IAAI;EACJ,cAAc;EACf;CACD,OAAO;EACL,IAAI;EACJ,SAAS;EACV;CACD,OAAO;EACL,IAAI;EACJ,MAAM;EACN,OAAO;EACR;CACF;AAED,MAAM,eAAe,MAAM;CACzB,IAAI;CACJ,IAAI;CACJ,QAAQ;CACT,CAAC;AAeF,SAAS,MAAM,OAAuB,KAAK;AACzC,SAAQ,iBAAiC,MAAM;CAE/C,MAAM,EAAE,MAAM,SAAS;CAEvB,IAAI,EACF,IACA,IACA,UACA,gBAAgB,OAChB,YACA,qBAAqB,cAAc,OAAO,SAAS,MACnD,+CAA+C,OAC/C,SACA,YACA,WACA,SACA,OAAO,UACP,KAAK,UACL,GAAG,eACD;CAEJ,IAAI,SAAS,aAAa,IAAI;CAE9B,MAAM,SAAS,cAAc,YAAY,iBAAiB;CAE1D,MAAM,OACJ,oBAAC;EACa;EACQ;EAElB;GAEF;AAGJ,QACE,oBAAC;EACC,GAAI,gBAAgB,WAAW;EAC/B,KAAK;EACG;EACR,SAAS,YAAY;EACrB,aAAW;EACX,MAAM;GACJ,MAAM,kBAAkB;GACxB,UAAU;GACV,GAAG,kBAAkB;IAAE;IAAW;IAAS,CAAC;GAC7C;YASA,OAAO,aAAa,WACnB,WAEA,8CACG,UACA,QACA;GAEQ;;AAInB,IAAI,SAAS,WAAW,MAAM;AAE9B,OAAO,cAAc"}

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

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-4616d9b | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-bacd3ad | Cube Dev Team */
 import { LoadingIcon } from "../../../icons/LoadingIcon.js";
 import { hasValidationState } from "./resolve-validation-props.js";
 import { InvalidIcon } from "../../shared/InvalidIcon.js";

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

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-4616d9b | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-bacd3ad | Cube Dev Team */
 //#region src/components/form/validation/resolve-validation-props.ts
 /**
 * Normalizes the validation props of a field into a pair of booleans.

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

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-4616d9b | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-bacd3ad | Cube Dev Team */
 import { useWarn } from "../../../_internal/hooks/use-warn.js";
 import { resolveValidationProps } from "./resolve-validation-props.js";
 

package/dist/components/form/wrapper.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-4616d9b | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-bacd3ad | Cube Dev Team */
 import { mergeProps } from "../../utils/react/mergeProps.js";
 import { FieldWrapper } from "./FieldWrapper/FieldWrapper.js";
 import { jsx } from "react/jsx-runtime";
@@ -9,7 +9,7 @@ import { jsx } from "react/jsx-runtime";
 * Only the field wrapper props are forwarded, so callers can pass their whole props object as is.
 */
 function wrapWithField(component, ref, props) {
-	let { forceField, label, extra, labelPosition = "top", labelStyles, isRequired, isOptional, isDisabled, necessityIndicator, message, messageStyles, description, errorMessage, isInvalid, isValid, labelProps, fieldProps, fieldStyles, requiredMark = true, tooltip, isHidden, labelSuffix } = props;
+	let { forceField, label, extra, labelPosition = "top", labelStyles, isRequired, isDisabled, necessityIndicator, message, messageStyles, description, errorMessage, isInvalid, isValid, labelProps, fieldProps, fieldStyles, requiredMark = true, tooltip, isHidden, labelSuffix } = props;
 	if (!label && !forceField) return component;
 	const mergedFieldProps = fieldStyles ? mergeProps(fieldProps, { styles: fieldStyles }) : fieldProps;
 	const mergedLabelProps = labelStyles ? mergeProps(labelProps, { styles: labelStyles }) : labelProps;
@@ -19,7 +19,6 @@ function wrapWithField(component, ref, props) {
 		extra,
 		labelPosition,
 		isRequired,
-		isOptional,
 		isDisabled,
 		necessityIndicator,
 		labelProps: mergedLabelProps,

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

@@ -1 +1 @@
-{"version":3,"file":"wrapper.js","names":[],"sources":["../../../src/components/form/wrapper.tsx"],"sourcesContent":["import { DOMRef, FocusableRef } from '@react-types/shared';\nimport { BaseProps } from '@tenphi/tasty';\nimport { ReactElement, RefObject } from 'react';\n\nimport { FieldBaseProps, FormBaseProps } from '../../shared/index';\nimport { mergeProps } from '../../utils/react/index';\n\nimport { FieldWrapper } from './FieldWrapper/index';\n\n// `children` is intentionally omitted: the input is passed as `component`, never through props.\ninterface WrapWithFieldProps\n  extends FieldBaseProps,\n    Omit<BaseProps, 'children'>,\n    FormBaseProps {}\n\n/**\n * Wraps an input with the field chrome (label, description, message) when it has a `label` or `forceField`.\n * Only the field wrapper props are forwarded, so callers can pass their whole props object as is.\n */\nexport function wrapWithField<T extends WrapWithFieldProps>(\n  component: ReactElement,\n  ref: RefObject<unknown> | FocusableRef<HTMLElement> | DOMRef<HTMLElement>,\n  props: T,\n) {\n  let {\n    forceField,\n    label,\n    extra,\n    labelPosition = 'top',\n    labelStyles,\n    isRequired,\n    isOptional,\n    isDisabled,\n    necessityIndicator,\n    message,\n    messageStyles,\n    description,\n    errorMessage,\n    isInvalid,\n    isValid,\n    labelProps,\n    fieldProps,\n    fieldStyles,\n    requiredMark = true,\n    tooltip,\n    isHidden,\n    labelSuffix,\n  } = props;\n\n  if (!label && !forceField) {\n    return component;\n  }\n\n  // Merge fieldStyles as shorthand for fieldProps.styles (fieldStyles takes priority)\n  const mergedFieldProps = fieldStyles\n    ? mergeProps(fieldProps, { styles: fieldStyles })\n    : fieldProps;\n\n  // Merge labelStyles as shorthand for labelProps.styles (labelStyles takes priority)\n  const mergedLabelProps = labelStyles\n    ? mergeProps(labelProps, { styles: labelStyles })\n    : labelProps;\n\n  // Remove id from fieldProps to avoid duplication (id should be on the input element, not the field wrapper)\n  const { id: _id, ...fieldPropsWithoutId } = (mergedFieldProps as any) || {};\n\n  return (\n    <FieldWrapper\n      {...{\n        label,\n        extra,\n        labelPosition,\n        isRequired,\n        isOptional,\n        isDisabled,\n        necessityIndicator,\n        labelProps: mergedLabelProps,\n        fieldProps: fieldPropsWithoutId,\n        message,\n        messageStyles,\n        description,\n        errorMessage,\n        isInvalid,\n        isValid,\n        requiredMark,\n        tooltip,\n        isHidden,\n        labelSuffix,\n        Component: component,\n        ref,\n      }}\n    />\n  );\n}\n"],"mappings":";;;;;;;;;;AAmBA,SAAgB,cACd,WACA,KACA,OACA;CACA,IAAI,EACF,YACA,OACA,OACA,gBAAgB,OAChB,aACA,YACA,YACA,YACA,oBACA,SACA,eACA,aACA,cACA,WACA,SACA,YACA,YACA,aACA,eAAe,MACf,SACA,UACA,gBACE;AAEJ,KAAI,CAAC,SAAS,CAAC,WACb,QAAO;CAIT,MAAM,mBAAmB,cACrB,WAAW,YAAY,EAAE,QAAQ,aAAa,CAAC,GAC/C;CAGJ,MAAM,mBAAmB,cACrB,WAAW,YAAY,EAAE,QAAQ,aAAa,CAAC,GAC/C;CAGJ,MAAM,EAAE,IAAI,KAAK,GAAG,wBAAyB,oBAA4B,EAAE;AAE3E,QACE,oBAAC;EAEG;EACA;EACA;EACA;EACA;EACA;EACA;EACA,YAAY;EACZ,YAAY;EACZ;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,WAAW;EACX;GAEF"}
+{"version":3,"file":"wrapper.js","names":[],"sources":["../../../src/components/form/wrapper.tsx"],"sourcesContent":["import { DOMRef, FocusableRef } from '@react-types/shared';\nimport { BaseProps } from '@tenphi/tasty';\nimport { ReactElement, RefObject } from 'react';\n\nimport { FieldBaseProps, FormBaseProps } from '../../shared/index';\nimport { mergeProps } from '../../utils/react/index';\n\nimport { FieldWrapper } from './FieldWrapper/index';\n\n// `children` is intentionally omitted: the input is passed as `component`, never through props.\ninterface WrapWithFieldProps\n  extends FieldBaseProps,\n    Omit<BaseProps, 'children'>,\n    FormBaseProps {}\n\n/**\n * Wraps an input with the field chrome (label, description, message) when it has a `label` or `forceField`.\n * Only the field wrapper props are forwarded, so callers can pass their whole props object as is.\n */\nexport function wrapWithField<T extends WrapWithFieldProps>(\n  component: ReactElement,\n  ref: RefObject<unknown> | FocusableRef<HTMLElement> | DOMRef<HTMLElement>,\n  props: T,\n) {\n  let {\n    forceField,\n    label,\n    extra,\n    labelPosition = 'top',\n    labelStyles,\n    isRequired,\n    isDisabled,\n    necessityIndicator,\n    message,\n    messageStyles,\n    description,\n    errorMessage,\n    isInvalid,\n    isValid,\n    labelProps,\n    fieldProps,\n    fieldStyles,\n    requiredMark = true,\n    tooltip,\n    isHidden,\n    labelSuffix,\n  } = props;\n\n  if (!label && !forceField) {\n    return component;\n  }\n\n  // Merge fieldStyles as shorthand for fieldProps.styles (fieldStyles takes priority)\n  const mergedFieldProps = fieldStyles\n    ? mergeProps(fieldProps, { styles: fieldStyles })\n    : fieldProps;\n\n  // Merge labelStyles as shorthand for labelProps.styles (labelStyles takes priority)\n  const mergedLabelProps = labelStyles\n    ? mergeProps(labelProps, { styles: labelStyles })\n    : labelProps;\n\n  // Remove id from fieldProps to avoid duplication (id should be on the input element, not the field wrapper)\n  const { id: _id, ...fieldPropsWithoutId } = (mergedFieldProps as any) || {};\n\n  return (\n    <FieldWrapper\n      {...{\n        label,\n        extra,\n        labelPosition,\n        isRequired,\n        isDisabled,\n        necessityIndicator,\n        labelProps: mergedLabelProps,\n        fieldProps: fieldPropsWithoutId,\n        message,\n        messageStyles,\n        description,\n        errorMessage,\n        isInvalid,\n        isValid,\n        requiredMark,\n        tooltip,\n        isHidden,\n        labelSuffix,\n        Component: component,\n        ref,\n      }}\n    />\n  );\n}\n"],"mappings":";;;;;;;;;;AAmBA,SAAgB,cACd,WACA,KACA,OACA;CACA,IAAI,EACF,YACA,OACA,OACA,gBAAgB,OAChB,aACA,YACA,YACA,oBACA,SACA,eACA,aACA,cACA,WACA,SACA,YACA,YACA,aACA,eAAe,MACf,SACA,UACA,gBACE;AAEJ,KAAI,CAAC,SAAS,CAAC,WACb,QAAO;CAIT,MAAM,mBAAmB,cACrB,WAAW,YAAY,EAAE,QAAQ,aAAa,CAAC,GAC/C;CAGJ,MAAM,mBAAmB,cACrB,WAAW,YAAY,EAAE,QAAQ,aAAa,CAAC,GAC/C;CAGJ,MAAM,EAAE,IAAI,KAAK,GAAG,wBAAyB,oBAA4B,EAAE;AAE3E,QACE,oBAAC;EAEG;EACA;EACA;EACA;EACA;EACA;EACA,YAAY;EACZ,YAAY;EACZ;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,WAAW;EACX;GAEF"}

package/dist/components/helpers/DisplayTransition/DisplayTransition.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-4616d9b | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-bacd3ad | Cube Dev Team */
 import { useCallback, useLayoutEffect, useRef, useState } from "react";
 
 //#region src/components/helpers/DisplayTransition/DisplayTransition.tsx

package/dist/components/helpers/IconSwitch/IconSwitch.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-4616d9b | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-bacd3ad | Cube Dev Team */
 import { DisplayTransition } from "../DisplayTransition/DisplayTransition.js";
 import { tasty } from "@tenphi/tasty";
 import { isValidElement, useCallback, useLayoutEffect, useRef, useState } from "react";

package/dist/components/layout/Board/Board.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-4616d9b | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-bacd3ad | Cube Dev Team */
 import { extractStyles } from "../../../utils/styles.js";
 import { mergeProps as mergeProps$1 } from "../../../utils/react/mergeProps.js";
 import { useCombinedRefs } from "../../../utils/react/useCombinedRefs.js";
@@ -132,6 +132,7 @@ function BoardInner(props, ref) {
 	const host = useBoardHost();
 	const inheritedGridLines = useBoardGridLines();
 	const aligned = isAligned && !!parentMetrics;
+	const boardDepth = (parentMetrics?.depth ?? -1) + 1;
 	const widgetPropsStyles = useMemo(() => {
 		if (!widgetProps) return void 0;
 		const extracted = extractStyles(widgetProps, CONTAINER_STYLES);
@@ -620,8 +621,9 @@ function BoardInner(props, ref) {
 		colWidth: calcGridColWidth(positionParams),
 		rowHeight: positionParams.rowHeight,
 		margin: positionParams.margin,
-		containerPadding: positionParams.containerPadding
-	}), [positionParams]);
+		containerPadding: positionParams.containerPadding,
+		depth: boardDepth
+	}), [positionParams, boardDepth]);
 	return /* @__PURE__ */ jsx(BoardMetricsContext.Provider, {
 		value: boardMetrics,
 		children: /* @__PURE__ */ jsx(BoardGridLinesContext.Provider, {
@@ -681,6 +683,7 @@ function BoardInner(props, ref) {
 									isResizable: widgetResizable,
 									resizeHandles: handles,
 									resizeGripPlacement: gripPlacement,
+									boardDepth,
 									isAutoHeight: widgetIsAutoHeight,
 									qa: widgetQa,
 									dragCancel: widgetDragCancel,