@central-design-system/components 4.0.0-alpha.4 → 4.0.0-alpha.5

package/dist/es/src/composables/useNested/useNested.js

@@ -10,27 +10,60 @@ import { m as multipleOpenStrategy, s as singleOpenStrategy, l as listOpenStrate
 import { c as classicSelectStrategy, b as branchSelectStrategy, t as trunkSelectStrategy, i as independentSingleSelectStrategy, a as independentSelectStrategy, l as leafSelectStrategy, d as leafSingleSelectStrategy } from "./strategies/selectStrategies.js";
 const defineNestedProps = propsFactory(
   {
-    /** Разрешает активацию элементов (выделение текущего элемента без режима выбора) */
+    /**
+     * Разрешает активацию элементов (выделение текущего элемента без режима выбора)
+     * @en Allows items to be activated (highlighting the current item without selection mode)
+     */
     activatable: Boolean,
-    /** Разрешает выбор элементов */
+    /**
+     * Разрешает выбор элементов
+     * @en Allows items to be selected
+     */
     selectable: Boolean,
-    /** Стратегия активации элементов (одиночная, множественная и т.д.) */
+    /**
+     * Стратегия активации элементов (одиночная, множественная и т.д.)
+     * @en Activation strategy for items (single, multiple, and so on)
+     */
     activeStrategy: [String, Function, Object],
-    /** Стратегия выбора элементов (`single-leaf`, `leaf`, `independent`, `classic` и т.д.) */
+    /**
+     * Стратегия выбора элементов (`single-leaf`, `leaf`, `independent`, `classic` и т.д.)
+     * @en Selection strategy for items (`single-leaf`, `leaf`, `independent`, `classic`, and so on)
+     */
     selectStrategy: [String, Function, Object],
-    /** Стратегия раскрытия групп (`list`, `single`, `multiple`) */
+    /**
+     * Стратегия раскрытия групп (`list`, `single`, `multiple`)
+     * @en Expansion strategy for groups (`list`, `single`, `multiple`)
+     */
     openStrategy: [String, Object],
-    /** Идентификаторы раскрытых групп (поддерживает v-model через `update:opened`) */
+    /**
+     * Идентификаторы раскрытых групп (поддерживает v-model через `update:opened`)
+     * @en Identifiers of the expanded groups (supports v-model through `update:opened`)
+     */
     opened: null,
-    /** Идентификаторы активных элементов (поддерживает v-model через `update:activated`) */
+    /**
+     * Идентификаторы активных элементов (поддерживает v-model через `update:activated`)
+     * @en Identifiers of the active items (supports v-model through `update:activated`)
+     */
     activated: null,
-    /** Идентификаторы выбранных элементов (поддерживает v-model через `update:selected`) */
+    /**
+     * Идентификаторы выбранных элементов (поддерживает v-model через `update:selected`)
+     * @en Identifiers of the selected items (supports v-model through `update:selected`)
+     */
     selected: null,
-    /** Делает выбор обязательным: запрещает снимать выбор с последнего элемента */
+    /**
+     * Делает выбор обязательным: запрещает снимать выбор с последнего элемента
+     * @en Makes the selection mandatory: forbids clearing the selection of the last item
+     */
     mandatory: Boolean,
-    /** Делает выбор обязательным: запрещает снимать выбор с последнего элемента */
+    /**
+     * Делает выбор обязательным: запрещает снимать выбор с последнего элемента
+     * @en Makes the selection mandatory: forbids clearing the selection of the last item
+     */
     required: Boolean,
-    /** Стратегия регистрации элементов: `render` — по мере рендеринга, иначе единоразово */
+    /**
+     * Стратегия регистрации элементов: `render` — по мере рендеринга, иначе единоразово
+     * @en Item registration strategy: `render` — as they are rendered, otherwise all at once
+     */
     itemsRegistration: {
       type: String,
       default: "render"

package/dist/es/src/composables/useNested/useNested.js.map

@@ -1 +1 @@
-{"version":3,"file":"useNested.js","sources":["../../../../../src/composables/useNested/useNested.ts"],"sourcesContent":["import type { ListItem } from '@cds/composables/useItems';\nimport { getCurrentInstance, propsFactory, useProxyModel } from '@cds/core';\nimport { error, throttle } from '@cds/utils';\nimport {\n  computed,\n  type ExtractPublicPropTypes,\n  inject,\n  type MaybeRefOrGetter,\n  nextTick,\n  onBeforeMount,\n  onBeforeUnmount,\n  type PropType,\n  provide,\n  type Ref,\n  shallowRef,\n  toRaw,\n  toRef,\n  toValue,\n  unref,\n  watch\n} from 'vue';\n\nimport { CdsNestedSymbol, emptyNested } from './internal/useNested.constants';\nimport type {\n  ActiveStrategyProp,\n  ItemsRegistrationType,\n  NestedProvide,\n  OpenStrategyProp,\n  SelectStrategyProp\n} from './internal/useNested.types';\nimport {\n  independentActiveStrategy,\n  independentSingleActiveStrategy,\n  leafActiveStrategy,\n  leafSingleActiveStrategy\n} from './strategies/activeStrategies';\nimport { listOpenStrategy, multipleOpenStrategy, singleOpenStrategy } from './strategies/openStrategies';\nimport {\n  branchSelectStrategy,\n  classicSelectStrategy,\n  independentSelectStrategy,\n  independentSingleSelectStrategy,\n  leafSelectStrategy,\n  leafSingleSelectStrategy,\n  trunkSelectStrategy\n} from './strategies/selectStrategies';\n\nexport const defineNestedProps = propsFactory(\n  {\n    /** Разрешает активацию элементов (выделение текущего элемента без режима выбора) */\n    activatable: Boolean,\n    /** Разрешает выбор элементов */\n    selectable: Boolean,\n    /** Стратегия активации элементов (одиночная, множественная и т.д.) */\n    activeStrategy: [String, Function, Object] as PropType<ActiveStrategyProp>,\n    /** Стратегия выбора элементов (`single-leaf`, `leaf`, `independent`, `classic` и т.д.) */\n    selectStrategy: [String, Function, Object] as PropType<SelectStrategyProp>,\n    /** Стратегия раскрытия групп (`list`, `single`, `multiple`) */\n    openStrategy: [String, Object] as PropType<OpenStrategyProp>,\n    /** Идентификаторы раскрытых групп (поддерживает v-model через `update:opened`) */\n    opened: null,\n    /** Идентификаторы активных элементов (поддерживает v-model через `update:activated`) */\n    activated: null,\n    /** Идентификаторы выбранных элементов (поддерживает v-model через `update:selected`) */\n    selected: null,\n    /** Делает выбор обязательным: запрещает снимать выбор с последнего элемента */\n    mandatory: Boolean,\n    /** Делает выбор обязательным: запрещает снимать выбор с последнего элемента */\n    required: Boolean,\n    /** Стратегия регистрации элементов: `render` — по мере рендеринга, иначе единоразово */\n    itemsRegistration: {\n      type: String as PropType<ItemsRegistrationType>,\n      default: 'render'\n    }\n  },\n  'nested'\n);\n\nexport interface NestedProps extends ExtractPublicPropTypes<ReturnType<typeof defineNestedProps>> {}\n\n/**\n * Provides functionality to manage nested structures of items, including operations like activation, selection,\n * and opening or collapsing sub-items. It handles interactions with hierarchical data structures and maintains\n * internal mappings for children, parents, and disabled states of items.\n *\n * @param {NestedProps} props - Properties that define the nested behavior and configurations.\n * @param {Object} param1 - Additional configuration options.\n * @param {Ref<ListItem[]>} param1.items - Reactive reference to the list of items in the nested structure.\n * @param {MaybeRefOrGetter<boolean>} param1.returnObject - Controls whether the item raw object or its value is returned.\n * @param {MaybeRefOrGetter<boolean>} param1.scrollToActive - Determines if the nested structure should scroll to the active item.\n * @return {NestedProvide} - An object containing methods and properties to manage nested items, including registration,\n * unregistration, and updating states like selection or opening.\n */\nexport function useNested(\n  props: NestedProps,\n  {\n    items,\n    returnObject,\n    scrollToActive\n  }: {\n    items: Ref<ListItem[]>;\n    returnObject: MaybeRefOrGetter<boolean>;\n    scrollToActive: MaybeRefOrGetter<boolean>;\n  }\n) {\n  let isUnmounted = false;\n  const children = shallowRef(new Map<unknown, unknown[]>());\n  const parents = shallowRef(new Map<unknown, unknown>());\n  const disabled = shallowRef(new Set<unknown>());\n\n  const vm = getCurrentInstance('nested');\n\n  const opened = useProxyModel(\n    props,\n    'opened',\n    props.opened,\n    (value) => new Set(Array.isArray(value) ? value.map((item) => toRaw(item)) : value),\n    (value) => [...value.values()]\n  );\n\n  const activeStrategy = computed(() => {\n    if (typeof props.activeStrategy === 'object') return props.activeStrategy;\n    if (typeof props.activeStrategy === 'function') return props.activeStrategy(props.mandatory);\n\n    switch (props.activeStrategy) {\n      case 'leaf':\n        return leafActiveStrategy(props.mandatory);\n      case 'single-leaf':\n        return leafSingleActiveStrategy(props.mandatory);\n      case 'independent':\n        return independentActiveStrategy(props.mandatory);\n      case 'single-independent':\n      default:\n        return independentSingleActiveStrategy(props.mandatory);\n    }\n  });\n\n  const selectStrategy = computed(() => {\n    if (typeof props.selectStrategy === 'object') return props.selectStrategy;\n    if (typeof props.selectStrategy === 'function') return props.selectStrategy(props.mandatory);\n\n    switch (props.selectStrategy) {\n      case 'single-leaf':\n        return leafSingleSelectStrategy(props.mandatory);\n      case 'leaf':\n        return leafSelectStrategy(props.mandatory);\n      case 'independent':\n        return independentSelectStrategy(props.mandatory);\n      case 'single-independent':\n        return independentSingleSelectStrategy(props.mandatory);\n      case 'trunk':\n        return trunkSelectStrategy(props.mandatory);\n      case 'branch':\n        return branchSelectStrategy(props.mandatory);\n      case 'classic':\n      default:\n        return classicSelectStrategy(props.mandatory);\n    }\n  });\n\n  const openStrategy = computed(() => {\n    if (typeof props.openStrategy === 'object') return props.openStrategy;\n\n    switch (props.openStrategy) {\n      case 'list':\n        return listOpenStrategy;\n      case 'single':\n        return singleOpenStrategy;\n      case 'multiple':\n      default:\n        return multipleOpenStrategy;\n    }\n  });\n\n  const activated = useProxyModel(\n    props,\n    'activated',\n    props.activated,\n    (value) => unref(activeStrategy).in(value, unref(children), unref(parents)),\n    (value) => unref(activeStrategy).out(value, unref(children), unref(parents))\n  );\n  const selected = useProxyModel(\n    props,\n    'selected',\n    props.selected,\n    (value) => unref(selectStrategy).in(value, unref(children), unref(parents), unref(disabled)),\n    (value) => unref(selectStrategy).out(value, unref(children), unref(parents))\n  );\n\n  onBeforeUnmount(() => {\n    isUnmounted = true;\n  });\n\n  const nodeIds = new Set<unknown>();\n\n  const itemsUpdatePropagation = throttle(() => {\n    nextTick(() => {\n      children.value = new Map(children.value);\n      parents.value = new Map(parents.value);\n    });\n  }, 100);\n\n  watch(\n    () => [items.value, toValue(returnObject)],\n    () => {\n      if (props.itemsRegistration === 'props') {\n        updateInternalMaps();\n      }\n    },\n    { immediate: true }\n  );\n\n  function getPath(id: unknown) {\n    const path: unknown[] = [];\n    let parent: unknown = toRaw(id);\n\n    while (parent !== undefined) {\n      path.unshift(parent);\n      parent = parents.value.get(parent);\n    }\n\n    return path;\n  }\n\n  function updateInternalMaps() {\n    const _parents = new Map();\n    const _children = new Map();\n    const _disabled = new Set();\n\n    const getValue = toValue(returnObject) ? (item: ListItem) => toRaw(item.raw) : (item: ListItem) => item.value;\n\n    const stack = [...items.value];\n    let i = 0;\n    while (i < stack.length) {\n      const item = stack[i++];\n      const itemValue = getValue(item);\n\n      if (item.children) {\n        const childValues = [];\n        for (const child of item.children) {\n          const childValue = getValue(child);\n          _parents.set(childValue, itemValue);\n          childValues.push(childValue);\n          stack.push(child);\n        }\n        _children.set(itemValue, childValues);\n      }\n\n      if (item.props.disabled) {\n        _disabled.add(itemValue);\n      }\n    }\n\n    children.value = _children;\n    parents.value = _parents;\n    disabled.value = _disabled;\n  }\n\n  const nested: NestedProvide = {\n    id: shallowRef(),\n    root: {\n      opened,\n      activatable: toRef(() => props.activatable),\n      scrollToActive: toRef(() => toValue(scrollToActive)),\n      selectable: toRef(() => props.selectable),\n      activated,\n      selected,\n      selectedValues: computed(() => {\n        const arr = [];\n\n        for (const [key, value] of selected.value.entries()) {\n          if (value === 'on') arr.push(key);\n        }\n\n        return arr;\n      }),\n      itemsRegistration: toRef(() => props.itemsRegistration),\n      register: (id, parentId, isDisabled, isGroup) => {\n        if (nodeIds.has(id)) {\n          const path = getPath(id).map(String).join(' -> ');\n          const newPath = getPath(parentId).concat(id).map(String).join(' -> ');\n          error(`Multiple nodes with the same ID\\n\\t${path}\\n\\t${newPath}`);\n          return;\n        } else {\n          nodeIds.add(id);\n        }\n\n        parentId && id !== parentId && parents.value.set(id, parentId);\n\n        isDisabled && disabled.value.add(id);\n        isGroup && children.value.set(id, []);\n\n        if (parentId != null) {\n          children.value.set(parentId, [...(children.value.get(parentId) || []), id]);\n        }\n        itemsUpdatePropagation();\n      },\n      unregister: (id) => {\n        if (isUnmounted) return;\n\n        nodeIds.delete(id);\n        children.value.delete(id);\n        disabled.value.delete(id);\n        const parent = parents.value.get(id);\n        if (parent) {\n          const list = children.value.get(parent) ?? [];\n          children.value.set(\n            parent,\n            list.filter((child) => child !== id)\n          );\n        }\n        parents.value.delete(id);\n        itemsUpdatePropagation();\n      },\n      updateDisabled: (id, isDisabled) => {\n        if (isDisabled) {\n          disabled.value.add(id);\n        } else {\n          disabled.value.delete(id);\n        }\n        // classic selection requires refresh to re-evaluate on/off/indeterminate but\n        // currently it is only run for selection interactions, so it will set new disabled\n        // to \"off\" and the visual state becomes out of sync\n        // -- selected.value = new Map(selected.value)\n        // it is not clear if the framework should un-select when disabled changed to true\n        // more discussion is needed\n      },\n      open: (id, value, event) => {\n        vm.emit('click:open', { id, value, path: getPath(id), event });\n\n        const newOpened = openStrategy.value.open({\n          id,\n          value,\n          opened: new Set(opened.value),\n          children: children.value,\n          parents: parents.value,\n          event\n        });\n\n        newOpened && (opened.value = newOpened);\n      },\n      openOnSelect: (id, value, event) => {\n        const newOpened = openStrategy.value.select({\n          id,\n          value,\n          selected: new Map(selected.value),\n          opened: new Set(opened.value),\n          children: children.value,\n          parents: parents.value,\n          event\n        });\n        newOpened && (opened.value = newOpened);\n      },\n      select: (id, value, event) => {\n        vm.emit('click:select', { id, value, path: getPath(id), event });\n\n        const newSelected = selectStrategy.value.select({\n          id,\n          value,\n          selected: new Map(selected.value),\n          children: children.value,\n          parents: parents.value,\n          disabled: disabled.value,\n          event\n        });\n        newSelected && (selected.value = newSelected);\n\n        nested.root.openOnSelect(id, value, event);\n      },\n      activate: (id, value, event) => {\n        if (!props.activatable) {\n          return nested.root.select(id, true, event);\n        }\n\n        vm.emit('click:activate', { id, value, path: getPath(id), event });\n\n        const newActivated = activeStrategy.value.activate({\n          id,\n          value,\n          activated: new Set(activated.value),\n          children: children.value,\n          parents: parents.value,\n          event\n        });\n\n        if (newActivated.size !== activated.value.size) {\n          activated.value = newActivated;\n        } else {\n          for (const value of newActivated) {\n            if (!activated.value.has(value)) {\n              activated.value = newActivated;\n              return;\n            }\n          }\n          for (const value of activated.value) {\n            if (!newActivated.has(value)) {\n              activated.value = newActivated;\n              return;\n            }\n          }\n        }\n      },\n      children,\n      parents,\n      disabled,\n      getPath\n    }\n  };\n\n  provide(CdsNestedSymbol, nested);\n\n  return nested.root;\n}\n\n/**\n * Function `useNestedItem` provides a mechanism to manage and interact with a nested item in a hierarchical structure.\n * This function is designed to work within a system dependent on reactivity and provides integration with a parent context.\n *\n * @param {MaybeRefOrGetter<unknown>} id - A unique identifier for the nested item. It can be a reactive reference, a getter, or a raw value.\n * @param {MaybeRefOrGetter<boolean>} isDisabled - A flag indicating whether the nested item is disabled. It supports reactivity.\n * @param {boolean} isGroup - A boolean value specifying if the nested item acts as a group parent.\n * @returns {Object} - Returns an item object containing reactive properties and methods to interact with the nested item and its hierarchy.\n *\n * Reactive State and Methods:\n * - `id`: The unique identifier of the nested item, resolved reactively.\n * - `open(open: boolean, e: Event)`: Toggles the open state for this item.\n * - `openOnSelect(open: boolean, e?: Event)`: Toggles the open state based on selection changes.\n * - `isOpen`: A computed property reflecting whether the item is currently open.\n * - `parent`: A computed property referring to the item's immediate parent in the hierarchy.\n * - `activate(activated: boolean, e?: Event)`: Activates or deactivates the item.\n * - `isActivated`: A computed property reflecting whether the item is currently activated.\n * - `scrollToActive`: Scrolls to the active item in the hierarchy.\n * - `select(selected: boolean, e?: Event)`: Selects or deselects the item.\n * - `isSelected`: A computed property indicating if the item is selected.\n * - `isIndeterminate`: A computed property indicating if the item selection is in an indeterminate state.\n * - `isLeaf`: A computed property indicating if the item is a leaf node (i.e., without children).\n * - `isGroupActivator`: A flag inherited from the parent, used for group-specific activation.\n *\n * Lifecycle Management:\n * - Registers the nested item with its parent context upon mounting unless `isGroupActivator` or specific parent configuration prevents registration.\n * - Unregisters the nested item from its parent context upon unmounting unless `isGroupActivator` or specific parent configuration prevents it.\n * - Tracks updates to `id` or `isDisabled` and notifies the parent context to ensure consistency.\n *\n * Dependency Injection:\n * - Injects a parent context using the symbol `CdsNestedSymbol`.\n * - Provides the current item to descendant contexts if `isGroup` is true.\n */\nexport const useNestedItem = (\n  id: MaybeRefOrGetter<unknown>,\n  isDisabled: MaybeRefOrGetter<boolean>,\n  isGroup: boolean\n) => {\n  const parent = inject(CdsNestedSymbol, emptyNested);\n\n  const uidSymbol = Symbol('nested item');\n  const computedId = computed(() => {\n    const idValue = toRaw(toValue(id));\n    return idValue !== undefined ? idValue : uidSymbol;\n  });\n\n  const item = {\n    ...parent,\n    id: computedId,\n    open: (open: boolean, e: Event) => parent.root.open(computedId.value, open, e),\n    openOnSelect: (open: boolean, e?: Event) => parent.root.openOnSelect(computedId.value, open, e),\n    isOpen: computed(() => parent.root.opened.value.has(computedId.value)),\n    parent: computed(() => parent.root.parents.value.get(computedId.value)),\n    activate: (activated: boolean, e?: Event) => parent.root.activate(computedId.value, activated, e),\n    isActivated: computed(() => parent.root.activated.value.has(computedId.value)),\n    scrollToActive: parent.root.scrollToActive,\n    select: (selected: boolean, e?: Event) => parent.root.select(computedId.value, selected, e),\n    isSelected: computed(() => parent.root.selected.value.get(computedId.value) === 'on'),\n    isIndeterminate: computed(() => parent.root.selected.value.get(computedId.value) === 'indeterminate'),\n    isLeaf: computed(() => !parent.root.children.value.get(computedId.value)),\n    isGroupActivator: parent.isGroupActivator\n  };\n\n  onBeforeMount(() => {\n    if (parent.isGroupActivator || parent.root.itemsRegistration.value === 'props') return;\n    nextTick(() => {\n      parent.root.register(computedId.value, parent.id.value, toValue(isDisabled), isGroup);\n    });\n  });\n\n  onBeforeUnmount(() => {\n    if (parent.isGroupActivator || parent.root.itemsRegistration.value === 'props') return;\n    parent.root.unregister(computedId.value);\n  });\n\n  watch(computedId, (val, oldVal) => {\n    if (parent.isGroupActivator || parent.root.itemsRegistration.value === 'props') return;\n    parent.root.unregister(oldVal);\n    nextTick(() => {\n      parent.root.register(val, parent.id.value, toValue(isDisabled), isGroup);\n    });\n  });\n\n  watch(\n    () => toValue(isDisabled),\n    (val) => {\n      parent.root.updateDisabled(computedId.value, val);\n    }\n  );\n\n  isGroup && provide(CdsNestedSymbol, item);\n\n  return item;\n};\n\n/**\n * A composable function that sets up and provides a nested group activator context.\n *\n * This function injects the current context associated with the CdsNestedSymbol and merges it with a\n * new property `isGroupActivator` set to `true`. The updated context is provided back\n * for nested components to access. This is typically used in hierarchical component structures\n * to activate nested group functionality.\n *\n * Dependencies:\n * - `inject` is used to retrieve the parent context of the CdsNestedSymbol.\n * - `provide` is used to supply the updated context to the component tree.\n *\n * Context Symbols:\n * - `CdsNestedSymbol` represents the unique symbol key used for nested data manipulation.\n * - `emptyNested` is the default context provided when no parent context is available.\n */\nexport const useNestedGroupActivator = () => {\n  const parent = inject(CdsNestedSymbol, emptyNested);\n\n  provide(CdsNestedSymbol, { ...parent, isGroupActivator: true });\n};\n"],"names":["value"],"mappings":"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"}
+{"version":3,"file":"useNested.js","sources":["../../../../../src/composables/useNested/useNested.ts"],"sourcesContent":["import type { ListItem } from '@cds/composables/useItems';\nimport { getCurrentInstance, propsFactory, useProxyModel } from '@cds/core';\nimport { error, throttle } from '@cds/utils';\nimport {\n  computed,\n  type ExtractPublicPropTypes,\n  inject,\n  type MaybeRefOrGetter,\n  nextTick,\n  onBeforeMount,\n  onBeforeUnmount,\n  type PropType,\n  provide,\n  type Ref,\n  shallowRef,\n  toRaw,\n  toRef,\n  toValue,\n  unref,\n  watch\n} from 'vue';\n\nimport { CdsNestedSymbol, emptyNested } from './internal/useNested.constants';\nimport type {\n  ActiveStrategyProp,\n  ItemsRegistrationType,\n  NestedProvide,\n  OpenStrategyProp,\n  SelectStrategyProp\n} from './internal/useNested.types';\nimport {\n  independentActiveStrategy,\n  independentSingleActiveStrategy,\n  leafActiveStrategy,\n  leafSingleActiveStrategy\n} from './strategies/activeStrategies';\nimport { listOpenStrategy, multipleOpenStrategy, singleOpenStrategy } from './strategies/openStrategies';\nimport {\n  branchSelectStrategy,\n  classicSelectStrategy,\n  independentSelectStrategy,\n  independentSingleSelectStrategy,\n  leafSelectStrategy,\n  leafSingleSelectStrategy,\n  trunkSelectStrategy\n} from './strategies/selectStrategies';\n\nexport const defineNestedProps = propsFactory(\n  {\n    /**\n     * Разрешает активацию элементов (выделение текущего элемента без режима выбора)\n     * @en Allows items to be activated (highlighting the current item without selection mode)\n     */\n    activatable: Boolean,\n    /**\n     * Разрешает выбор элементов\n     * @en Allows items to be selected\n     */\n    selectable: Boolean,\n    /**\n     * Стратегия активации элементов (одиночная, множественная и т.д.)\n     * @en Activation strategy for items (single, multiple, and so on)\n     */\n    activeStrategy: [String, Function, Object] as PropType<ActiveStrategyProp>,\n    /**\n     * Стратегия выбора элементов (`single-leaf`, `leaf`, `independent`, `classic` и т.д.)\n     * @en Selection strategy for items (`single-leaf`, `leaf`, `independent`, `classic`, and so on)\n     */\n    selectStrategy: [String, Function, Object] as PropType<SelectStrategyProp>,\n    /**\n     * Стратегия раскрытия групп (`list`, `single`, `multiple`)\n     * @en Expansion strategy for groups (`list`, `single`, `multiple`)\n     */\n    openStrategy: [String, Object] as PropType<OpenStrategyProp>,\n    /**\n     * Идентификаторы раскрытых групп (поддерживает v-model через `update:opened`)\n     * @en Identifiers of the expanded groups (supports v-model through `update:opened`)\n     */\n    opened: null,\n    /**\n     * Идентификаторы активных элементов (поддерживает v-model через `update:activated`)\n     * @en Identifiers of the active items (supports v-model through `update:activated`)\n     */\n    activated: null,\n    /**\n     * Идентификаторы выбранных элементов (поддерживает v-model через `update:selected`)\n     * @en Identifiers of the selected items (supports v-model through `update:selected`)\n     */\n    selected: null,\n    /**\n     * Делает выбор обязательным: запрещает снимать выбор с последнего элемента\n     * @en Makes the selection mandatory: forbids clearing the selection of the last item\n     */\n    mandatory: Boolean,\n    /**\n     * Делает выбор обязательным: запрещает снимать выбор с последнего элемента\n     * @en Makes the selection mandatory: forbids clearing the selection of the last item\n     */\n    required: Boolean,\n    /**\n     * Стратегия регистрации элементов: `render` — по мере рендеринга, иначе единоразово\n     * @en Item registration strategy: `render` — as they are rendered, otherwise all at once\n     */\n    itemsRegistration: {\n      type: String as PropType<ItemsRegistrationType>,\n      default: 'render'\n    }\n  },\n  'nested'\n);\n\nexport interface NestedProps extends ExtractPublicPropTypes<ReturnType<typeof defineNestedProps>> {}\n\n/**\n * Provides functionality to manage nested structures of items, including operations like activation, selection,\n * and opening or collapsing sub-items. It handles interactions with hierarchical data structures and maintains\n * internal mappings for children, parents, and disabled states of items.\n *\n * @param {NestedProps} props - Properties that define the nested behavior and configurations.\n * @param {Object} param1 - Additional configuration options.\n * @param {Ref<ListItem[]>} param1.items - Reactive reference to the list of items in the nested structure.\n * @param {MaybeRefOrGetter<boolean>} param1.returnObject - Controls whether the item raw object or its value is returned.\n * @param {MaybeRefOrGetter<boolean>} param1.scrollToActive - Determines if the nested structure should scroll to the active item.\n * @return {NestedProvide} - An object containing methods and properties to manage nested items, including registration,\n * unregistration, and updating states like selection or opening.\n */\nexport function useNested(\n  props: NestedProps,\n  {\n    items,\n    returnObject,\n    scrollToActive\n  }: {\n    items: Ref<ListItem[]>;\n    returnObject: MaybeRefOrGetter<boolean>;\n    scrollToActive: MaybeRefOrGetter<boolean>;\n  }\n) {\n  let isUnmounted = false;\n  const children = shallowRef(new Map<unknown, unknown[]>());\n  const parents = shallowRef(new Map<unknown, unknown>());\n  const disabled = shallowRef(new Set<unknown>());\n\n  const vm = getCurrentInstance('nested');\n\n  const opened = useProxyModel(\n    props,\n    'opened',\n    props.opened,\n    (value) => new Set(Array.isArray(value) ? value.map((item) => toRaw(item)) : value),\n    (value) => [...value.values()]\n  );\n\n  const activeStrategy = computed(() => {\n    if (typeof props.activeStrategy === 'object') return props.activeStrategy;\n    if (typeof props.activeStrategy === 'function') return props.activeStrategy(props.mandatory);\n\n    switch (props.activeStrategy) {\n      case 'leaf':\n        return leafActiveStrategy(props.mandatory);\n      case 'single-leaf':\n        return leafSingleActiveStrategy(props.mandatory);\n      case 'independent':\n        return independentActiveStrategy(props.mandatory);\n      case 'single-independent':\n      default:\n        return independentSingleActiveStrategy(props.mandatory);\n    }\n  });\n\n  const selectStrategy = computed(() => {\n    if (typeof props.selectStrategy === 'object') return props.selectStrategy;\n    if (typeof props.selectStrategy === 'function') return props.selectStrategy(props.mandatory);\n\n    switch (props.selectStrategy) {\n      case 'single-leaf':\n        return leafSingleSelectStrategy(props.mandatory);\n      case 'leaf':\n        return leafSelectStrategy(props.mandatory);\n      case 'independent':\n        return independentSelectStrategy(props.mandatory);\n      case 'single-independent':\n        return independentSingleSelectStrategy(props.mandatory);\n      case 'trunk':\n        return trunkSelectStrategy(props.mandatory);\n      case 'branch':\n        return branchSelectStrategy(props.mandatory);\n      case 'classic':\n      default:\n        return classicSelectStrategy(props.mandatory);\n    }\n  });\n\n  const openStrategy = computed(() => {\n    if (typeof props.openStrategy === 'object') return props.openStrategy;\n\n    switch (props.openStrategy) {\n      case 'list':\n        return listOpenStrategy;\n      case 'single':\n        return singleOpenStrategy;\n      case 'multiple':\n      default:\n        return multipleOpenStrategy;\n    }\n  });\n\n  const activated = useProxyModel(\n    props,\n    'activated',\n    props.activated,\n    (value) => unref(activeStrategy).in(value, unref(children), unref(parents)),\n    (value) => unref(activeStrategy).out(value, unref(children), unref(parents))\n  );\n  const selected = useProxyModel(\n    props,\n    'selected',\n    props.selected,\n    (value) => unref(selectStrategy).in(value, unref(children), unref(parents), unref(disabled)),\n    (value) => unref(selectStrategy).out(value, unref(children), unref(parents))\n  );\n\n  onBeforeUnmount(() => {\n    isUnmounted = true;\n  });\n\n  const nodeIds = new Set<unknown>();\n\n  const itemsUpdatePropagation = throttle(() => {\n    nextTick(() => {\n      children.value = new Map(children.value);\n      parents.value = new Map(parents.value);\n    });\n  }, 100);\n\n  watch(\n    () => [items.value, toValue(returnObject)],\n    () => {\n      if (props.itemsRegistration === 'props') {\n        updateInternalMaps();\n      }\n    },\n    { immediate: true }\n  );\n\n  function getPath(id: unknown) {\n    const path: unknown[] = [];\n    let parent: unknown = toRaw(id);\n\n    while (parent !== undefined) {\n      path.unshift(parent);\n      parent = parents.value.get(parent);\n    }\n\n    return path;\n  }\n\n  function updateInternalMaps() {\n    const _parents = new Map();\n    const _children = new Map();\n    const _disabled = new Set();\n\n    const getValue = toValue(returnObject) ? (item: ListItem) => toRaw(item.raw) : (item: ListItem) => item.value;\n\n    const stack = [...items.value];\n    let i = 0;\n    while (i < stack.length) {\n      const item = stack[i++];\n      const itemValue = getValue(item);\n\n      if (item.children) {\n        const childValues = [];\n        for (const child of item.children) {\n          const childValue = getValue(child);\n          _parents.set(childValue, itemValue);\n          childValues.push(childValue);\n          stack.push(child);\n        }\n        _children.set(itemValue, childValues);\n      }\n\n      if (item.props.disabled) {\n        _disabled.add(itemValue);\n      }\n    }\n\n    children.value = _children;\n    parents.value = _parents;\n    disabled.value = _disabled;\n  }\n\n  const nested: NestedProvide = {\n    id: shallowRef(),\n    root: {\n      opened,\n      activatable: toRef(() => props.activatable),\n      scrollToActive: toRef(() => toValue(scrollToActive)),\n      selectable: toRef(() => props.selectable),\n      activated,\n      selected,\n      selectedValues: computed(() => {\n        const arr = [];\n\n        for (const [key, value] of selected.value.entries()) {\n          if (value === 'on') arr.push(key);\n        }\n\n        return arr;\n      }),\n      itemsRegistration: toRef(() => props.itemsRegistration),\n      register: (id, parentId, isDisabled, isGroup) => {\n        if (nodeIds.has(id)) {\n          const path = getPath(id).map(String).join(' -> ');\n          const newPath = getPath(parentId).concat(id).map(String).join(' -> ');\n          error(`Multiple nodes with the same ID\\n\\t${path}\\n\\t${newPath}`);\n          return;\n        } else {\n          nodeIds.add(id);\n        }\n\n        parentId && id !== parentId && parents.value.set(id, parentId);\n\n        isDisabled && disabled.value.add(id);\n        isGroup && children.value.set(id, []);\n\n        if (parentId != null) {\n          children.value.set(parentId, [...(children.value.get(parentId) || []), id]);\n        }\n        itemsUpdatePropagation();\n      },\n      unregister: (id) => {\n        if (isUnmounted) return;\n\n        nodeIds.delete(id);\n        children.value.delete(id);\n        disabled.value.delete(id);\n        const parent = parents.value.get(id);\n        if (parent) {\n          const list = children.value.get(parent) ?? [];\n          children.value.set(\n            parent,\n            list.filter((child) => child !== id)\n          );\n        }\n        parents.value.delete(id);\n        itemsUpdatePropagation();\n      },\n      updateDisabled: (id, isDisabled) => {\n        if (isDisabled) {\n          disabled.value.add(id);\n        } else {\n          disabled.value.delete(id);\n        }\n        // classic selection requires refresh to re-evaluate on/off/indeterminate but\n        // currently it is only run for selection interactions, so it will set new disabled\n        // to \"off\" and the visual state becomes out of sync\n        // -- selected.value = new Map(selected.value)\n        // it is not clear if the framework should un-select when disabled changed to true\n        // more discussion is needed\n      },\n      open: (id, value, event) => {\n        vm.emit('click:open', { id, value, path: getPath(id), event });\n\n        const newOpened = openStrategy.value.open({\n          id,\n          value,\n          opened: new Set(opened.value),\n          children: children.value,\n          parents: parents.value,\n          event\n        });\n\n        newOpened && (opened.value = newOpened);\n      },\n      openOnSelect: (id, value, event) => {\n        const newOpened = openStrategy.value.select({\n          id,\n          value,\n          selected: new Map(selected.value),\n          opened: new Set(opened.value),\n          children: children.value,\n          parents: parents.value,\n          event\n        });\n        newOpened && (opened.value = newOpened);\n      },\n      select: (id, value, event) => {\n        vm.emit('click:select', { id, value, path: getPath(id), event });\n\n        const newSelected = selectStrategy.value.select({\n          id,\n          value,\n          selected: new Map(selected.value),\n          children: children.value,\n          parents: parents.value,\n          disabled: disabled.value,\n          event\n        });\n        newSelected && (selected.value = newSelected);\n\n        nested.root.openOnSelect(id, value, event);\n      },\n      activate: (id, value, event) => {\n        if (!props.activatable) {\n          return nested.root.select(id, true, event);\n        }\n\n        vm.emit('click:activate', { id, value, path: getPath(id), event });\n\n        const newActivated = activeStrategy.value.activate({\n          id,\n          value,\n          activated: new Set(activated.value),\n          children: children.value,\n          parents: parents.value,\n          event\n        });\n\n        if (newActivated.size !== activated.value.size) {\n          activated.value = newActivated;\n        } else {\n          for (const value of newActivated) {\n            if (!activated.value.has(value)) {\n              activated.value = newActivated;\n              return;\n            }\n          }\n          for (const value of activated.value) {\n            if (!newActivated.has(value)) {\n              activated.value = newActivated;\n              return;\n            }\n          }\n        }\n      },\n      children,\n      parents,\n      disabled,\n      getPath\n    }\n  };\n\n  provide(CdsNestedSymbol, nested);\n\n  return nested.root;\n}\n\n/**\n * Function `useNestedItem` provides a mechanism to manage and interact with a nested item in a hierarchical structure.\n * This function is designed to work within a system dependent on reactivity and provides integration with a parent context.\n *\n * @param {MaybeRefOrGetter<unknown>} id - A unique identifier for the nested item. It can be a reactive reference, a getter, or a raw value.\n * @param {MaybeRefOrGetter<boolean>} isDisabled - A flag indicating whether the nested item is disabled. It supports reactivity.\n * @param {boolean} isGroup - A boolean value specifying if the nested item acts as a group parent.\n * @returns {Object} - Returns an item object containing reactive properties and methods to interact with the nested item and its hierarchy.\n *\n * Reactive State and Methods:\n * - `id`: The unique identifier of the nested item, resolved reactively.\n * - `open(open: boolean, e: Event)`: Toggles the open state for this item.\n * - `openOnSelect(open: boolean, e?: Event)`: Toggles the open state based on selection changes.\n * - `isOpen`: A computed property reflecting whether the item is currently open.\n * - `parent`: A computed property referring to the item's immediate parent in the hierarchy.\n * - `activate(activated: boolean, e?: Event)`: Activates or deactivates the item.\n * - `isActivated`: A computed property reflecting whether the item is currently activated.\n * - `scrollToActive`: Scrolls to the active item in the hierarchy.\n * - `select(selected: boolean, e?: Event)`: Selects or deselects the item.\n * - `isSelected`: A computed property indicating if the item is selected.\n * - `isIndeterminate`: A computed property indicating if the item selection is in an indeterminate state.\n * - `isLeaf`: A computed property indicating if the item is a leaf node (i.e., without children).\n * - `isGroupActivator`: A flag inherited from the parent, used for group-specific activation.\n *\n * Lifecycle Management:\n * - Registers the nested item with its parent context upon mounting unless `isGroupActivator` or specific parent configuration prevents registration.\n * - Unregisters the nested item from its parent context upon unmounting unless `isGroupActivator` or specific parent configuration prevents it.\n * - Tracks updates to `id` or `isDisabled` and notifies the parent context to ensure consistency.\n *\n * Dependency Injection:\n * - Injects a parent context using the symbol `CdsNestedSymbol`.\n * - Provides the current item to descendant contexts if `isGroup` is true.\n */\nexport const useNestedItem = (\n  id: MaybeRefOrGetter<unknown>,\n  isDisabled: MaybeRefOrGetter<boolean>,\n  isGroup: boolean\n) => {\n  const parent = inject(CdsNestedSymbol, emptyNested);\n\n  const uidSymbol = Symbol('nested item');\n  const computedId = computed(() => {\n    const idValue = toRaw(toValue(id));\n    return idValue !== undefined ? idValue : uidSymbol;\n  });\n\n  const item = {\n    ...parent,\n    id: computedId,\n    open: (open: boolean, e: Event) => parent.root.open(computedId.value, open, e),\n    openOnSelect: (open: boolean, e?: Event) => parent.root.openOnSelect(computedId.value, open, e),\n    isOpen: computed(() => parent.root.opened.value.has(computedId.value)),\n    parent: computed(() => parent.root.parents.value.get(computedId.value)),\n    activate: (activated: boolean, e?: Event) => parent.root.activate(computedId.value, activated, e),\n    isActivated: computed(() => parent.root.activated.value.has(computedId.value)),\n    scrollToActive: parent.root.scrollToActive,\n    select: (selected: boolean, e?: Event) => parent.root.select(computedId.value, selected, e),\n    isSelected: computed(() => parent.root.selected.value.get(computedId.value) === 'on'),\n    isIndeterminate: computed(() => parent.root.selected.value.get(computedId.value) === 'indeterminate'),\n    isLeaf: computed(() => !parent.root.children.value.get(computedId.value)),\n    isGroupActivator: parent.isGroupActivator\n  };\n\n  onBeforeMount(() => {\n    if (parent.isGroupActivator || parent.root.itemsRegistration.value === 'props') return;\n    nextTick(() => {\n      parent.root.register(computedId.value, parent.id.value, toValue(isDisabled), isGroup);\n    });\n  });\n\n  onBeforeUnmount(() => {\n    if (parent.isGroupActivator || parent.root.itemsRegistration.value === 'props') return;\n    parent.root.unregister(computedId.value);\n  });\n\n  watch(computedId, (val, oldVal) => {\n    if (parent.isGroupActivator || parent.root.itemsRegistration.value === 'props') return;\n    parent.root.unregister(oldVal);\n    nextTick(() => {\n      parent.root.register(val, parent.id.value, toValue(isDisabled), isGroup);\n    });\n  });\n\n  watch(\n    () => toValue(isDisabled),\n    (val) => {\n      parent.root.updateDisabled(computedId.value, val);\n    }\n  );\n\n  isGroup && provide(CdsNestedSymbol, item);\n\n  return item;\n};\n\n/**\n * A composable function that sets up and provides a nested group activator context.\n *\n * This function injects the current context associated with the CdsNestedSymbol and merges it with a\n * new property `isGroupActivator` set to `true`. The updated context is provided back\n * for nested components to access. This is typically used in hierarchical component structures\n * to activate nested group functionality.\n *\n * Dependencies:\n * - `inject` is used to retrieve the parent context of the CdsNestedSymbol.\n * - `provide` is used to supply the updated context to the component tree.\n *\n * Context Symbols:\n * - `CdsNestedSymbol` represents the unique symbol key used for nested data manipulation.\n * - `emptyNested` is the default context provided when no parent context is available.\n */\nexport const useNestedGroupActivator = () => {\n  const parent = inject(CdsNestedSymbol, emptyNested);\n\n  provide(CdsNestedSymbol, { ...parent, isGroupActivator: true });\n};\n"],"names":["value"],"mappings":"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"}

package/dist/es/src/composables/usePosition/usePosition.js

@@ -4,6 +4,10 @@ import { toRef } from "vue";
 const positionValues = ["static", "relative", "fixed", "absolute", "sticky"];
 const definePositionProps = propsFactory(
   {
+    /**
+     * CSS-позиционирование компонента — значение свойства `position`
+     * @en CSS positioning of the component — the value of the `position` property
+     */
     position: {
       type: String,
       validator: (v) => positionValues.includes(v)

package/dist/es/src/composables/usePosition/usePosition.js.map

@@ -1 +1 @@
-{"version":3,"file":"usePosition.js","sources":["../../../../../src/composables/usePosition/usePosition.ts"],"sourcesContent":["import { getCurrentInstanceName, propsFactory } from '@cds/core';\nimport { type ExtractPublicPropTypes, type PropType, toRef } from 'vue';\n\nconst positionValues = ['static', 'relative', 'fixed', 'absolute', 'sticky'] as const;\ntype Position = (typeof positionValues)[number];\n\n/**\n * A factory function that defines and creates position-related component props.\n *\n * @constant\n * @type {Object}\n *\n * @property {Object} position - Defines the position property for a component.\n * @property {String} position.type - The expected type of the position property.\n * @property {Function} position.validator - Validates if the provided value for the position property\n *                                           is included in the predefined position values.\n */\nexport const definePositionProps = propsFactory(\n  {\n    position: {\n      type: String as PropType<Position>,\n      validator: (v: any) => positionValues.includes(v)\n    }\n  },\n  'position'\n);\n\nexport interface PositionProps extends ExtractPublicPropTypes<ReturnType<typeof definePositionProps>> {}\n\n/**\n * A custom hook that generates CSS class names based on the provided position property.\n *\n * @param {PositionProps} props - The properties object containing the position property.\n * @param {string} [name=getCurrentInstanceName()] - The base name used for generating the CSS class name.\n * @return {Object} An object containing the computed `positionClasses`.\n */\nexport function usePosition(props: PositionProps, name = getCurrentInstanceName()) {\n  const positionClasses = toRef(() => {\n    return props.position ? `${name}--${props.position}` : undefined;\n  });\n\n  return { positionClasses };\n}\n"],"names":[],"mappings":";;;AAGA,MAAM,iBAAiB,CAAC,UAAU,YAAY,SAAS,YAAY,QAAQ;AAcpE,MAAM,sBAAsB;AAAA,EACjC;AAAA,IACE,UAAU;AAAA,MACR,MAAM;AAAA,MACN,WAAW,CAAC,MAAW,eAAe,SAAS,CAAC;AAAA,IAAA;AAAA,EAClD;AAAA,EAEF;AACF;AAWO,SAAS,YAAY,OAAsB,OAAO,0BAA0B;AACjF,QAAM,kBAAkB,MAAM,MAAM;AAClC,WAAO,MAAM,WAAW,GAAG,IAAI,KAAK,MAAM,QAAQ,KAAK;AAAA,EACzD,CAAC;AAED,SAAO,EAAE,gBAAA;AACX;"}
+{"version":3,"file":"usePosition.js","sources":["../../../../../src/composables/usePosition/usePosition.ts"],"sourcesContent":["import { getCurrentInstanceName, propsFactory } from '@cds/core';\nimport { type ExtractPublicPropTypes, type PropType, toRef } from 'vue';\n\nconst positionValues = ['static', 'relative', 'fixed', 'absolute', 'sticky'] as const;\ntype Position = (typeof positionValues)[number];\n\n/**\n * A factory function that defines and creates position-related component props.\n *\n * @constant\n * @type {Object}\n *\n * @property {Object} position - Defines the position property for a component.\n * @property {String} position.type - The expected type of the position property.\n * @property {Function} position.validator - Validates if the provided value for the position property\n *                                           is included in the predefined position values.\n */\nexport const definePositionProps = propsFactory(\n  {\n    /**\n     * CSS-позиционирование компонента — значение свойства `position`\n     * @en CSS positioning of the component — the value of the `position` property\n     */\n    position: {\n      type: String as PropType<Position>,\n      validator: (v: any) => positionValues.includes(v)\n    }\n  },\n  'position'\n);\n\nexport interface PositionProps extends ExtractPublicPropTypes<ReturnType<typeof definePositionProps>> {}\n\n/**\n * A custom hook that generates CSS class names based on the provided position property.\n *\n * @param {PositionProps} props - The properties object containing the position property.\n * @param {string} [name=getCurrentInstanceName()] - The base name used for generating the CSS class name.\n * @return {Object} An object containing the computed `positionClasses`.\n */\nexport function usePosition(props: PositionProps, name = getCurrentInstanceName()) {\n  const positionClasses = toRef(() => {\n    return props.position ? `${name}--${props.position}` : undefined;\n  });\n\n  return { positionClasses };\n}\n"],"names":[],"mappings":";;;AAGA,MAAM,iBAAiB,CAAC,UAAU,YAAY,SAAS,YAAY,QAAQ;AAcpE,MAAM,sBAAsB;AAAA,EACjC;AAAA;AAAA;AAAA;AAAA;AAAA,IAKE,UAAU;AAAA,MACR,MAAM;AAAA,MACN,WAAW,CAAC,MAAW,eAAe,SAAS,CAAC;AAAA,IAAA;AAAA,EAClD;AAAA,EAEF;AACF;AAWO,SAAS,YAAY,OAAsB,OAAO,0BAA0B;AACjF,QAAM,kBAAkB,MAAM,MAAM;AAClC,WAAO,MAAM,WAAW,GAAG,IAAI,KAAK,MAAM,QAAQ,KAAK;AAAA,EACzD,CAAC;AAED,SAAO,EAAE,gBAAA;AACX;"}

package/dist/es/src/composables/useReadonly/useReadonly.js

@@ -2,7 +2,10 @@ import { p as propsFactory } from "../../core/propsFactory.js";
 import "vue";
 const defineReadonlyProps = propsFactory(
   {
-    /** Только для чтения */
+    /**
+     * Только для чтения
+     * @en Read-only state
+     */
     readonly: {
       type: Boolean,
       default: null

package/dist/es/src/composables/useReadonly/useReadonly.js.map

@@ -1 +1 @@
-{"version":3,"file":"useReadonly.js","sources":["../../../../../src/composables/useReadonly/useReadonly.ts"],"sourcesContent":["import { getCurrentInstanceName, propsFactory } from '@cds/core';\nimport { type ExtractPublicPropTypes, type PropType, toRef, toValue } from 'vue';\n\n/**\n * A factory-generated configuration object for defining a readonly property within a Vue component.\n * This utility creates a `readonly` prop with a Boolean type and a default value set to `false`.\n *\n * The prop is intended to specify whether a component property should be immutable,\n * allowing only read operations.\n *\n * @constant {Object} defineReadonlyProps\n */\nexport const defineReadonlyProps = propsFactory(\n  {\n    /** Только для чтения */\n    readonly: {\n      type: Boolean as PropType<boolean | null>,\n      default: null\n    }\n  },\n  'readonly'\n);\n\nexport type ReadonlyProps = ExtractPublicPropTypes<ReturnType<typeof defineReadonlyProps>>;\n\nexport function useReadonly(props: ReadonlyProps, name = getCurrentInstanceName()) {\n  const readonlyClasses = toRef(() => ({\n    [`${name}--readonly`]: toValue(props).readonly\n  }));\n\n  return { readonlyClasses };\n}\n"],"names":[],"mappings":";;AAYO,MAAM,sBAAsB;AAAA,EACjC;AAAA;AAAA,IAEE,UAAU;AAAA,MACR,MAAM;AAAA,MACN,SAAS;AAAA,IAAA;AAAA,EACX;AAAA,EAEF;AACF;"}
+{"version":3,"file":"useReadonly.js","sources":["../../../../../src/composables/useReadonly/useReadonly.ts"],"sourcesContent":["import { getCurrentInstanceName, propsFactory } from '@cds/core';\nimport { type ExtractPublicPropTypes, type PropType, toRef, toValue } from 'vue';\n\n/**\n * A factory-generated configuration object for defining a readonly property within a Vue component.\n * This utility creates a `readonly` prop with a Boolean type and a default value set to `false`.\n *\n * The prop is intended to specify whether a component property should be immutable,\n * allowing only read operations.\n *\n * @constant {Object} defineReadonlyProps\n */\nexport const defineReadonlyProps = propsFactory(\n  {\n    /**\n     * Только для чтения\n     * @en Read-only state\n     */\n    readonly: {\n      type: Boolean as PropType<boolean | null>,\n      default: null\n    }\n  },\n  'readonly'\n);\n\nexport type ReadonlyProps = ExtractPublicPropTypes<ReturnType<typeof defineReadonlyProps>>;\n\nexport function useReadonly(props: ReadonlyProps, name = getCurrentInstanceName()) {\n  const readonlyClasses = toRef(() => ({\n    [`${name}--readonly`]: toValue(props).readonly\n  }));\n\n  return { readonlyClasses };\n}\n"],"names":[],"mappings":";;AAYO,MAAM,sBAAsB;AAAA,EACjC;AAAA;AAAA;AAAA;AAAA;AAAA,IAKE,UAAU;AAAA,MACR,MAAM;AAAA,MACN,SAAS;AAAA,IAAA;AAAA,EACX;AAAA,EAEF;AACF;"}

package/dist/es/src/composables/useReveal/useReveal.js

@@ -2,7 +2,10 @@ import { p as propsFactory } from "../../core/propsFactory.js";
 import { toRef, shallowRef, onMounted } from "vue";
 const defineRevealProps = propsFactory(
   {
-    /** Анимирует индикатор от нуля до текущего значения при появлении компонента. Объект `{ duration }` задаёт длительность анимации в миллисекундах */
+    /**
+     * Анимирует индикатор от нуля до текущего значения при появлении компонента. Объект `{ duration }` задаёт длительность анимации в миллисекундах
+     * @en Animates the indicator from zero to the current value when the component appears. The `{ duration }` object sets the animation duration in milliseconds
+     */
     reveal: {
       type: [Boolean, Object],
       default: false

package/dist/es/src/composables/useReveal/useReveal.js.map

@@ -1 +1 @@
-{"version":3,"file":"useReveal.js","sources":["../../../../../src/composables/useReveal/useReveal.ts"],"sourcesContent":["import { propsFactory } from '@cds/core';\nimport { onMounted, type PropType, shallowRef, toRef } from 'vue';\n\nexport interface RevealProps {\n  reveal: boolean | { duration?: number };\n}\n\n/**\n * Define the reveal properties for components.\n */\nexport const defineRevealProps = propsFactory(\n  {\n    /** Анимирует индикатор от нуля до текущего значения при появлении компонента. Объект `{ duration }` задаёт длительность анимации в миллисекундах */\n    reveal: {\n      type: [Boolean, Object] as PropType<\n        | boolean\n        | {\n            duration?: number;\n          }\n      >,\n      default: false\n    }\n  },\n  'reveal'\n);\n\nexport function useReveal(props: RevealProps) {\n  const defaultDuration = 900;\n  const duration = toRef(() =>\n    typeof props.reveal === 'object' ? Math.max(0, Number(props.reveal.duration ?? defaultDuration)) : defaultDuration\n  );\n\n  const state = shallowRef(props.reveal ? 'initial' : 'disabled');\n\n  onMounted(async () => {\n    if (props.reveal) {\n      state.value = 'initial';\n      await new Promise((resolve) => requestAnimationFrame(resolve));\n      state.value = 'pending';\n      await new Promise((resolve) => setTimeout(resolve, duration.value));\n      state.value = 'done';\n    }\n  });\n\n  return {\n    duration,\n    state\n  };\n}\n"],"names":[],"mappings":";;AAUO,MAAM,oBAAoB;AAAA,EAC/B;AAAA;AAAA,IAEE,QAAQ;AAAA,MACN,MAAM,CAAC,SAAS,MAAM;AAAA,MAMtB,SAAS;AAAA,IAAA;AAAA,EACX;AAAA,EAEF;AACF;AAEO,SAAS,UAAU,OAAoB;AAC5C,QAAM,kBAAkB;AACxB,QAAM,WAAW;AAAA,IAAM,MACrB,OAAO,MAAM,WAAW,WAAW,KAAK,IAAI,GAAG,OAAO,MAAM,OAAO,YAAY,eAAe,CAAC,IAAI;AAAA,EAAA;AAGrG,QAAM,QAAQ,WAAW,MAAM,SAAS,YAAY,UAAU;AAE9D,YAAU,YAAY;AACpB,QAAI,MAAM,QAAQ;AAChB,YAAM,QAAQ;AACd,YAAM,IAAI,QAAQ,CAAC,YAAY,sBAAsB,OAAO,CAAC;AAC7D,YAAM,QAAQ;AACd,YAAM,IAAI,QAAQ,CAAC,YAAY,WAAW,SAAS,SAAS,KAAK,CAAC;AAClE,YAAM,QAAQ;AAAA,IAChB;AAAA,EACF,CAAC;AAED,SAAO;AAAA,IACL;AAAA,IACA;AAAA,EAAA;AAEJ;"}
+{"version":3,"file":"useReveal.js","sources":["../../../../../src/composables/useReveal/useReveal.ts"],"sourcesContent":["import { propsFactory } from '@cds/core';\nimport { onMounted, type PropType, shallowRef, toRef } from 'vue';\n\nexport interface RevealProps {\n  reveal: boolean | { duration?: number };\n}\n\n/**\n * Define the reveal properties for components.\n */\nexport const defineRevealProps = propsFactory(\n  {\n    /**\n     * Анимирует индикатор от нуля до текущего значения при появлении компонента. Объект `{ duration }` задаёт длительность анимации в миллисекундах\n     * @en Animates the indicator from zero to the current value when the component appears. The `{ duration }` object sets the animation duration in milliseconds\n     */\n    reveal: {\n      type: [Boolean, Object] as PropType<\n        | boolean\n        | {\n            duration?: number;\n          }\n      >,\n      default: false\n    }\n  },\n  'reveal'\n);\n\nexport function useReveal(props: RevealProps) {\n  const defaultDuration = 900;\n  const duration = toRef(() =>\n    typeof props.reveal === 'object' ? Math.max(0, Number(props.reveal.duration ?? defaultDuration)) : defaultDuration\n  );\n\n  const state = shallowRef(props.reveal ? 'initial' : 'disabled');\n\n  onMounted(async () => {\n    if (props.reveal) {\n      state.value = 'initial';\n      await new Promise((resolve) => requestAnimationFrame(resolve));\n      state.value = 'pending';\n      await new Promise((resolve) => setTimeout(resolve, duration.value));\n      state.value = 'done';\n    }\n  });\n\n  return {\n    duration,\n    state\n  };\n}\n"],"names":[],"mappings":";;AAUO,MAAM,oBAAoB;AAAA,EAC/B;AAAA;AAAA;AAAA;AAAA;AAAA,IAKE,QAAQ;AAAA,MACN,MAAM,CAAC,SAAS,MAAM;AAAA,MAMtB,SAAS;AAAA,IAAA;AAAA,EACX;AAAA,EAEF;AACF;AAEO,SAAS,UAAU,OAAoB;AAC5C,QAAM,kBAAkB;AACxB,QAAM,WAAW;AAAA,IAAM,MACrB,OAAO,MAAM,WAAW,WAAW,KAAK,IAAI,GAAG,OAAO,MAAM,OAAO,YAAY,eAAe,CAAC,IAAI;AAAA,EAAA;AAGrG,QAAM,QAAQ,WAAW,MAAM,SAAS,YAAY,UAAU;AAE9D,YAAU,YAAY;AACpB,QAAI,MAAM,QAAQ;AAChB,YAAM,QAAQ;AACd,YAAM,IAAI,QAAQ,CAAC,YAAY,sBAAsB,OAAO,CAAC;AAC7D,YAAM,QAAQ;AACd,YAAM,IAAI,QAAQ,CAAC,YAAY,WAAW,SAAS,SAAS,KAAK,CAAC;AAClE,YAAM,QAAQ;AAAA,IAChB;AAAA,EACF,CAAC;AAED,SAAO;AAAA,IACL;AAAA,IACA;AAAA,EAAA;AAEJ;"}

package/dist/es/src/composables/useRouter/useRouter.js

@@ -5,22 +5,34 @@ import { a as IN_BROWSER } from "../../utils/dom/globals.js";
 import { resolveDynamicComponent, toRef, computed, unref, reactive, nextTick, onScopeDispose } from "vue";
 const defineRouterProps = propsFactory(
   {
-    /** Атрибут href для ссылки. Если указан, компонент будет вести себя как обычная ссылка */
+    /**
+     * Атрибут href для ссылки. Если указан, компонент будет вести себя как обычная ссылка
+     * @en The `href` attribute of the link. When set, the component behaves as a regular link
+     */
     href: {
       type: String,
       default: void 0
     },
-    /** Если true, навигация по маршруту будет заменять текущую запись в истории вместо добавления новой */
+    /**
+     * Если true, навигация по маршруту будет заменять текущую запись в истории вместо добавления новой
+     * @en If true, navigation replaces the current history entry instead of pushing a new one
+     */
     replace: {
       type: Boolean,
       default: void 0
     },
-    /** Маршрут назначения или объект для RouterLink. Если указан, компонент будет вести себя как RouterLink */
+    /**
+     * Маршрут назначения или объект для RouterLink. Если указан, компонент будет вести себя как RouterLink
+     * @en Target route or route location object for RouterLink. When set, the component behaves as a RouterLink
+     */
     to: {
       type: [String, Object],
       default: void 0
     },
-    /** Если true, активное состояние будет применяться только при точном совпадении маршрута */
+    /**
+     * Если true, активное состояние будет применяться только при точном совпадении маршрута
+     * @en If true, the active state applies only on an exact route match
+     */
     exact: {
       type: Boolean,
       default: void 0

package/dist/es/src/composables/useRouter/useRouter.js.map

@@ -1 +1 @@
-{"version":3,"file":"useRouter.js","sources":["../../../../../src/composables/useRouter/useRouter.ts"],"sourcesContent":["import { getCurrentInstance, propsFactory } from '@cds/core';\nimport { deepEqual, type EventProp, hasEvent, IN_BROWSER } from '@cds/utils';\nimport {\n  computed,\n  type ExtractPublicPropTypes,\n  nextTick,\n  onScopeDispose,\n  type PropType,\n  reactive,\n  type Ref,\n  resolveDynamicComponent,\n  type SetupContext,\n  toRef,\n  unref\n} from 'vue';\nimport type {\n  NavigationGuardReturn,\n  RouteLocation,\n  RouteLocationNormalizedLoaded,\n  RouteLocationRaw,\n  Router,\n  RouterLink as _RouterLink,\n  useLink as _useLink\n} from 'vue-router';\n\nexport interface LinkProps extends ExtractPublicPropTypes<ReturnType<typeof defineRouterProps>> {\n  disabled?: boolean | null;\n}\n\nexport interface LinkListeners {\n  onClick?: EventProp;\n  onClickOnce?: EventProp;\n}\n\nexport interface UseLink extends Omit<Partial<ReturnType<typeof _useLink>>, 'href' | 'route' | 'navigate'> {\n  isLink: Readonly<Ref<boolean>>;\n  isRouterLink: Readonly<Ref<boolean>>;\n  isClickable: Readonly<Ref<boolean>>;\n  href: Ref<string | undefined>;\n  linkProps: Record<string, string | undefined>;\n  route: Readonly<Ref<(RouteLocation & { href: string }) | undefined>>;\n  navigate: Readonly<Ref<ReturnType<typeof _useLink>['navigate'] | undefined>>;\n}\n\n/**\n * Factory for defining props related to router behavior for a component.\n *\n * The created props include options for assigning link targets, handling route navigation,\n * and defining how the component behaves in relation to the Vue Router.\n *\n * @prop {string|undefined} href - The `href` attribute for a link. If provided, the component behaves like a standard HTML link.\n * @prop {boolean|undefined} replace - If `true`, navigation will replace the current history entry instead of adding a new one.\n * @prop {string|object|undefined} to - Target route or a route location object for `RouterLink`. If provided, the component behaves as a `RouterLink`.\n * @prop {boolean|undefined} exact - If `true`, active state is applied only if the route matches exactly.\n */\nexport const defineRouterProps = propsFactory(\n  {\n    /** Атрибут href для ссылки. Если указан, компонент будет вести себя как обычная ссылка */\n    href: {\n      type: String as PropType<string>,\n      default: undefined\n    },\n    /** Если true, навигация по маршруту будет заменять текущую запись в истории вместо добавления новой */\n    replace: {\n      type: Boolean as PropType<boolean>,\n      default: undefined\n    },\n    /** Маршрут назначения или объект для RouterLink. Если указан, компонент будет вести себя как RouterLink */\n    to: {\n      type: [String, Object] as PropType<RouteLocationRaw>,\n      default: undefined\n    },\n    /** Если true, активное состояние будет применяться только при точном совпадении маршрута */\n    exact: {\n      type: Boolean as PropType<boolean>,\n      default: undefined\n    }\n  },\n  'router'\n);\n\n/**\n * Provides functionality and properties for handling links, including router links\n * and standard anchor tags, with reactive properties for navigation and interactivity.\n *\n * @param {LinkProps} props - The props for the link, including attributes like `href`, `to`, `replace`, and more.\n * @param {SetupContext['attrs']} attrs - The attributes passed to the link, e.g., event listeners like `click`.\n * @return {UseLink} An object containing properties and methods for managing the link:\n * - `route`: The route information for a router link, if applicable.\n * - `navigate`: A function to navigate the link if it's a router link.\n * - `href`: A computed property resolving the `href` for the link.\n * - `isLink`: A reactive boolean indicating whether the link is defined (`href` or `to`).\n * - `isRouterLink`: A reactive boolean indicating whether the link is a router link.\n * - `isClickable`: A reactive boolean indicating whether the link is interactable.\n * - `isActive`: A reactive boolean indicating if the route is active for router links.\n * - `linkProps`: Reactive link attributes such as `href`, `aria-current`, `aria-disabled`, and `tabindex`.\n */\nexport function useLink(props: LinkProps & LinkListeners, attrs: SetupContext['attrs']): UseLink {\n  const route = useRoute();\n  const RouterLink = resolveDynamicComponent('RouterLink') as typeof _RouterLink | string;\n  const isLink = toRef(() => !!(props.href || props.to));\n  const isClickable = computed(() => unref(isLink) || hasEvent(attrs, 'click') || hasEvent(props, 'click'));\n\n  if (typeof RouterLink === 'string' || !('useLink' in RouterLink)) {\n    const href = toRef(() => props.href);\n\n    return {\n      isLink,\n      isRouterLink: toRef(() => false),\n      isClickable,\n      href,\n      linkProps: reactive({ href }),\n      route: toRef(() => undefined),\n      navigate: toRef(() => undefined)\n    };\n  }\n\n  const routerLink = RouterLink.useLink({\n    to: toRef(() => props.to || ''),\n    replace: toRef(() => props.replace)\n  });\n  const link = computed(() => (props.to ? routerLink : undefined));\n  const href = computed(() => (props.to ? unref(link)?.route.value.href : props.href));\n\n  const isRouterLink = toRef(() => !!props.to);\n  const isActive = computed(() => {\n    if (!link.value) return false;\n    if (!props.exact) return link.value.isActive?.value ?? false;\n    if (!route.value) return link.value.isExactActive?.value ?? false;\n\n    return link.value.isExactActive?.value && deepEqual(link.value.route.value.query, route.value.query);\n  });\n\n  return {\n    href,\n    isLink,\n    isRouterLink,\n    isClickable,\n    isActive,\n    linkProps: reactive({\n      href,\n      'aria-current': toRef(() => (unref(isActive) ? 'page' : undefined)),\n      'aria-disabled': toRef(() => (props.disabled && unref(isLink) ? 'true' : undefined)),\n      tabindex: toRef(() => (props.disabled && unref(isLink) ? '-1' : undefined))\n    }),\n    route: toRef(() => unref(link)?.route.value),\n    navigate: toRef(() => unref(link)?.navigate)\n  };\n}\n\n/**\n * A composable function that provides a reactive reference to the current route.\n * It retrieves the current route from the Vue instance and wraps it in a computed reference.\n * This allows for reactive updates when the route changes.\n *\n * @return {Ref<RouteLocationNormalizedLoaded | undefined>} A reactive reference to the current normalized loaded route or undefined if no route is available.\n */\nexport function useRoute(): Ref<RouteLocationNormalizedLoaded | undefined> {\n  const vm = getCurrentInstance('useRoute');\n  return computed(() => vm?.proxy?.$route);\n}\n\n/**\n * Provides access to the current Vue Router instance.\n *\n * This method retrieves the router instance associated with the current Vue component\n * instance, if available. The router instance can be used for navigation and accessing\n * route-specific data.\n *\n * @return {Router | undefined} The Vue Router instance if the current component is associated\n * with a router, or undefined if it is not found.\n */\nexport function useRouter(): Router | undefined {\n  const vm = getCurrentInstance('useRouter');\n  return vm?.proxy?.$router;\n}\n\nlet inTransition = false;\n\n/**\n * Sets up a back button handler using the provided router and callback function.\n * Listens for browser back button events and triggers the given callback during navigation.\n * Ensures safe handling of navigation transitions.\n *\n * @param {Router | undefined} router - The router instance to integrate with, which can be undefined if no router is used.\n * @param {() => NavigationGuardReturn} cb - A callback function that will be invoked during a back button interaction or navigation guard step.\n * @return {void} No return value.\n */\nexport function useBackButton(router: Router | undefined, cb: () => NavigationGuardReturn) {\n  let popped = false;\n  let removeBefore: (() => void) | undefined;\n  let removeAfter: (() => void) | undefined;\n\n  if (IN_BROWSER && router?.beforeEach) {\n    nextTick(() => {\n      window.addEventListener('popstate', onPopstate);\n      removeBefore = router.beforeEach(() => {\n        if (!inTransition) {\n          inTransition = true;\n          return new Promise<NavigationGuardReturn>((resolve) => {\n            setTimeout(() => resolve(popped ? cb() : undefined));\n          });\n        }\n        return popped ? cb() : undefined;\n      });\n      removeAfter = router?.afterEach(() => {\n        inTransition = false;\n      });\n    });\n    onScopeDispose(() => {\n      window.removeEventListener('popstate', onPopstate);\n      removeBefore?.();\n      removeAfter?.();\n    });\n  }\n\n  function onPopstate(e: PopStateEvent) {\n    if (e.state?.replaced) return;\n\n    popped = true;\n    setTimeout(() => (popped = false));\n  }\n}\n"],"names":["href"],"mappings":";;;;;AAuDO,MAAM,oBAAoB;AAAA,EAC/B;AAAA;AAAA,IAEE,MAAM;AAAA,MACJ,MAAM;AAAA,MACN,SAAS;AAAA,IAAA;AAAA;AAAA,IAGX,SAAS;AAAA,MACP,MAAM;AAAA,MACN,SAAS;AAAA,IAAA;AAAA;AAAA,IAGX,IAAI;AAAA,MACF,MAAM,CAAC,QAAQ,MAAM;AAAA,MACrB,SAAS;AAAA,IAAA;AAAA;AAAA,IAGX,OAAO;AAAA,MACL,MAAM;AAAA,MACN,SAAS;AAAA,IAAA;AAAA,EACX;AAAA,EAEF;AACF;AAkBO,SAAS,QAAQ,OAAkC,OAAuC;AAC/F,QAAM,QAAQ,SAAA;AACd,QAAM,aAAa,wBAAwB,YAAY;AACvD,QAAM,SAAS,MAAM,MAAM,CAAC,EAAE,MAAM,QAAQ,MAAM,GAAG;AACrD,QAAM,cAAc,SAAS,MAAM,MAAM,MAAM,KAAK,SAAS,OAAO,OAAO,KAAK,SAAS,OAAO,OAAO,CAAC;AAExG,MAAI,OAAO,eAAe,YAAY,EAAE,aAAa,aAAa;AAChE,UAAMA,QAAO,MAAM,MAAM,MAAM,IAAI;AAEnC,WAAO;AAAA,MACL;AAAA,MACA,cAAc,MAAM,MAAM,KAAK;AAAA,MAC/B;AAAA,MACA,MAAAA;AAAAA,MACA,WAAW,SAAS,EAAE,MAAAA,OAAM;AAAA,MAC5B,OAAO,MAAM,MAAM,MAAS;AAAA,MAC5B,UAAU,MAAM,MAAM,MAAS;AAAA,IAAA;AAAA,EAEnC;AAEA,QAAM,aAAa,WAAW,QAAQ;AAAA,IACpC,IAAI,MAAM,MAAM,MAAM,MAAM,EAAE;AAAA,IAC9B,SAAS,MAAM,MAAM,MAAM,OAAO;AAAA,EAAA,CACnC;AACD,QAAM,OAAO,SAAS,MAAO,MAAM,KAAK,aAAa,MAAU;AAC/D,QAAM,OAAO,SAAS;;AAAO,iBAAM,MAAK,WAAM,IAAI,MAAV,mBAAa,MAAM,MAAM,OAAO,MAAM;AAAA,GAAK;AAEnF,QAAM,eAAe,MAAM,MAAM,CAAC,CAAC,MAAM,EAAE;AAC3C,QAAM,WAAW,SAAS,MAAM;;AAC9B,QAAI,CAAC,KAAK,MAAO,QAAO;AACxB,QAAI,CAAC,MAAM,gBAAc,UAAK,MAAM,aAAX,mBAAqB,UAAS;AACvD,QAAI,CAAC,MAAM,gBAAc,UAAK,MAAM,kBAAX,mBAA0B,UAAS;AAE5D,aAAO,UAAK,MAAM,kBAAX,mBAA0B,UAAS,UAAU,KAAK,MAAM,MAAM,MAAM,OAAO,MAAM,MAAM,KAAK;AAAA,EACrG,CAAC;AAED,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,WAAW,SAAS;AAAA,MAClB;AAAA,MACA,gBAAgB,MAAM,MAAO,MAAM,QAAQ,IAAI,SAAS,MAAU;AAAA,MAClE,iBAAiB,MAAM,MAAO,MAAM,YAAY,MAAM,MAAM,IAAI,SAAS,MAAU;AAAA,MACnF,UAAU,MAAM,MAAO,MAAM,YAAY,MAAM,MAAM,IAAI,OAAO,MAAU;AAAA,IAAA,CAC3E;AAAA,IACD,OAAO,MAAM,MAAA;;AAAM,yBAAM,IAAI,MAAV,mBAAa,MAAM;AAAA,KAAK;AAAA,IAC3C,UAAU,MAAM,MAAA;;AAAM,yBAAM,IAAI,MAAV,mBAAa;AAAA,KAAQ;AAAA,EAAA;AAE/C;AASO,SAAS,WAA2D;AACzE,QAAM,KAAK,mBAAmB,UAAU;AACxC,SAAO,SAAS,MAAA;;AAAM,0CAAI,UAAJ,mBAAW;AAAA,GAAM;AACzC;AAYO,SAAS,YAAgC;;AAC9C,QAAM,KAAK,mBAAmB,WAAW;AACzC,UAAO,8BAAI,UAAJ,mBAAW;AACpB;AAEA,IAAI,eAAe;AAWZ,SAAS,cAAc,QAA4B,IAAiC;AACzF,MAAI,SAAS;AACb,MAAI;AACJ,MAAI;AAEJ,MAAI,eAAc,iCAAQ,aAAY;AACpC,aAAS,MAAM;AACb,aAAO,iBAAiB,YAAY,UAAU;AAC9C,qBAAe,OAAO,WAAW,MAAM;AACrC,YAAI,CAAC,cAAc;AACjB,yBAAe;AACf,iBAAO,IAAI,QAA+B,CAAC,YAAY;AACrD,uBAAW,MAAM,QAAQ,SAAS,GAAA,IAAO,MAAS,CAAC;AAAA,UACrD,CAAC;AAAA,QACH;AACA,eAAO,SAAS,OAAO;AAAA,MACzB,CAAC;AACD,oBAAc,iCAAQ,UAAU,MAAM;AACpC,uBAAe;AAAA,MACjB;AAAA,IACF,CAAC;AACD,mBAAe,MAAM;AACnB,aAAO,oBAAoB,YAAY,UAAU;AACjD;AACA;AAAA,IACF,CAAC;AAAA,EACH;AAEA,WAAS,WAAW,GAAkB;;AACpC,SAAI,OAAE,UAAF,mBAAS,SAAU;AAEvB,aAAS;AACT,eAAW,MAAO,SAAS,KAAM;AAAA,EACnC;AACF;"}
+{"version":3,"file":"useRouter.js","sources":["../../../../../src/composables/useRouter/useRouter.ts"],"sourcesContent":["import { getCurrentInstance, propsFactory } from '@cds/core';\nimport { deepEqual, type EventProp, hasEvent, IN_BROWSER } from '@cds/utils';\nimport {\n  computed,\n  type ExtractPublicPropTypes,\n  nextTick,\n  onScopeDispose,\n  type PropType,\n  reactive,\n  type Ref,\n  resolveDynamicComponent,\n  type SetupContext,\n  toRef,\n  unref\n} from 'vue';\nimport type {\n  NavigationGuardReturn,\n  RouteLocation,\n  RouteLocationNormalizedLoaded,\n  RouteLocationRaw,\n  Router,\n  RouterLink as _RouterLink,\n  useLink as _useLink\n} from 'vue-router';\n\nexport interface LinkProps extends ExtractPublicPropTypes<ReturnType<typeof defineRouterProps>> {\n  disabled?: boolean | null;\n}\n\nexport interface LinkListeners {\n  onClick?: EventProp;\n  onClickOnce?: EventProp;\n}\n\nexport interface UseLink extends Omit<Partial<ReturnType<typeof _useLink>>, 'href' | 'route' | 'navigate'> {\n  isLink: Readonly<Ref<boolean>>;\n  isRouterLink: Readonly<Ref<boolean>>;\n  isClickable: Readonly<Ref<boolean>>;\n  href: Ref<string | undefined>;\n  linkProps: Record<string, string | undefined>;\n  route: Readonly<Ref<(RouteLocation & { href: string }) | undefined>>;\n  navigate: Readonly<Ref<ReturnType<typeof _useLink>['navigate'] | undefined>>;\n}\n\n/**\n * Factory for defining props related to router behavior for a component.\n *\n * The created props include options for assigning link targets, handling route navigation,\n * and defining how the component behaves in relation to the Vue Router.\n *\n * @prop {string|undefined} href - The `href` attribute for a link. If provided, the component behaves like a standard HTML link.\n * @prop {boolean|undefined} replace - If `true`, navigation will replace the current history entry instead of adding a new one.\n * @prop {string|object|undefined} to - Target route or a route location object for `RouterLink`. If provided, the component behaves as a `RouterLink`.\n * @prop {boolean|undefined} exact - If `true`, active state is applied only if the route matches exactly.\n */\nexport const defineRouterProps = propsFactory(\n  {\n    /**\n     * Атрибут href для ссылки. Если указан, компонент будет вести себя как обычная ссылка\n     * @en The `href` attribute of the link. When set, the component behaves as a regular link\n     */\n    href: {\n      type: String as PropType<string>,\n      default: undefined\n    },\n    /**\n     * Если true, навигация по маршруту будет заменять текущую запись в истории вместо добавления новой\n     * @en If true, navigation replaces the current history entry instead of pushing a new one\n     */\n    replace: {\n      type: Boolean as PropType<boolean>,\n      default: undefined\n    },\n    /**\n     * Маршрут назначения или объект для RouterLink. Если указан, компонент будет вести себя как RouterLink\n     * @en Target route or route location object for RouterLink. When set, the component behaves as a RouterLink\n     */\n    to: {\n      type: [String, Object] as PropType<RouteLocationRaw>,\n      default: undefined\n    },\n    /**\n     * Если true, активное состояние будет применяться только при точном совпадении маршрута\n     * @en If true, the active state applies only on an exact route match\n     */\n    exact: {\n      type: Boolean as PropType<boolean>,\n      default: undefined\n    }\n  },\n  'router'\n);\n\n/**\n * Provides functionality and properties for handling links, including router links\n * and standard anchor tags, with reactive properties for navigation and interactivity.\n *\n * @param {LinkProps} props - The props for the link, including attributes like `href`, `to`, `replace`, and more.\n * @param {SetupContext['attrs']} attrs - The attributes passed to the link, e.g., event listeners like `click`.\n * @return {UseLink} An object containing properties and methods for managing the link:\n * - `route`: The route information for a router link, if applicable.\n * - `navigate`: A function to navigate the link if it's a router link.\n * - `href`: A computed property resolving the `href` for the link.\n * - `isLink`: A reactive boolean indicating whether the link is defined (`href` or `to`).\n * - `isRouterLink`: A reactive boolean indicating whether the link is a router link.\n * - `isClickable`: A reactive boolean indicating whether the link is interactable.\n * - `isActive`: A reactive boolean indicating if the route is active for router links.\n * - `linkProps`: Reactive link attributes such as `href`, `aria-current`, `aria-disabled`, and `tabindex`.\n */\nexport function useLink(props: LinkProps & LinkListeners, attrs: SetupContext['attrs']): UseLink {\n  const route = useRoute();\n  const RouterLink = resolveDynamicComponent('RouterLink') as typeof _RouterLink | string;\n  const isLink = toRef(() => !!(props.href || props.to));\n  const isClickable = computed(() => unref(isLink) || hasEvent(attrs, 'click') || hasEvent(props, 'click'));\n\n  if (typeof RouterLink === 'string' || !('useLink' in RouterLink)) {\n    const href = toRef(() => props.href);\n\n    return {\n      isLink,\n      isRouterLink: toRef(() => false),\n      isClickable,\n      href,\n      linkProps: reactive({ href }),\n      route: toRef(() => undefined),\n      navigate: toRef(() => undefined)\n    };\n  }\n\n  const routerLink = RouterLink.useLink({\n    to: toRef(() => props.to || ''),\n    replace: toRef(() => props.replace)\n  });\n  const link = computed(() => (props.to ? routerLink : undefined));\n  const href = computed(() => (props.to ? unref(link)?.route.value.href : props.href));\n\n  const isRouterLink = toRef(() => !!props.to);\n  const isActive = computed(() => {\n    if (!link.value) return false;\n    if (!props.exact) return link.value.isActive?.value ?? false;\n    if (!route.value) return link.value.isExactActive?.value ?? false;\n\n    return link.value.isExactActive?.value && deepEqual(link.value.route.value.query, route.value.query);\n  });\n\n  return {\n    href,\n    isLink,\n    isRouterLink,\n    isClickable,\n    isActive,\n    linkProps: reactive({\n      href,\n      'aria-current': toRef(() => (unref(isActive) ? 'page' : undefined)),\n      'aria-disabled': toRef(() => (props.disabled && unref(isLink) ? 'true' : undefined)),\n      tabindex: toRef(() => (props.disabled && unref(isLink) ? '-1' : undefined))\n    }),\n    route: toRef(() => unref(link)?.route.value),\n    navigate: toRef(() => unref(link)?.navigate)\n  };\n}\n\n/**\n * A composable function that provides a reactive reference to the current route.\n * It retrieves the current route from the Vue instance and wraps it in a computed reference.\n * This allows for reactive updates when the route changes.\n *\n * @return {Ref<RouteLocationNormalizedLoaded | undefined>} A reactive reference to the current normalized loaded route or undefined if no route is available.\n */\nexport function useRoute(): Ref<RouteLocationNormalizedLoaded | undefined> {\n  const vm = getCurrentInstance('useRoute');\n  return computed(() => vm?.proxy?.$route);\n}\n\n/**\n * Provides access to the current Vue Router instance.\n *\n * This method retrieves the router instance associated with the current Vue component\n * instance, if available. The router instance can be used for navigation and accessing\n * route-specific data.\n *\n * @return {Router | undefined} The Vue Router instance if the current component is associated\n * with a router, or undefined if it is not found.\n */\nexport function useRouter(): Router | undefined {\n  const vm = getCurrentInstance('useRouter');\n  return vm?.proxy?.$router;\n}\n\nlet inTransition = false;\n\n/**\n * Sets up a back button handler using the provided router and callback function.\n * Listens for browser back button events and triggers the given callback during navigation.\n * Ensures safe handling of navigation transitions.\n *\n * @param {Router | undefined} router - The router instance to integrate with, which can be undefined if no router is used.\n * @param {() => NavigationGuardReturn} cb - A callback function that will be invoked during a back button interaction or navigation guard step.\n * @return {void} No return value.\n */\nexport function useBackButton(router: Router | undefined, cb: () => NavigationGuardReturn) {\n  let popped = false;\n  let removeBefore: (() => void) | undefined;\n  let removeAfter: (() => void) | undefined;\n\n  if (IN_BROWSER && router?.beforeEach) {\n    nextTick(() => {\n      window.addEventListener('popstate', onPopstate);\n      removeBefore = router.beforeEach(() => {\n        if (!inTransition) {\n          inTransition = true;\n          return new Promise<NavigationGuardReturn>((resolve) => {\n            setTimeout(() => resolve(popped ? cb() : undefined));\n          });\n        }\n        return popped ? cb() : undefined;\n      });\n      removeAfter = router?.afterEach(() => {\n        inTransition = false;\n      });\n    });\n    onScopeDispose(() => {\n      window.removeEventListener('popstate', onPopstate);\n      removeBefore?.();\n      removeAfter?.();\n    });\n  }\n\n  function onPopstate(e: PopStateEvent) {\n    if (e.state?.replaced) return;\n\n    popped = true;\n    setTimeout(() => (popped = false));\n  }\n}\n"],"names":["href"],"mappings":"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"}

package/dist/es/src/composables/useSize/useSize.js

@@ -5,7 +5,10 @@ import { toValue } from "vue";
 const availableSizes = ["xs", "sm", "md", "lg", "xl"];
 const defineSizeProps = propsFactory(
   {
-    /** Размер компонента */
+    /**
+     * Размер компонента
+     * @en Size of the component
+     */
     size: {
       type: [String, Number],
       default: "md",

package/dist/es/src/composables/useSize/useSize.js.map

@@ -1 +1 @@
-{"version":3,"file":"useSize.js","sources":["../../../../../src/composables/useSize/useSize.ts"],"sourcesContent":["import { getCurrentInstanceName, propsFactory } from '@cds/core';\nimport { convertToUnit, destructComputed, includes } from '@cds/utils';\nimport { type ExtractPublicPropTypes, type MaybeRefOrGetter, type PropType, toValue } from 'vue';\n\nexport const availableSizes = ['xs', 'sm', 'md', 'lg', 'xl'] as const;\nexport type Size = (typeof availableSizes)[number];\n\n/**\n * A factory function defining properties related to size configuration for components.\n *\n * @constant\n * @name defineSizeProps\n * @type {Function}\n *\n * Properties:\n * - `size`: Defines the size of the component.\n *   - Type: String or Number\n *   - Default: `'md'`\n *   - Validator: Validates if the value is a number or one of the predefined sizes in `availableSizes`.\n *\n * This function is typically used to generate size-related props for reusable or configurable UI components.\n */\nexport const defineSizeProps = propsFactory(\n  {\n    /** Размер компонента */\n    size: {\n      type: [String, Number] as PropType<Size | number>,\n      default: 'md',\n      validator: (value: Size | any) => typeof value === 'number' || availableSizes.includes(value)\n    }\n  },\n  'size'\n);\n\nexport type SizeProps = ExtractPublicPropTypes<ReturnType<typeof defineSizeProps>>;\n\n/**\n * Computes size-related classes and styles based on the provided properties.\n *\n * @param {MaybeRefOrGetter<SizeProps>} props - The properties containing size information.\n * @param {string} [name=getCurrentInstanceName()] - The name of the current component instance.\n * @return {Object} An object containing `sizeClasses` for CSS class names and `sizeStyles` for inline styles.\n */\nexport function useSize(props: MaybeRefOrGetter<SizeProps>, name = getCurrentInstanceName()) {\n  return destructComputed(() => {\n    const { size } = toValue(props);\n    let sizeClasses, sizeStyles;\n\n    if (includes(availableSizes, size)) {\n      sizeClasses = `${name}--size-${size}`;\n    } else if (size) {\n      sizeStyles = {\n        width: convertToUnit(size),\n        height: convertToUnit(size)\n      };\n    }\n\n    return { sizeClasses, sizeStyles };\n  });\n}\n"],"names":[],"mappings":";;;;AAIO,MAAM,iBAAiB,CAAC,MAAM,MAAM,MAAM,MAAM,IAAI;AAkBpD,MAAM,kBAAkB;AAAA,EAC7B;AAAA;AAAA,IAEE,MAAM;AAAA,MACJ,MAAM,CAAC,QAAQ,MAAM;AAAA,MACrB,SAAS;AAAA,MACT,WAAW,CAAC,UAAsB,OAAO,UAAU,YAAY,eAAe,SAAS,KAAK;AAAA,IAAA;AAAA,EAC9F;AAAA,EAEF;AACF;AAWO,SAAS,QAAQ,OAAoC,OAAO,0BAA0B;AAC3F,SAAO,iBAAiB,MAAM;AAC5B,UAAM,EAAE,KAAA,IAAS,QAAQ,KAAK;AAC9B,QAAI,aAAa;AAEjB,QAAI,SAAS,gBAAgB,IAAI,GAAG;AAClC,oBAAc,GAAG,IAAI,UAAU,IAAI;AAAA,IACrC,WAAW,MAAM;AACf,mBAAa;AAAA,QACX,OAAO,cAAc,IAAI;AAAA,QACzB,QAAQ,cAAc,IAAI;AAAA,MAAA;AAAA,IAE9B;AAEA,WAAO,EAAE,aAAa,WAAA;AAAA,EACxB,CAAC;AACH;"}
+{"version":3,"file":"useSize.js","sources":["../../../../../src/composables/useSize/useSize.ts"],"sourcesContent":["import { getCurrentInstanceName, propsFactory } from '@cds/core';\nimport { convertToUnit, destructComputed, includes } from '@cds/utils';\nimport { type ExtractPublicPropTypes, type MaybeRefOrGetter, type PropType, toValue } from 'vue';\n\nexport const availableSizes = ['xs', 'sm', 'md', 'lg', 'xl'] as const;\nexport type Size = (typeof availableSizes)[number];\n\n/**\n * A factory function defining properties related to size configuration for components.\n *\n * @constant\n * @name defineSizeProps\n * @type {Function}\n *\n * Properties:\n * - `size`: Defines the size of the component.\n *   - Type: String or Number\n *   - Default: `'md'`\n *   - Validator: Validates if the value is a number or one of the predefined sizes in `availableSizes`.\n *\n * This function is typically used to generate size-related props for reusable or configurable UI components.\n */\nexport const defineSizeProps = propsFactory(\n  {\n    /**\n     * Размер компонента\n     * @en Size of the component\n     */\n    size: {\n      type: [String, Number] as PropType<Size | number>,\n      default: 'md',\n      validator: (value: Size | any) => typeof value === 'number' || availableSizes.includes(value)\n    }\n  },\n  'size'\n);\n\nexport type SizeProps = ExtractPublicPropTypes<ReturnType<typeof defineSizeProps>>;\n\n/**\n * Computes size-related classes and styles based on the provided properties.\n *\n * @param {MaybeRefOrGetter<SizeProps>} props - The properties containing size information.\n * @param {string} [name=getCurrentInstanceName()] - The name of the current component instance.\n * @return {Object} An object containing `sizeClasses` for CSS class names and `sizeStyles` for inline styles.\n */\nexport function useSize(props: MaybeRefOrGetter<SizeProps>, name = getCurrentInstanceName()) {\n  return destructComputed(() => {\n    const { size } = toValue(props);\n    let sizeClasses, sizeStyles;\n\n    if (includes(availableSizes, size)) {\n      sizeClasses = `${name}--size-${size}`;\n    } else if (size) {\n      sizeStyles = {\n        width: convertToUnit(size),\n        height: convertToUnit(size)\n      };\n    }\n\n    return { sizeClasses, sizeStyles };\n  });\n}\n"],"names":[],"mappings":";;;;AAIO,MAAM,iBAAiB,CAAC,MAAM,MAAM,MAAM,MAAM,IAAI;AAkBpD,MAAM,kBAAkB;AAAA,EAC7B;AAAA;AAAA;AAAA;AAAA;AAAA,IAKE,MAAM;AAAA,MACJ,MAAM,CAAC,QAAQ,MAAM;AAAA,MACrB,SAAS;AAAA,MACT,WAAW,CAAC,UAAsB,OAAO,UAAU,YAAY,eAAe,SAAS,KAAK;AAAA,IAAA;AAAA,EAC9F;AAAA,EAEF;AACF;AAWO,SAAS,QAAQ,OAAoC,OAAO,0BAA0B;AAC3F,SAAO,iBAAiB,MAAM;AAC5B,UAAM,EAAE,KAAA,IAAS,QAAQ,KAAK;AAC9B,QAAI,aAAa;AAEjB,QAAI,SAAS,gBAAgB,IAAI,GAAG;AAClC,oBAAc,GAAG,IAAI,UAAU,IAAI;AAAA,IACrC,WAAW,MAAM;AACf,mBAAa;AAAA,QACX,OAAO,cAAc,IAAI;AAAA,QACzB,QAAQ,cAAc,IAAI;AAAA,MAAA;AAAA,IAE9B;AAEA,WAAO,EAAE,aAAa,WAAA;AAAA,EACxB,CAAC;AACH;"}

package/dist/es/src/composables/useStatus/useStatus.js

@@ -3,7 +3,10 @@ import { computed } from "vue";
 import { s as statusIcons } from "./internal/useStatus.constants.js";
 const defineStatusProps = propsFactory(
   {
-    /** Семантический статус — определяет цвет и дефолтную иконку. */
+    /**
+     * Семантический статус — определяет цвет и дефолтную иконку.
+     * @en Semantic status — drives the color and the default icon.
+     */
     status: {
       type: String,
       default: "info"

package/dist/es/src/composables/useStatus/useStatus.js.map

@@ -1 +1 @@
-{"version":3,"file":"useStatus.js","sources":["../../../../../src/composables/useStatus/useStatus.ts"],"sourcesContent":["import type { IconValue } from '@cds/composables/useIcons';\nimport { propsFactory } from '@cds/core';\nimport { computed, type ComputedRef, type PropType } from 'vue';\n\nimport { type CdsStatusValue, statusIcons } from './internal/useStatus.constants';\n\nexport const defineStatusProps = propsFactory(\n  {\n    /** Семантический статус — определяет цвет и дефолтную иконку. */\n    status: {\n      type: String as PropType<CdsStatusValue>,\n      default: 'info'\n    }\n  },\n  'status'\n);\n\nexport interface UseStatusOptions {\n  /** Переопределение набора иконок статуса (например, не-`fill` для алертов). */\n  icons?: Record<CdsStatusValue, IconValue>;\n}\n\nexport interface UseStatusReturn {\n  status: ComputedRef<CdsStatusValue>;\n  statusIcon: ComputedRef<IconValue>;\n}\n\n/**\n * Резолвит семантику статуса: текущий статус и иконку для него.\n * `options.icons` позволяет компоненту подменить набор иконок.\n */\nexport function useStatus(props: { status: CdsStatusValue }, options: UseStatusOptions = {}): UseStatusReturn {\n  const icons = options.icons ?? statusIcons;\n\n  return {\n    status: computed(() => props.status),\n    statusIcon: computed(() => icons[props.status])\n  };\n}\n"],"names":[],"mappings":";;;AAMO,MAAM,oBAAoB;AAAA,EAC/B;AAAA;AAAA,IAEE,QAAQ;AAAA,MACN,MAAM;AAAA,MACN,SAAS;AAAA,IAAA;AAAA,EACX;AAAA,EAEF;AACF;AAgBO,SAAS,UAAU,OAAmC,UAA4B,IAAqB;AAC5G,QAAM,QAAQ,QAAQ,SAAS;AAE/B,SAAO;AAAA,IACL,QAAQ,SAAS,MAAM,MAAM,MAAM;AAAA,IACnC,YAAY,SAAS,MAAM,MAAM,MAAM,MAAM,CAAC;AAAA,EAAA;AAElD;"}
+{"version":3,"file":"useStatus.js","sources":["../../../../../src/composables/useStatus/useStatus.ts"],"sourcesContent":["import type { IconValue } from '@cds/composables/useIcons';\nimport { propsFactory } from '@cds/core';\nimport { computed, type ComputedRef, type PropType } from 'vue';\n\nimport { type CdsStatusValue, statusIcons } from './internal/useStatus.constants';\n\nexport const defineStatusProps = propsFactory(\n  {\n    /**\n     * Семантический статус — определяет цвет и дефолтную иконку.\n     * @en Semantic status — drives the color and the default icon.\n     */\n    status: {\n      type: String as PropType<CdsStatusValue>,\n      default: 'info'\n    }\n  },\n  'status'\n);\n\nexport interface UseStatusOptions {\n  /** Переопределение набора иконок статуса (например, не-`fill` для алертов). */\n  icons?: Record<CdsStatusValue, IconValue>;\n}\n\nexport interface UseStatusReturn {\n  status: ComputedRef<CdsStatusValue>;\n  statusIcon: ComputedRef<IconValue>;\n}\n\n/**\n * Резолвит семантику статуса: текущий статус и иконку для него.\n * `options.icons` позволяет компоненту подменить набор иконок.\n */\nexport function useStatus(props: { status: CdsStatusValue }, options: UseStatusOptions = {}): UseStatusReturn {\n  const icons = options.icons ?? statusIcons;\n\n  return {\n    status: computed(() => props.status),\n    statusIcon: computed(() => icons[props.status])\n  };\n}\n"],"names":[],"mappings":";;;AAMO,MAAM,oBAAoB;AAAA,EAC/B;AAAA;AAAA;AAAA;AAAA;AAAA,IAKE,QAAQ;AAAA,MACN,MAAM;AAAA,MACN,SAAS;AAAA,IAAA;AAAA,EACX;AAAA,EAEF;AACF;AAgBO,SAAS,UAAU,OAAmC,UAA4B,IAAqB;AAC5G,QAAM,QAAQ,QAAQ,SAAS;AAE/B,SAAO;AAAA,IACL,QAAQ,SAAS,MAAM,MAAM,MAAM;AAAA,IACnC,YAAY,SAAS,MAAM,MAAM,MAAM,MAAM,CAAC;AAAA,EAAA;AAElD;"}

package/dist/es/src/composables/useText/useText.js

@@ -2,9 +2,15 @@ import { p as propsFactory } from "../../core/propsFactory.js";
 import { computed, toDisplayString } from "vue";
 const defineTextProps = propsFactory(
   {
-    /** Текст, отображаемый в компоненте. */
+    /**
+     * Текст, отображаемый в компоненте.
+     * @en Text displayed in the component.
+     */
     text: [String, Number],
-    /** Контент, отображаемый в компоненте. */
+    /**
+     * Контент, отображаемый в компоненте.
+     * @en Content displayed in the component.
+     */
     content: [String, Number]
   },
   "text"

package/dist/es/src/composables/useText/useText.js.map

@@ -1 +1 @@
-{"version":3,"file":"useText.js","sources":["../../../../../src/composables/useText/useText.ts"],"sourcesContent":["import { propsFactory } from '@cds/core';\nimport { computed, type ExtractPublicPropTypes, toDisplayString } from 'vue';\n\n/**\n * Factory function to define the text-related properties for a component.\n *\n * @typedef {Object} defineTextProps\n * @property {(String|Number)} text - The text displayed in the component.\n * @property {(String|Number)} content - The content displayed in the component.\n */\nexport const defineTextProps = propsFactory(\n  {\n    /** Текст, отображаемый в компоненте. */\n    text: [String, Number],\n    /** Контент, отображаемый в компоненте. */\n    content: [String, Number]\n  },\n  'text'\n);\n\nexport type TextProps = ExtractPublicPropTypes<ReturnType<typeof defineTextProps>>;\n\n/**\n * Processes the input text properties and generates plain content and displayable text.\n *\n * @param {TextProps} props - The text properties containing the input text or content.\n * @return {Object} An object containing `plainContent` and `displayText`:\n *                  - `plainContent`: Реактивный (computed) исходный контент из `text`/`content`.\n *                  - `displayText`: Реактивная (computed) строка для отображения.\n */\nexport function useText(props: TextProps) {\n  const plainContent = computed(() => props.text ?? props.content);\n  const displayText = computed(() => toDisplayString(plainContent.value));\n\n  return {\n    plainContent,\n    displayText\n  };\n}\n"],"names":[],"mappings":";;AAUO,MAAM,kBAAkB;AAAA,EAC7B;AAAA;AAAA,IAEE,MAAM,CAAC,QAAQ,MAAM;AAAA;AAAA,IAErB,SAAS,CAAC,QAAQ,MAAM;AAAA,EAAA;AAAA,EAE1B;AACF;AAYO,SAAS,QAAQ,OAAkB;AACxC,QAAM,eAAe,SAAS,MAAM,MAAM,QAAQ,MAAM,OAAO;AAC/D,QAAM,cAAc,SAAS,MAAM,gBAAgB,aAAa,KAAK,CAAC;AAEtE,SAAO;AAAA,IACL;AAAA,IACA;AAAA,EAAA;AAEJ;"}
+{"version":3,"file":"useText.js","sources":["../../../../../src/composables/useText/useText.ts"],"sourcesContent":["import { propsFactory } from '@cds/core';\nimport { computed, type ExtractPublicPropTypes, toDisplayString } from 'vue';\n\n/**\n * Factory function to define the text-related properties for a component.\n *\n * @typedef {Object} defineTextProps\n * @property {(String|Number)} text - The text displayed in the component.\n * @property {(String|Number)} content - The content displayed in the component.\n */\nexport const defineTextProps = propsFactory(\n  {\n    /**\n     * Текст, отображаемый в компоненте.\n     * @en Text displayed in the component.\n     */\n    text: [String, Number],\n    /**\n     * Контент, отображаемый в компоненте.\n     * @en Content displayed in the component.\n     */\n    content: [String, Number]\n  },\n  'text'\n);\n\nexport type TextProps = ExtractPublicPropTypes<ReturnType<typeof defineTextProps>>;\n\n/**\n * Processes the input text properties and generates plain content and displayable text.\n *\n * @param {TextProps} props - The text properties containing the input text or content.\n * @return {Object} An object containing `plainContent` and `displayText`:\n *                  - `plainContent`: Реактивный (computed) исходный контент из `text`/`content`.\n *                  - `displayText`: Реактивная (computed) строка для отображения.\n */\nexport function useText(props: TextProps) {\n  const plainContent = computed(() => props.text ?? props.content);\n  const displayText = computed(() => toDisplayString(plainContent.value));\n\n  return {\n    plainContent,\n    displayText\n  };\n}\n"],"names":[],"mappings":";;AAUO,MAAM,kBAAkB;AAAA,EAC7B;AAAA;AAAA;AAAA;AAAA;AAAA,IAKE,MAAM,CAAC,QAAQ,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA,IAKrB,SAAS,CAAC,QAAQ,MAAM;AAAA,EAAA;AAAA,EAE1B;AACF;AAYO,SAAS,QAAQ,OAAkB;AACxC,QAAM,eAAe,SAAS,MAAM,MAAM,QAAQ,MAAM,OAAO;AAC/D,QAAM,cAAc,SAAS,MAAM,gBAAgB,aAAa,KAAK,CAAC;AAEtE,SAAO;AAAA,IACL;AAAA,IACA;AAAA,EAAA;AAEJ;"}

package/dist/es/src/composables/useTheme/useTheme.js

@@ -7,7 +7,10 @@ import { D as DEFAULT_THEME, T as ThemeSymbol } from "./internal/useTheme.consta
 import { p as parseThemeOptions, g as generateVariations, a as generateOnColors, c as createCssClass, b as generateCssVariables, u as upsertStyles } from "./internal/useTheme.utils.js";
 const defineThemeProps = propsFactory(
   {
-    /** Тема компонента */
+    /**
+     * Тема компонента
+     * @en Component theme
+     */
     theme: {
       type: String,
       default: void 0

package/dist/es/src/composables/useTheme/useTheme.js.map

@@ -1 +1 @@
-{"version":3,"file":"useTheme.js","sources":["../../../../../src/composables/useTheme/useTheme.ts"],"sourcesContent":["import { getCurrentInstance, propsFactory } from '@cds/core';\nimport { IN_BROWSER, mergeDeep } from '@cds/utils';\nimport { type App, computed, inject, type PropType, provide, ref, shallowRef, unref, watch, watchEffect } from 'vue';\n\nimport { DEFAULT_THEME, ThemeSymbol } from './internal/useTheme.constants';\nimport type { InternalThemeDefinition, Theme, ThemeInstance, ThemeOptions } from './internal/useTheme.types';\nimport {\n  createCssClass,\n  generateCssVariables,\n  generateOnColors,\n  generateVariations,\n  parseThemeOptions,\n  upsertStyles\n} from './internal/useTheme.utils';\n\n/**\n * Defines props related to theming for a Vue component.\n *\n * The `defineThemeProps` variable facilitates the creation of a property configuration\n * to manage the component's theme. It provides flexibility to set a theme either as a\n * predefined object or as a string-based theme identifier.\n */\nexport const defineThemeProps = propsFactory(\n  {\n    /** Тема компонента */\n    theme: {\n      type: String as PropType<Theme | string>,\n      default: undefined\n    }\n  },\n  'theme'\n);\n\n/**\n * Creates a theme instance with support for generating color variations,\n * CSS classes, and dynamic theme installation in a Vue application.\n *\n * @param {ThemeOptions} [options] - Configuration options for the theme, including default theme name, themes, variations, and other settings.\n * @return {ThemeInstance & { install: (app: App) => void }} An object containing the theme instance properties, computed values, and an `install` function for integrating with a Vue app.\n */\nexport function createTheme(options?: ThemeOptions): ThemeInstance & { install: (app: App) => void } {\n  const parsedOptions = parseThemeOptions(options);\n  const _name = ref(parsedOptions.defaultTheme);\n  const themes = ref(parsedOptions.themes);\n  const systemName = shallowRef(DEFAULT_THEME);\n\n  const name = computed({\n    get() {\n      return _name.value === 'system' ? systemName.value : _name.value;\n    },\n    set(val: string) {\n      _name.value = val;\n    }\n  });\n\n  const computedThemes = computed(() => {\n    const acc: Record<string, InternalThemeDefinition> = {};\n\n    for (const [name, original] of Object.entries(unref(themes))) {\n      const defaultTheme = original.dark || name === 'dark' ? unref(themes).cdsDark : unref(themes).cdsLight;\n\n      const merged = mergeDeep(defaultTheme, original) as InternalThemeDefinition;\n\n      const colors = {\n        ...merged.colors,\n        ...generateVariations(merged.colors, parsedOptions.variations)\n      };\n\n      acc[name] = {\n        ...merged,\n        colors: {\n          ...colors,\n          ...generateOnColors(colors, merged.variables)\n        }\n      };\n    }\n\n    return acc;\n  });\n\n  const current = computed(() => unref(computedThemes)[unref(name)]);\n\n  // const isSystem = toRef(() => _name.value === 'system');\n\n  const styles = computed(() => {\n    const lines: string[] = [];\n\n    lines.push('@layer theme-base {\\n');\n\n    if (unref(current).dark) {\n      createCssClass(lines, ':root', ['color-scheme: dark'], parsedOptions.scope);\n    }\n\n    createCssClass(lines, ':root', generateCssVariables(unref(current), parsedOptions.prefix), parsedOptions.scope);\n\n    for (const [themeName, theme] of Object.entries(unref(computedThemes))) {\n      createCssClass(\n        lines,\n        `.${parsedOptions.prefix}-theme--${themeName}`,\n        [`color-scheme: ${theme.dark ? 'dark' : 'normal'}`, ...generateCssVariables(theme, parsedOptions.prefix)],\n        parsedOptions.scope\n      );\n    }\n\n    lines.push('}\\n');\n\n    if (parsedOptions.utilities) {\n      const bgLines: string[] = [];\n      const fgLines: string[] = [];\n\n      const colors = new Set(Object.values(unref(computedThemes)).flatMap((theme) => Object.keys(theme.colors)));\n\n      for (const key of colors) {\n        if (/^on-[a-z]/.test(key)) {\n          createCssClass(fgLines, `.${key}`, [`color: rgb(var(--${parsedOptions.prefix}-color-${key})) !important`]);\n        } else {\n          if (parsedOptions.legacyClasses) {\n            createCssClass(bgLines, `.${parsedOptions.prefix}-bg-${key}`, [\n              `--${parsedOptions.prefix}-color-overlay-multiplier: var(--${parsedOptions.prefix}-color-${key}-overlay-multiplier)`,\n              `background-color: rgb(var(--${parsedOptions.prefix}-color-${key})) !important`,\n              `color: rgb(var(--${parsedOptions.prefix}-color-on-${key})) !important`\n            ]);\n            createCssClass(fgLines, `.${parsedOptions.prefix}-text-${key}`, [\n              `color: rgb(var(--${parsedOptions.prefix}-color-${key})) !important`\n            ]);\n            createCssClass(fgLines, `.${parsedOptions.prefix}-border-${key}`, [\n              `border-color: rgb(var(--${parsedOptions.prefix}-color-${key}))`\n            ]);\n          }\n        }\n      }\n\n      lines.push(\n        '@layer theme-background {\\n',\n        ...bgLines.map((v) => `  ${v}`),\n        '}\\n',\n        '@layer theme-foreground {\\n',\n        ...fgLines.map((v) => `  ${v}`),\n        '}\\n'\n      );\n    }\n\n    return '@layer cds-utilities {\\n' + lines.map((v) => `  ${v}`).join('') + '\\n}';\n  });\n\n  function getHead() {\n    return {\n      style: [\n        {\n          children: unref(styles),\n          id: parsedOptions.stylesheetId,\n          nonce: parsedOptions.cspNonce || (false as never)\n        }\n      ]\n    };\n  }\n\n  function install(app: App) {\n    if (parsedOptions.isDisabled) return;\n\n    const head = app._context.provides.usehead;\n\n    if (head) {\n      if (head.push) {\n        const entry = head.push(getHead);\n\n        if (IN_BROWSER) {\n          watch(styles, () => entry.patch(getHead));\n        }\n      } else {\n        if (IN_BROWSER) {\n          head.addHeadObjs(computed(getHead));\n          watchEffect(() => head.updateDOM());\n        } else {\n          head.addHeadObjs(getHead());\n        }\n      }\n    } else {\n      if (IN_BROWSER) {\n        watch(styles, updateStyles, { immediate: true });\n      } else {\n        updateStyles();\n      }\n\n      function updateStyles() {\n        upsertStyles(parsedOptions.stylesheetId, parsedOptions.cspNonce, styles.value);\n      }\n    }\n  }\n\n  const themeClasses = computed(() => (parsedOptions.isDisabled ? undefined : `cds-theme--${unref(name)}`));\n\n  return {\n    install,\n    isDisabled: parsedOptions.isDisabled,\n    name,\n    themes,\n    current,\n    computedThemes,\n    themeClasses,\n    styles,\n    global: {\n      name,\n      current\n    }\n  };\n}\n\n/**\n * Provides a theme to the current component and its descendants.\n *\n * This method injects an existing theme instance, validates its existence, and creates\n * a new extended theme instance with additional properties based on the provided or\n * inherited theme configuration. The new theme is then provided to the component's\n * context for usage in child components.\n *\n * @param {Object} props - Configuration options for the theme.\n * @param {string} [props.theme] - A string representing the name of the theme to be applied. If not provided, the theme is inherited from the injected theme instance.\n * @return {ThemeInstance} The newly created theme instance with updated properties, which includes the computed name, current theme object, and the theme's CSS class.\n */\nexport function provideTheme(props: { theme?: string }) {\n  getCurrentInstance('provideTheme');\n\n  const theme = inject(ThemeSymbol, null);\n\n  if (!theme) throw new Error('[CDS] Could not find CDS theme injection');\n\n  const name = computed<string>(() => {\n    return props.theme ?? unref(theme.name);\n  });\n  const current = computed(() => unref(theme.themes)[unref(name)]);\n\n  const themeClasses = computed(() => (theme.isDisabled ? undefined : `cds-theme--${unref(name)}`));\n\n  const newTheme: ThemeInstance = {\n    ...theme,\n    name,\n    current,\n    themeClasses\n  };\n\n  provide(ThemeSymbol, newTheme);\n\n  return newTheme;\n}\n\n/**\n * A function to retrieve the current theme object from the Vue context. This function relies on\n * Vue's dependency injection system to provide the theme associated with the current component.\n * If the theme cannot be found, it throws an error.\n *\n * @return {Object} The injected theme object associated with the current Vue context.\n * @throws {Error} If the theme injection cannot be found in the current context.\n */\nexport function useTheme() {\n  getCurrentInstance('useTheme');\n\n  const theme = inject(ThemeSymbol, null);\n\n  if (!theme) throw new Error('[CDS] Could not find theme injection');\n\n  return theme;\n}\n"],"names":["name"],"mappings":"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"}
+{"version":3,"file":"useTheme.js","sources":["../../../../../src/composables/useTheme/useTheme.ts"],"sourcesContent":["import { getCurrentInstance, propsFactory } from '@cds/core';\nimport { IN_BROWSER, mergeDeep } from '@cds/utils';\nimport { type App, computed, inject, type PropType, provide, ref, shallowRef, unref, watch, watchEffect } from 'vue';\n\nimport { DEFAULT_THEME, ThemeSymbol } from './internal/useTheme.constants';\nimport type { InternalThemeDefinition, Theme, ThemeInstance, ThemeOptions } from './internal/useTheme.types';\nimport {\n  createCssClass,\n  generateCssVariables,\n  generateOnColors,\n  generateVariations,\n  parseThemeOptions,\n  upsertStyles\n} from './internal/useTheme.utils';\n\n/**\n * Defines props related to theming for a Vue component.\n *\n * The `defineThemeProps` variable facilitates the creation of a property configuration\n * to manage the component's theme. It provides flexibility to set a theme either as a\n * predefined object or as a string-based theme identifier.\n */\nexport const defineThemeProps = propsFactory(\n  {\n    /**\n     * Тема компонента\n     * @en Component theme\n     */\n    theme: {\n      type: String as PropType<Theme | string>,\n      default: undefined\n    }\n  },\n  'theme'\n);\n\n/**\n * Creates a theme instance with support for generating color variations,\n * CSS classes, and dynamic theme installation in a Vue application.\n *\n * @param {ThemeOptions} [options] - Configuration options for the theme, including default theme name, themes, variations, and other settings.\n * @return {ThemeInstance & { install: (app: App) => void }} An object containing the theme instance properties, computed values, and an `install` function for integrating with a Vue app.\n */\nexport function createTheme(options?: ThemeOptions): ThemeInstance & { install: (app: App) => void } {\n  const parsedOptions = parseThemeOptions(options);\n  const _name = ref(parsedOptions.defaultTheme);\n  const themes = ref(parsedOptions.themes);\n  const systemName = shallowRef(DEFAULT_THEME);\n\n  const name = computed({\n    get() {\n      return _name.value === 'system' ? systemName.value : _name.value;\n    },\n    set(val: string) {\n      _name.value = val;\n    }\n  });\n\n  const computedThemes = computed(() => {\n    const acc: Record<string, InternalThemeDefinition> = {};\n\n    for (const [name, original] of Object.entries(unref(themes))) {\n      const defaultTheme = original.dark || name === 'dark' ? unref(themes).cdsDark : unref(themes).cdsLight;\n\n      const merged = mergeDeep(defaultTheme, original) as InternalThemeDefinition;\n\n      const colors = {\n        ...merged.colors,\n        ...generateVariations(merged.colors, parsedOptions.variations)\n      };\n\n      acc[name] = {\n        ...merged,\n        colors: {\n          ...colors,\n          ...generateOnColors(colors, merged.variables)\n        }\n      };\n    }\n\n    return acc;\n  });\n\n  const current = computed(() => unref(computedThemes)[unref(name)]);\n\n  // const isSystem = toRef(() => _name.value === 'system');\n\n  const styles = computed(() => {\n    const lines: string[] = [];\n\n    lines.push('@layer theme-base {\\n');\n\n    if (unref(current).dark) {\n      createCssClass(lines, ':root', ['color-scheme: dark'], parsedOptions.scope);\n    }\n\n    createCssClass(lines, ':root', generateCssVariables(unref(current), parsedOptions.prefix), parsedOptions.scope);\n\n    for (const [themeName, theme] of Object.entries(unref(computedThemes))) {\n      createCssClass(\n        lines,\n        `.${parsedOptions.prefix}-theme--${themeName}`,\n        [`color-scheme: ${theme.dark ? 'dark' : 'normal'}`, ...generateCssVariables(theme, parsedOptions.prefix)],\n        parsedOptions.scope\n      );\n    }\n\n    lines.push('}\\n');\n\n    if (parsedOptions.utilities) {\n      const bgLines: string[] = [];\n      const fgLines: string[] = [];\n\n      const colors = new Set(Object.values(unref(computedThemes)).flatMap((theme) => Object.keys(theme.colors)));\n\n      for (const key of colors) {\n        if (/^on-[a-z]/.test(key)) {\n          createCssClass(fgLines, `.${key}`, [`color: rgb(var(--${parsedOptions.prefix}-color-${key})) !important`]);\n        } else {\n          if (parsedOptions.legacyClasses) {\n            createCssClass(bgLines, `.${parsedOptions.prefix}-bg-${key}`, [\n              `--${parsedOptions.prefix}-color-overlay-multiplier: var(--${parsedOptions.prefix}-color-${key}-overlay-multiplier)`,\n              `background-color: rgb(var(--${parsedOptions.prefix}-color-${key})) !important`,\n              `color: rgb(var(--${parsedOptions.prefix}-color-on-${key})) !important`\n            ]);\n            createCssClass(fgLines, `.${parsedOptions.prefix}-text-${key}`, [\n              `color: rgb(var(--${parsedOptions.prefix}-color-${key})) !important`\n            ]);\n            createCssClass(fgLines, `.${parsedOptions.prefix}-border-${key}`, [\n              `border-color: rgb(var(--${parsedOptions.prefix}-color-${key}))`\n            ]);\n          }\n        }\n      }\n\n      lines.push(\n        '@layer theme-background {\\n',\n        ...bgLines.map((v) => `  ${v}`),\n        '}\\n',\n        '@layer theme-foreground {\\n',\n        ...fgLines.map((v) => `  ${v}`),\n        '}\\n'\n      );\n    }\n\n    return '@layer cds-utilities {\\n' + lines.map((v) => `  ${v}`).join('') + '\\n}';\n  });\n\n  function getHead() {\n    return {\n      style: [\n        {\n          children: unref(styles),\n          id: parsedOptions.stylesheetId,\n          nonce: parsedOptions.cspNonce || (false as never)\n        }\n      ]\n    };\n  }\n\n  function install(app: App) {\n    if (parsedOptions.isDisabled) return;\n\n    const head = app._context.provides.usehead;\n\n    if (head) {\n      if (head.push) {\n        const entry = head.push(getHead);\n\n        if (IN_BROWSER) {\n          watch(styles, () => entry.patch(getHead));\n        }\n      } else {\n        if (IN_BROWSER) {\n          head.addHeadObjs(computed(getHead));\n          watchEffect(() => head.updateDOM());\n        } else {\n          head.addHeadObjs(getHead());\n        }\n      }\n    } else {\n      if (IN_BROWSER) {\n        watch(styles, updateStyles, { immediate: true });\n      } else {\n        updateStyles();\n      }\n\n      function updateStyles() {\n        upsertStyles(parsedOptions.stylesheetId, parsedOptions.cspNonce, styles.value);\n      }\n    }\n  }\n\n  const themeClasses = computed(() => (parsedOptions.isDisabled ? undefined : `cds-theme--${unref(name)}`));\n\n  return {\n    install,\n    isDisabled: parsedOptions.isDisabled,\n    name,\n    themes,\n    current,\n    computedThemes,\n    themeClasses,\n    styles,\n    global: {\n      name,\n      current\n    }\n  };\n}\n\n/**\n * Provides a theme to the current component and its descendants.\n *\n * This method injects an existing theme instance, validates its existence, and creates\n * a new extended theme instance with additional properties based on the provided or\n * inherited theme configuration. The new theme is then provided to the component's\n * context for usage in child components.\n *\n * @param {Object} props - Configuration options for the theme.\n * @param {string} [props.theme] - A string representing the name of the theme to be applied. If not provided, the theme is inherited from the injected theme instance.\n * @return {ThemeInstance} The newly created theme instance with updated properties, which includes the computed name, current theme object, and the theme's CSS class.\n */\nexport function provideTheme(props: { theme?: string }) {\n  getCurrentInstance('provideTheme');\n\n  const theme = inject(ThemeSymbol, null);\n\n  if (!theme) throw new Error('[CDS] Could not find CDS theme injection');\n\n  const name = computed<string>(() => {\n    return props.theme ?? unref(theme.name);\n  });\n  const current = computed(() => unref(theme.themes)[unref(name)]);\n\n  const themeClasses = computed(() => (theme.isDisabled ? undefined : `cds-theme--${unref(name)}`));\n\n  const newTheme: ThemeInstance = {\n    ...theme,\n    name,\n    current,\n    themeClasses\n  };\n\n  provide(ThemeSymbol, newTheme);\n\n  return newTheme;\n}\n\n/**\n * A function to retrieve the current theme object from the Vue context. This function relies on\n * Vue's dependency injection system to provide the theme associated with the current component.\n * If the theme cannot be found, it throws an error.\n *\n * @return {Object} The injected theme object associated with the current Vue context.\n * @throws {Error} If the theme injection cannot be found in the current context.\n */\nexport function useTheme() {\n  getCurrentInstance('useTheme');\n\n  const theme = inject(ThemeSymbol, null);\n\n  if (!theme) throw new Error('[CDS] Could not find theme injection');\n\n  return theme;\n}\n"],"names":["name"],"mappings":"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"}

package/dist/es/src/composables/useTransition/useTransition.js

@@ -22,7 +22,10 @@ const easingPatterns = {
 };
 const defineTransitionProps = propsFactory(
   {
-    /** Анимация перехода */
+    /**
+     * Анимация перехода
+     * @en Transition animation
+     */
     transition: {
       type: null,
       default: "fade-transition",