@xsolla/xui-input 0.174.3 → 0.176.0

package/README.md

@@ -1,6 +1,52 @@
 # Input
 
 A cross-platform text input with label, error, icon, clear and validation support; works on web and React Native via `XUIProvider` themed contexts.
+<!-- BEGIN:xui-mcp-instructions:input -->
+An interactive field that lets users enter, edit, or review information. Inputs communicate what kind of data is expected and help users provide the information needed to complete tasks, make updates, or refine content across the product.
+
+### When to use
+
+When you need to collect a short, freeform text value from a user (name, email, search query, etc.)
+- When the expected input fits on a single line
+- As part of a larger form alongside other controls
+
+### When not to use
+
+- When the expected input spans multiple lines — use a TextArea instead
+- When the user must pick from a predefined list — use a Select, MultiSelect or Autocomplete instead
+- When the value is numeric with constraints — use a InputPhone or InputRange instead
+- When the value is card number — use a InputPayment instead
+- When the value is time or date — use a InputTime or DatePicker instead
+- When the value is pin code — use a InputPin instead
+
+### Content guidelines
+
+Do not use the placeholder as a substitute for a label.
+
+Placeholder text should describe the expected format or example value (e.g. *"Enter your email"*, *"DD/MM/YYYY"*), not repeat the label.
+
+Error messages should be constructive: explain what is wrong and how to correct it (e.g. *"Email is required"*, not just *"Invalid input"*).
+
+Remove button should appear only when the field has a value, giving users a quick way to clear it.
+
+Check icon should appear after successful validation to confirm the value is accepted.
+
+### Behavior guidelines
+
+Input width — fields should reflect the expected content length; avoid overly wide fields for short values like ZIP code, OTP, or CVV unless the layout requires it.
+
+Validation timing — do not show errors before a user has interacted with the field. Validate on blur, on submit, or progressively while typing only when it meaningfully helps.
+
+Error state — preserve the user’s entered value, show error text close to the field, and do not rely on color alone to communicate the problem.
+
+### Accessibility
+
+Error messages must be linked to the input via `aria-describedby` so screen readers announce them on focus.
+
+Never rely on placeholder text alone to communicate the field's purpose — it disappears on input and has low contrast by default.
+
+Disabled fields should not receive keyboard focus; consider using a read-only state if the value still needs to be accessible.
+<!-- END:xui-mcp-instructions:input -->
 
 ## Installation
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xsolla/xui-input",
-  "version": "0.174.3",
+  "version": "0.176.0",
   "main": "./web/index.js",
   "module": "./web/index.mjs",
   "types": "./web/index.d.ts",
@@ -13,9 +13,9 @@
     "test:coverage": "vitest run --coverage"
   },
   "dependencies": {
-    "@xsolla/xui-core": "0.174.3",
-    "@xsolla/xui-icons-base": "0.174.3",
-    "@xsolla/xui-primitives-core": "0.174.3"
+    "@xsolla/xui-core": "0.176.0",
+    "@xsolla/xui-icons-base": "0.176.0",
+    "@xsolla/xui-primitives-core": "0.176.0"
   },
   "peerDependencies": {
     "react": ">=16.8.0",