v2.2.3

Author: NeoXider

DOCUMENTATION_INDEX.md

@@ -119,7 +119,9 @@
 #### [docs/text_input.md](docs/text_input.md)
 **Поле ввода текста**
 - TextInput(Button), placeholder, value, max_length
-- on_change, on_submit, Enter/Escape/TEXTINPUT
+- **Типы поля:** input_type ("text" | "int" | "float"), min_val, max_val; для int/float — валидация и фильтрация при вставке
+- on_change, on_submit, Enter/Escape, **Ctrl+V** (вставка), **Ctrl+C** (копирование поля)
+- Парсинг чисел: модуль **spritePro.input_validation** (parse_input_value, can_add_char, filter_chars_for_paste)
 - activate/deactivate, handle_event
 
 #### [docs/text.md](docs/text.md)

docs/API_REFERENCE.md

@@ -115,6 +115,32 @@ validate_dict(
 )
 ```
 
+## Поля ввода (input_validation)
+
+Модуль `spritePro.input_validation` — типизированный ввод и парсинг для текстовых полей (TextInput и редактор сцен). Типы: **text**, **int**, **float**.
+
+### `InputType`
+Тип-алиас: `Literal["text", "int", "float"]`.
+
+### `can_add_char(input_type, current, ch, allowed_text_chars=None)`
+Проверяет, можно ли добавить символ `ch` в строку `current` для данного типа поля. Для `"text"` при `allowed_text_chars=None` допускаются любые печатные символы; если передано множество символов — только они (например, для поля «имя» в редакторе).
+
+### `filter_chars_for_paste(input_type, text, allowed_text_chars=None)`
+Фильтрует строку `text` (например из буфера обмена), оставляя только допустимые для типа поля символы. Для int — цифры и один минус в начале; для float — цифры, минус, одна точка.
+
+### `parse_input_value(input_type, raw, min_val=None, max_val=None)`
+Парсит строку в значение. Возвращает `(ok: bool, value: Any)` — для int/float значение с учётом min_val/max_val, для text — `raw.strip()`. При ошибке парсинга — `(False, None)`.
+
+**Пример:**
+```python
+from spritePro.input_validation import parse_input_value, InputType
+
+ok, num = parse_input_value("int", "42", 0, 100)  # (True, 42)
+ok, x = parse_input_value("float", "3.14", 0.0, 10.0)  # (True, 3.14)
+```
+
+---
+
 ## Система плагинов
 
 ### `PluginManager`

docs/text_input.md

@@ -1,12 +1,13 @@
 # TextInput
 
-Поле ввода текста на базе Button. Наследует от Button, при клике переходит в режим ввода (focus); поддерживает `pygame.TEXTINPUT`, Enter (подтверждение) и Escape (сброс фокуса).
+Поле ввода текста на базе Button. Наследует от Button, при клике переходит в режим ввода (focus); поддерживает типы **text** / **int** / **float**, `pygame.TEXTINPUT`, Enter (подтверждение), Escape (сброс фокуса), **Ctrl+V** (вставка) и **Ctrl+C** (копирование содержимого поля).
 
 ## Обзор
 
 - **Наследование**: `TextInput(Button)` — кнопка без анимаций, при клике активирует ввод.
-- **События**: **on_change** — при каждом изменении текста (ввод/удаление символа); **on_submit** — при нажатии Enter (применение/подтверждение).
-- **Обработка в цикле**: обрабатывает клик (фокус/сброс), `KEYDOWN` (Enter, Escape, Backspace, цифровая клавиатура), `TEXTINPUT` (символы); события берутся из `spritePro.pygame_events` в `update()`.
+- **Тип поля**: `input_type`: **"text"** (любой печатный текст), **"int"** (целые числа), **"float"** (дробные). Для int/float некорректные символы не вводятся и отфильтровываются при вставке; при необходимости задают границы `min_val` / `max_val`.
+- **События**: **on_change** — при каждом изменении текста; **on_submit** — при нажатии Enter.
+- **Обработка в цикле**: обрабатывает клик, `KEYDOWN` (Enter, Escape, Backspace, Ctrl+V/Ctrl+C, цифровая клавиатура), `TEXTINPUT`; события из `spritePro.pygame_events` в `update()`.
 
 ## Параметры конструктора
 
@@ -17,19 +18,31 @@
 | `placeholder` | str | "" | Текст-подсказка при пустом значении |
 | `value` | str | "" | Начальное значение |
 | `max_length` | int | 128 | Максимальная длина |
-| `on_change` | Callable[[str], None] | None | Вызывается при каждом изменении текста (ввод/удаление символа) |
-| `on_submit` | Callable[[str], None] | None | Вызывается при нажатии Enter (применение/подтверждение) |
+| `input_type` | "text" \| "int" \| "float" | "text" | Тип поля: текст, целое или дробное число |
+| `min_val` | float \| None | None | Нижняя граница для int/float (при парсинге) |
+| `max_val` | float \| None | None | Верхняя граница для int/float (при парсинге) |
+| `on_change` | Callable[[str], None] | None | Вызывается при каждом изменении текста |
+| `on_submit` | Callable[[str], None] | None | Вызывается при нажатии Enter |
 | `text_color` | (int,int,int) | (200,200,200) | Цвет текста |
 | `bg_color` | (int,int,int) | (45,45,52) | Цвет фона |
 | `active_bg_color` | (int,int,int) | (55,55,62) | Цвет фона при фокусе |
 | `font_size` | int | 18 | Размер шрифта |
 | `sorting_order` | int | 1000 | Слой отрисовки |
 | `scene` | Scene \| str \| None | None | Сцена |
 
+## Типы поля (input_type)
+
+- **text** — допускаются любые печатные символы, пробел и табуляция. Подходит для имён, сообщений.
+- **int** — только цифры и один минус в начале. Точка и запятая не вводятся; при вставке из буфера лишние символы отфильтровываются.
+- **float** — цифры, один минус в начале, одна десятичная точка (запятая при вставке заменяется на точку).
+
+Для числовых полей при применении (например в `on_submit`) удобно парсить значение через модуль **spritePro.input_validation**: `parse_input_value(input_type, raw, min_val, max_val)` возвращает `(ok, value)`.
+
 ## Пример
 
 ```python
 import spritePro as s
