ژست هرگز تنها راه انجام یک کار نیست. هر ژست TDS یک قرارداد ماشین‌خوان دارد و هر هوک آن معادل کیبورد، صفحه‌خوان و دسکتاپ را اجباری می‌کند.
قواعد ثابتی که هیچ تم یا محصولی نمی‌تواند تضعیف کند.
خروجی مستقیم gestureContracts — همان چیزی که MCP و تست‌ها می‌خوانند.
| ژست | شناسه | وضعیت | اشارگر | ورودی | جهت |
|---|---|---|---|---|---|
| ضربه | کپی کد | رفتار پلتفرم | 1 | touch، pen، mouse | — |
| سوایپ | کپی کد | هوک رسمی | 1 | touch، pen، mouse | 4 جهت |
| کشیدن | کپی کد | فقط قرارداد | 1 | touch، pen، mouse | 4 جهت |
| فشار طولانی | کپی کد | هوک رسمی | 1 | touch، pen، mouse | — |
| کشیدن برای بازخوانی | کپی کد | هوک رسمی | 1 | touch، pen | 1 جهت |
| بزرگ‌نمایی با دو انگشت | کپی کد | هوک رسمی | 2 | touch، pen | — |
| چرخش با دو انگشت | کپی کد | هوک رسمی | 2 | touch، pen | — |
یک بار در GESTURE_DEFAULTS تعریف می‌شوند؛ با توکن --tds-gesture-* روی هر عنصر بازنویسی‌پذیرند.
| آستانه | پیش‌فرض | توکن بازنویسی |
|---|---|---|
| کپی کد | 8 px | کپی کد |
| کپی کد | 48 px | کپی کد |
| کپی کد | 0.45 px/ms | کپی کد |
| کپی کد | 500 ms | کپی کد |
| کپی کد | 72 px | کپی کد |
تم و محصول فقط گزینه‌های whitelist شدهٔ این schema را تنظیم می‌کنند. مقدار نامعتبر رد و diagnostic می‌دهد؛ معادل کیبورد قابل حذف نیست.
| کامپوننت | ژست‌های مجاز | ژست پایه | گزینه‌ها |
|---|---|---|---|
| کپی کد | tap، swipe، pinch، rotate | pinch، rotate | enablePinch, enableRotate, minScale, maxScale, scaleStep, rotateStepDeg |
| کپی کد | tap، swipe، long-press | — | swipeDistancePx, longPressMs |
| کپی کد | pull-to-refresh | pull-to-refresh | pullThresholdPx |
import { assertValidGesturePolicy } from '@tokapps/gestures';// در build/test: هر کلید یا مقدار نامعتبر خطا می‌دهدconst policy = assertValidGesturePolicy({ component: 'gallery', options: { maxScale: 6, rotateStepDeg: 45 },});// policy.keyboardEquivalent === 'required' — قابل حذف نیستimport { useSwipe } from '@tokapps/gestures';function MessageRow({ id, title, remove }: { id: string; title: string; remove: (id: string) => void }) { const swipe = useSwipe({ direction: 'inline-start', // در RTL یعنی به راست onSwipe: () => remove(id), alternative: { label: `حذف: ${title}`, perform: () => remove(id) }, // الزامی }); return ( <li {...swipe.bind} tabIndex={0}> {title} <button {...swipe.getFallbackProps()}>حذف</button> {/* رندر آن اجباری است */} </li> );}این ژست‌ها هنوز هوک ندارند و ادعا نمی‌شوند؛ پیش از افزودن، قرارداد و تست لازم است (ARCH.md §13).