+from spritePro.input_validation import parse_input_value
 
 class FormScene(s.Scene):
     def __init__(self):
@@ -44,12 +57,26 @@ class FormScene(s.Scene):
             on_submit=self._on_submit,
             scene=self,
         )
+        self.num_input = s.TextInput(
+            pos=(s.WH_C.x, 260),
+            value="0",
+            input_type="int",
+            min_val=0,
+            max_val=100,
+            on_submit=self._on_number_submit,
+            scene=self,
+        )
 
     def _on_change(self, value: str) -> None:
         print("Текст:", value)
 
     def _on_submit(self, value: str) -> None:
         print("Отправлено:", value)
+
+    def _on_number_submit(self, value: str) -> None:
+        ok, num = parse_input_value("int", value, 0, 100)
+        if ok and num is not None:
+            print("Число:", num)
 ```
 
 ## События: изменение и применение
@@ -64,7 +91,9 @@ class FormScene(s.Scene):
 - **Enter** — сброс фокуса и вызов `on_submit(value)`.
 - **Escape** — сброс фокуса без вызова `on_submit`.
 - **Backspace** — удаление последнего символа.
-- **TEXTINPUT** и цифровая клавиатура — добавление символов (с учётом `max_length`).
+- **Ctrl+V** (Cmd+V на Mac) — вставка из буфера обмена; для int/float вставляются только допустимые символы.
+- **Ctrl+C** (Cmd+C на Mac) — копирование содержимого поля в буфер обмена.
+- **TEXTINPUT** и цифровая клавиатура — добавление символов (для int/float только допустимые, с учётом `max_length`).
 
 ## Методы
 
@@ -78,3 +107,4 @@ class FormScene(s.Scene):
 - [Button](button.md) — базовая кнопка.
 - [Slider](slider.md) — слайдер.
 - [Input](input.md) — состояние клавиш и мыши.
+- Модуль **spritePro.input_validation** — `InputType`, `can_add_char`, `filter_chars_for_paste`, `parse_input_value` для типизированного ввода и парсинга (используется TextInput и редактором сцен).

spritePro/editor/ui/input_handling.py

@@ -1,14 +1,17 @@
-"""Обработка ввода: текстовые поля с типами text / int / float."""
+"""Обработка ввода: текстовые поля с типами text / int / float (редактор)."""
 
-from typing import Any, Literal, Optional, Tuple
+from typing import Optional
 
 import pygame
 import string
 
-InputType = Literal["text", "int", "float"]
+from ...input_validation import (
+    InputType,
+    can_add_char as _can_add_char,
+    filter_chars_for_paste as _filter_chars_for_paste,
+    parse_input_value,
+)
 
-ALLOWED_INPUT_CHARS = set("0123456789.,-")
-ALLOWED_INT_CHARS = set("0123456789-")
 ALLOWED_NAME_CHARS = set(string.ascii_letters + string.digits + string.whitespace + "._-()")
 
 KEYPAD_MAP = {
@@ -30,77 +33,16 @@
 }
 
 
-def can_add_char(input_type: InputType, current: str, ch: str) -> bool:
-    if not ch:
-        return False
-    if input_type == "text":
-        return ch in ALLOWED_NAME_CHARS or (ord(ch) >= 0x20 and ch not in "\x00\r\n")
-    if input_type == "int":
-        if ch == "-":
-            return not current or current == "-"
-        return ch in "0123456789"
-    if input_type == "float":
-        if ch == "-":
-            return not current or current == "-"
-        if ch in ".,":
-            return "." not in current.replace("-", "")
-        return ch in "0123456789"
-    return False
-
-
-def filter_chars_for_paste(input_type: InputType, text: str) -> str:
-    if input_type == "text":
-        return "".join(c for c in text if c in ALLOWED_NAME_CHARS or (ord(c) >= 0x20 and c not in "\x00\r\n"))
-    if input_type == "int":
-        out = []
-        for c in text:
-            if c in "0123456789":
-                out.append(c)
-            elif c == "-" and not out:
-                out.append(c)
-        return "".join(out)
-    if input_type == "float":
-        out = []
-        seen_dot = False
-        for c in text:
-            if c in "0123456789":
-                out.append(c)
-            elif c == "-" and not out:
-                out.append(c)
-            elif c in ".," and not seen_dot:
-                out.append(".")
-                seen_dot = True
-        return "".join(out)
-    return ""
-
-
-def parse_input_value(
-    input_type: InputType,
-    raw: str,
-    min_val: Optional[float] = None,
-    max_val: Optional[float] = None,
-) -> Tuple[bool, Any]:
-    raw = raw.strip().replace(",", ".")
-    if not raw or raw == "-":
-        return False, None
-    try:
-        if input_type == "int":
-            value = int(float(raw))
-            if min_val is not None:
-                value = max(int(min_val), value)
-            if max_val is not None:
-                value = min(int(max_val), value)
-            return True, value
-        if input_type == "float":
-            value = float(raw)
-            if min_val is not None:
-                value = max(min_val, value)
-            if max_val is not None:
-                value = min(max_val, value)
-            return True, value
-        return True, raw.strip()
-    except ValueError:
-        return False, None
+def _allowed_for_editor_text(name: str) -> Optional[set]:
+    return ALLOWED_NAME_CHARS if name == "prop_input_name" else None
+
+
+def can_add_char(input_type: InputType, current: str, ch: str, name: str = "") -> bool:
+    return _can_add_char(input_type, current, ch, _allowed_for_editor_text(name) if name else None)
+
+
+def filter_chars_for_paste(input_type: InputType, text: str, name: str = "") -> str:
+    return _filter_chars_for_paste(input_type, text, _allowed_for_editor_text(name) if name else None)
 
 
 def get_active_input_type(editor) -> InputType:
@@ -119,7 +61,7 @@ def _paste_into_editor_buffer(editor, name: str) -> None:
             return
         text = data.decode("utf-8", errors="replace")
         input_type = get_active_input_type(editor)
-        filtered = filter_chars_for_paste(input_type, text)
+        filtered = filter_chars_for_paste(input_type, text, name)
         if filtered:
             editor._text_input_buffers[name] = editor._text_input_buffers.get(name, "") + filtered
     except Exception:
@@ -171,13 +113,13 @@ def handle_text_input_keydown(editor, event: pygame.event.Event) -> bool:
         if event.key in keypad_no_dot and not (event.unicode or ""):
             ch = keypad_no_dot[event.key]
             buf = editor._text_input_buffers.get(name, "")
-            if can_add_char(input_type, buf, ch):
+            if can_add_char(input_type, buf, ch, name):
                 editor._text_input_buffers[name] = buf + ch
             return True
     elif event.key in KEYPAD_MAP and not (event.unicode or ""):
         ch = KEYPAD_MAP[event.key]
         buf = editor._text_input_buffers.get(name, "")
-        if can_add_char(input_type, buf, ch):
+        if can_add_char(input_type, buf, ch, name):
             editor._text_input_buffers[name] = buf + ch
         return True
     return True
@@ -192,7 +134,7 @@ def handle_text_input_text(editor, event: pygame.event.Event) -> bool:
     buf = editor._text_input_buffers.get(name, "")
     added = ""
     for c in (event.text or ""):
-        if can_add_char(input_type, buf + added, c):
+        if can_add_char(input_type, buf + added, c, name):
             added += c
     if added:
         editor._text_input_buffers[name] = buf + added

spritePro/input_validation.py

@@ -0,0 +1,100 @@
+"""Валидация и парсинг полей ввода: типы text / int / float.
+
+Используется компонентом TextInput и редактором сцен.
+"""
+
+from typing import Any, Literal, Optional, Set, Tuple
+
+InputType = Literal["text", "int", "float"]
+
+
+def can_add_char(
+    input_type: InputType,
+    current: str,
+    ch: str,
+    allowed_text_chars: Optional[Set[str]] = None,
+) -> bool:
+    """Можно ли добавить символ ch в текущую строку current для данного типа поля."""
+    if not ch:
+        return False
+    if input_type == "text":
+        if allowed_text_chars is not None:
+            return ch in allowed_text_chars or (ord(ch) >= 0x20 and ch not in "\x00\r\n")
+        return ch.isprintable() or ch in " \t"
+    if input_type == "int":
+        if ch == "-":
+            return not current or current == "-"
+        return ch in "0123456789"
+    if input_type == "float":
+        if ch == "-":
+            return not current or current == "-"
+        if ch in ".,":
+            return "." not in current.replace("-", "")
+        return ch in "0123456789"
+    return False
+
+
+def filter_chars_for_paste(
+    input_type: InputType,
+    text: str,
+    allowed_text_chars: Optional[Set[str]] = None,
+) -> str:
+    """Оставляет в text только допустимые для типа поля символы (для вставки из буфера)."""
+    if input_type == "text":
+        if allowed_text_chars is not None:
+            return "".join(
+                c for c in text
+                if c in allowed_text_chars or (ord(c) >= 0x20 and c not in "\x00\r\n")
+            )
+        return "".join(c for c in text if c.isprintable() or c in " \t")
+    if input_type == "int":
+        out = []
+        for c in text:
+            if c in "0123456789":
+                out.append(c)
+            elif c == "-" and not out:
+                out.append(c)
+        return "".join(out)
+    if input_type == "float":
+        out = []
+        seen_dot = False
+        for c in text:
+            if c in "0123456789":
+                out.append(c)
+            elif c == "-" and not out:
+                out.append(c)
+            elif c in ".," and not seen_dot:
+                out.append(".")
+                seen_dot = True
+        return "".join(out)
+    return ""
+
+
+def parse_input_value(
+    input_type: InputType,
+    raw: str,
+    min_val: Optional[float] = None,
+    max_val: Optional[float] = None,
+) -> Tuple[bool, Any]:
+    """Парсит строку в значение по типу поля. Возвращает (ok, value)."""
+    raw = raw.strip().replace(",", ".")
+    if not raw or raw == "-":
+        return False, None
+    try:
+        if input_type == "int":
+            value = int(float(raw))
+            if min_val is not None:
+                value = max(int(min_val), value)
+            if max_val is not None:
+                value = min(int(max_val), value)
+            return True, value
+        if input_type == "float":
+            value = float(raw)
+            if min_val is not None:
+                value = max(min_val, value)
+            if max_val is not None:
+                value = min(max_val, value)
+            return True, value
+        return True, raw.strip()
+    except ValueError:
+        return False, None