tds.tokapps.com/changelog

تغییرات نسخه‌ها

هر فیچر و اصلاح به بخش در اضافه می‌شود؛ همین متن از ابزار MCP با نام هم در دسترس است.

v0.2.2 · 2026-10-16

feat(tuk): کنترل `ColorPicker` (`controls/color-picker`) با ناحیهٔ اشباع/روشنایی، کشوی رنگ‌مایه و ورودی کد `#rrggbb`؛ خروجی همیشه hex کوچک
feat(editor): رنگ متن با انتخاب‌گر آزاد روی انتخاب (مارک `textColor`، فقط `#rrggbb`، در HTML به `style="color:…"`)
docs(tokens): استثنای رنگ آزاد — انتخاب‌گر رنگ متن رنگ خام کاربر را در محتوا ذخیره می‌کند. این استثنا به درخواست صریح مالک پروژه است و فقط داخل محتوای کاربر است؛ ظاهر رابط همچنان فقط توکن است
fix(editor): ویرایشگر متن غنی دیگر نوار شناور روی انتخاب ندارد؛ جهت پیش‌فرض `rtl`؛ ابزارهای تراز و عنوان در پریست `basic`
feat(editor): اندازهٔ متن با پله‌های توکنی (`sm`…`2xl`) و ضخامت چرخشی با مارک `fontSize`/`fontWeight`
feat(tuk): کامپوننت `VideoPlayer` (`@tokapps/tuk/media`) با منابع فایل مستقیم، استوریج (نشانی امضاشده)، یوتیوب، آپارات و ویدیوی رمزشده؛ حالت درون‌صفحه، شناور قابل کشیدن و زیرنویس WebVTT
feat(tuk): نوار کنترل ویدیو روی خود کادر (الگوی یوتیوب) با آیکون‌های SVG اینلاین، کشوی صدا و روشنایی، نوار پیشرفت نازک و پنهان‌شدن خودکار؛ درون‌صفحه بدون قاب
feat(tuk): ژست‌های ویدیو — لبهٔ چپ روشنایی، لبهٔ راست صدای ویدیو، کشیدن افقی جلو/عقب — هر کدام با معادل کیبورد و سیاست `gestures`
feat(tuk): ویدیوی رمزشده با مانیفست قطعه‌ها و کلید AES-GCM؛ رمزگشایی با WebCrypto و پخش با MediaSource (`startEncryptedPlayback`)
feat(tuk): `openVideoOnDock` ویدیو را در برگهٔ داک (`openDockSheet`) باز می‌کند؛ شناورسازی داخل داک خاموش است
feat(editor): بلوک ویدیو با نمای `VideoPlayer` و پارامتر ویدیو (`videoBlock`)؛ `<video>` خام حذف شد
feat(tokens): توکن‌های `video-player.css` (`--tds-video-*`)
feat(docs): صفحهٔ `/components/video-player` با نمونهٔ زنده، کد قابل‌کپی برای همهٔ منابع و قالب مانیفست رمزشده
fix(editor): ویرایشگر متن غنی دیگر نوار شناور روی انتخاب متن نشان نمی‌دهد؛ قالب‌بندی فقط از نوار ثابت
fix(editor): جهت پیش‌فرض ویرایشگر متن غنی `rtl` است؛ ابزارهای تراز و عنوان ۱ تا ۳ در پریست `basic` هستند
feat(editor): اندازه متن با پله‌های توکنی (`sm`، `md`، `lg`، `xl`، `2xl`) با ابزارهای «A+» و «A−» و ضخامت چرخشی با مارک `fontWeight` (`regular`، `medium`، `semibold`)؛ در HTML به `data-tds-size`/`data-tds-weight` تبدیل می‌شوند
fix(tuk): عنصر بومی `input`/`textarea` داخل `Input` هرگز حاشیه، outline یا هاله نمی‌کشد؛ قبلاً استایل سراسری پروژهٔ مصرف‌کننده روی فیلد، دور خط و دور کانتینر را هم‌زمان می‌کشید. قاب فقط مال کنترل است
style(tokens): چیپ پارامتر با رنگ primary (`--tds-param-chip-*` روی accent) در ویرایشگرهای متن غنی و درون‌خطی؛ چیپ `<Param>` هم همین توکن‌ها را می‌گیرد
fix(tuk): نوار ابزار و گروه‌های آن در عرض کم به چند ردیف می‌شکنند؛ آیکون‌ها بیرون از نوار نمی‌افتند
fix(editor): بلوک پخش صوت در پیش‌نمایش و ویرایش همیشه دکمهٔ «پخش روی داک» دارد؛ بدون منبع غیرفعال و با دلیل نمایش داده می‌شود
feat(editor): کلید «پیش‌نمایش» در ویرایشگر درون‌خطی (`InlineEditor`) و کامپوننت مشترک `PreviewToggle`
feat(editor): دکمهٔ «پیش‌نمایش» در نوار ابزار ویرایشگر؛ نمایش فقط‌خواندنی همان سند با بلوک پخش صوت و مقدار زندهٔ پارامترها
feat(editor): بلوک پخش صوت مدت (m:ss) نشان می‌دهد؛ در پیش‌نمایش چیپ پارامتر به‌جای برچسب، مقدار زنده را نشان می‌دهد
feat(api): بذر نمونه‌پارامترهای صوتی `audio.intro` و `audio.episode` (`params.seed.ts`) با فایل‌های `/samples/*.wav`
docs(params): راهنمای انواع پارامتر، تنظیم و تایپ صوت، تفاوت پارامتر با ابزار ثابت ویرایشگر، و انتقال داده به ویرایشگر و فرم‌ها
fix(editor): نوار شناور انتخاب (SelectionBubble) پیش از اجرای دکمه‌ها با blur ویرایشگر پنهان می‌شد؛ اکنون mousedown آن لغو می‌شود تا ابزارها روی انتخاب متن و تصویر کار کنند
style(editor): کد درون‌خطی در ویرایشگر با توکن‌های `--tds-inline-code-*` نمایش داده می‌شود و بلوک کد را دیگر به‌عنوان چیپ نمی‌بیند
feat(tokens): قرارداد پارامترهای داینامیک `@tokapps/tokens/params` (تعریف، اعتبارسنجی، قالب‌بندی، resolver، JSON Schema)
feat(api): ماژول `dynamic-params` با CRUD، revision و ETag، تاریخچه، ایمپورت گروهی، بارگذاری رسانه و کلیدهای سرور MCP
feat(admin): صفحهٔ «پارامترهای داینامیک» در پنل ادمین
feat(tuk): زیرمسیر `@tokapps/tuk/params` با `DynamicParamsProvider`، `Param`، `DynamicText` و `ParamPicker`
feat(editor): پکیج `@tokapps/editor` با `RichTextEditor` و `InlineEditor` روی TipTap (RTL، نوار ابزار محدودشدنی، اعتبارسنج، صدا و ژست opt-in)
feat(editor): مارک‌داون TDS با `{{key}}` و directiveها؛ رفت‌وبرگشت بدون اتلاف؛ رندر HTML با پارامتر زنده و پاک‌سازی URL
feat(editor): رسانه شامل تصویر، ویدیو، فایل و بلوک پخش روی داک (بدون `<audio>` محلی)
feat(theme): هویت حرکتی ویرایشگر در شش تم
feat(mcp): قواعد `editor-kit-required` و `dynamic-params-for-facts` با اعتبارسنج‌های `editor/kit` و `content/dynamic-params`
feat(editor): جاسازی (`embed`) فقط برای میزبان‌های https مجاز؛ جدول ۳×۳؛ تغییر اندازهٔ تصویر با کیبورد؛ نوار شناور روی انتخاب
feat(editor): metadata برای `RichTextEditor` و `InlineEditor`؛ پکیج `@tokapps/editor` در schema و کاتالوگ MCP
fix(editor): نوار شناور انتخاب روی بدنهٔ صفحه با `z-index` توکنی `--tds-z-selection-bubble` (۲۰۰۰، بالاتر از همهٔ لایه‌ها)؛ هیچ خط فوکوس دور متن ویرایشگر کشیده نمی‌شود؛ ویرایشگرها عرض کامل ردیف دارند
feat(editor): `layout="page"` برای سند کامل روی برگهٔ A4 (۲۱۰×۲۹۷ میلی‌متر)؛ `InlineEditor` استایل خودش را واقعاً بارگذاری می‌کند
fix(editor): `InlineEditor` نوار ابزار شناور روی انتخاب متن (پیش‌فرض `toolbar="bubble"`)؛ نوار ثابت با `toolbar="top"`
fix(editor): پارامتر در ویرایشگر به‌صورت باکس با برچسب فارسی و Tooltip (توضیح، مقدار زنده و سینتکس `{{key}}`) نمایش داده می‌شود؛ `params` به Provider چیپ‌ها وصل است
fix(editor): نمونه‌های مستندات فهرست پارامتر، بارگذاری تصویر و صوت (پخش روی داک) دارند؛ تصویر و صوت محلی با `blob:` پیش‌نمایش می‌شوند
fix(editor): `InlineEditor` نوار ابزار فشرده (`toolbar="top"`، پیش‌فرض) نشان می‌دهد و مقدار پیش‌فرض رشته‌ای را بار می‌کند؛ همگام‌سازی پس از ساخت دوباره ویرایشگر در حالت توسعه اصلاح شد
docs: صفحه‌های `/components/rich-text-editor`، `/components/inline-editor` و `/foundations/dynamic-params`
fix(docs): صفحه‌های گروه، کاتالوگ، تغییرات، الگو و بنیان‌ها عرض سقف‌دار خام (`max-w-*` بدون وسط‌چینی) را برداشتند؛ فهرست گروه با `Grid min` پر می‌شود و فرم نمونه `w-full` است
feat(tdm-mcp): هشدار `responsive/content-width` برای `max-w-*` که بدون `mx-auto`/`w-full`/`Container` کنار محتوا می‌چسبد؛ راهنمای چیدمان در پرامپت پروژهٔ جدید
fix(docs): سایدبار مستندات بعد از هر جابه‌جایی صفحه به گزینهٔ فعال اسکرول می‌کند (به‌جای بازگشت به ابتدای فهرست)
fix(docs): ستون محتوای صفحات مستند تا عرض کامل ناحیهٔ اصلی گسترش می‌یابد (حذف `max-w-3xl` از `app/[[...slug]]/page.tsx`)؛ کارت‌های نمونه دیگر فشرده نمی‌شوند
style(tokens): چک‌باکس و سوییچ روشن با سبک کنش تونال (ته‌رنگ `--tds-accent-subtle` + حاشیه/دستگیره/تیک `--tds-fg-accent`) هم‌خوان با دکمه و آیکون‌دکمه؛ توکن‌های جدید `--tds-checkbox-border-checked` و `--tds-switch-track-border-on`
feat(admin): صفحهٔ «دسترسی MCP» — ثبت برنامه‌نویس با نام، شماره، تاریخ اعتبار و صدور توکن؛ چرخش، غیرفعال‌سازی و آدرس عمومی سرور MCP
feat(admin): صفحهٔ «قواعد پروژه» — پرسونا، فونت‌ها، لوگو و قواعد تکمیلی با علامت اجباری
feat(api): ماژول `mcp-access` با `/admin/mcp/*`، `/public/prompts/:file.md` و `/internal/mcp/*` (گیت‌وی با `MCP_GATEWAY_SECRET`)
feat(mcp): سرور آنلاین سبک `apps/mcp-remote` با احراز توکن و ابزارهای `whoami`، `get_project_rules`، `get_agent_bundle`؛ Docker target `mcp-remote` و سرویس `mcp`/`mcp-remote`
docs(prompts): پرامپت‌های ایجاد و مهاجرت پروژه با خط اتصال `{{MCP_URL}}` که از آدرس ادمین پر می‌شود
feat(mcp): ابزارهای دانش `tdm-mcp` از طریق سرویس داخلی فقط‌خواندنی (`src/http.ts`، `readOnly` و `create_theme` ثبت‌نشده) به سرور آنلاین پروکسی می‌شوند؛ هیچ پورت عمومی ندارد
docs(architecture): `docs/architecture/mcp-remote.md` با توپولوژی، یوزکیس‌ها و توالی‌ها (Mermaid)
feat(docs): کلید کپی روی عنوان هر نسخه در صفحهٔ `/changelog` (کپی عنوان و فهرست تغییرات به‌صورت Markdown)
feat(docs): نمونه‌های زنده در صفحه‌های دسته‌بندی کامپوننت‌ها (بازخورد، نمایش داده و بقیه) زیر هر کامپوننت
feat(tuk): نمونه‌های رندرشدنی `CodeBlock`، `InlineCode`، `Typewriter` و `TypingCodeBlock` برای نمایش زنده در مستندات
style(accordion): ظاهر مینیمال‌تر با هدر فشرده‌تر (فونت `sm`، فاصلهٔ کمتر، بدون پس‌زمینه و قاب)؛ شعاع از `radius-lg` به `radius-sm` و آیکون `sm`
fix(tuk): نشان دوربین `FileUpload` (variant avatar) روی محیط دایره در ۴۵° قرار گرفت؛ قبلاً در گوشهٔ جعبه بیرون از دایره می‌افتاد
docs(layout): `docs/TDS_LAYOUT_STANDARD.md` استاندارد صفحه‌آرایی (جایگاه آواتار روی لبهٔ کارت، قانون یک تصویر پروفایل در هر نما، بایدها/نبایدها و انطباق با Material 3)
feat(mcp): دو قاعدهٔ توصیه‌شده در `get_mandatory_rules`: `profile-image-on-card-edge` و `single-avatar-per-view`
fix(patterns): `ProfileCard` آواتار را روی لبهٔ بالای کارت (overlap ~۵۰٪) می‌گذارد؛ نشانی حاشیه با توکن `--tds-profile-card-avatar` و نه کنار متن
feat(patterns): prop `avatarSlot` در `ProfileCard` برای جایگزینی آواتار با آپلودر آواتار در حالت ویرایش؛ آواتار و آپلودر هم‌زمان رندر نمی‌شوند
feat(patterns): `ProfileCard` در موبایل آواتار و متن را وسط‌چین می‌کند؛ استوری `EditingAvatar` برای حالت ویرایش با آپلودر آواتار اضافه شد
fix(tuk): برچسب و توضیح‌های `FileUpload` آواتار روی لبهٔ کارت بصری مخفی می‌شوند (برای صفحه‌خوان حفظ می‌شوند) تا روی متن کارت نیفتند
fix(tuk): نشان دوربین `FileUpload` آواتار دقیقاً روی خط مرزی دایره و در ۴۵° قرار گرفت؛ `overflow` ناحیهٔ آواتار باز شد تا نیمهٔ بیرونی نشان بریده نشود
fix(docs): صفحهٔ `/components/file-upload` بدون پلی‌گراند تکراری، بدون بخش‌های تکراری نمونه و کد آواتار، و بدون نام‌های داخلی نمونه (`fileUploadExamples.*`) در کادرها
feat(layout): استاندارد صفحه‌آرایی ساختاری در `apps/api/src/layout/page-standard.ts` با نوع صفحهٔ `profile` (ترتیب بخش‌ها، کامپوننت‌های مجاز، قواعد آواتار و آپلودر)؛ پیش‌نویس تا تأیید طراح
feat(api): مسیرهای `GET /layout/page-standards` و `GET /layout/page-standards/:pageType`
feat(layout-mcp): ابزار فقط‌خواندنی `get_page_standard` با خطای صریح برای نوع صفحهٔ ناشناخته
feat(tuk): page transaction contract (`@tokapps/tuk/transaction`): `transaction(to, trigger)`, `registerTransaction`, `bindTransactionNavigator`, one-navigate guarantee, supersede, reduced-motion and timeout fallback (ARCH §۱۸)
feat(tuk): keyframe transaction runner on `[data-tds-transition]` only; animations are cancelled after each phase so the glass dock and minimized player never jump
feat(theme-*): per-identity `transaction.ts` for tokapps, ideation, funding, product-hunt, stories, enterprise; registered in each theme index
feat(docs,starter): route every page change through `transaction()`; starter gets a `TransactionBridge`
docs(arch): ARCH §۱۸ page transaction rule
feat(tuk): transaction waits for page mount (`notifyPageMounted`, `waitForPageMount`) before the in-phase; default timeout 3000ms
docs(foundations): transaction page (`/foundations/transaction`) and MCP gate `layout/page-transaction` (warning)
feat(tuk): setTdsSession silent session restore; AuthFlow ssoLabel={null}
docs(ai): install TDS from single Tokapps-ir/TDS repo with moving per-package branches
test(tuk): require at least 20 docs sections in component test kit
fix(metadata): align component metadata with schema v1
fix(tuk): declare process locally in DockPlayerView for theme lint
fix(tuk): reference node types in DockPlayerView for theme lint
Dock apps and actions, segmented navigation, release script
Podcast pattern, in-dock player, media cards, container queries
Get starte
Components - Components
Components - Components
Components - Components
Components - Tailwind
Components - Alerts
Components
Components
Components
Components
Accessibility
Debug login
Debug
Debug
Update Bread
feat(topbar): add mobileBehavior to theme meta and TopBarProps
Update Dock
Dark mode
Dock
Calendar
Documentation
Documentation
Hunt card
Tour
metadata for mcp
metadata for mcp
Code block
Dock Modal
Icons
Icons
Gestures
bottom-sheet
بروزرسانی ساختار فایل ها
بروزرسانی ساختار فایل ها
feat(docker): add compose stack for docs site and storybook
ignore .idea
feat(tuk,themes,docs): search with stable bones and six identity motions
feat(tuk,themes,docs): identity-driven switch motion, copyable examples and identity stories
feat(tuk,docs): futuristic welcome on AuthResult and profile menu in the dock
feat(tuk): per-digit CodeCells, pairing patterns and QR device pairing
feat(tuk): split login into four reusable patterns, one page per pattern
feat(tuk): add AuthFlow pattern with SSO and OTP steps
feat: initial TDS monorepo import (Phases 1–5 in progress)
fix(tdm-mcp): type readOnly registerTool override so lint passes
docs(tuk): صفحهٔ VideoPlayer در مستندات با نمونهٔ زنده
feat(tuk): VideoPlayer با منابع متعدد، ژست‌ها، شناور و حالت رمزشده

v0.2.1 · 2026-10-16

feat(ci): GitHub Actions: `ci.yml` و `publish.yml` (انتشار با تگ `v*` در رجیستری npm خصوصی)
feat(release): `scripts/publish-npm.mjs` با یوزرنیم و پسورد از محیط؛ `pnpm release --publish-npm`
docs(install): نصب پکیج‌ها از رجیستری npm خصوصی به‌جای گیت
feat(tdm-mcp): قاعدهٔ اجباری `package-install-registry`
chore(packages): انتشار ۱۹ پکیج `@tokapps/*` در رجیستری npm خصوصی `rp.tokapps.ir`
feat(ci): GitHub Actions: `ci.yml` (نصب با lockfile، `check:tokens`، `test`، `build` در PR و main) و `publish.yml` (انتشار با تگ `v*` در رجیستری npm خصوصی با Secrets)
feat(release): `scripts/publish-npm.mjs` با یوزرنیم و پسورد از محیط (بدون ذخیرهٔ رمز در فایل) و نسخه‌های موجود را رد می‌کند؛ `pnpm release --publish-npm`
chore(packages): همهٔ ۱۹ پکیج `@tokapps/*` با نسخهٔ `0.2.0` روی رجیستری npm خصوصی `rp.tokapps.ir` منتشر شد؛ `private` حذف و `publishConfig` اضافه شد
docs(install): نصب پکیج‌ها از رجیستری npm خصوصی به‌جای گیت؛ `.npmrc` با `${NPM_TOKEN}` در صفحهٔ نصب، شروع سریع، پرامپت پروژهٔ جدید و پرامپت پروژهٔ موجود
feat(tdm-mcp): قاعدهٔ اجباری `package-install-registry` برای نصب فقط از رجیستری خصوصی و بدون توکن در فایل
feat(docs): صفحهٔ `/changelog` با داده از همین فایل؛ ابزار MCP جدید `get_changelog` همین محتوا را برمی‌گرداند
fix(docs): جدول‌های MDX و جدول‌های داخل نمونه‌ها در موبایل فشرده نمی‌شوند؛ داخل ناحیهٔ خودشان اسکرول افقی دارند
fix(docs): صفحه‌های `kbd`، `toolbar`، `panel-dock`، `inline-notice` و `scroll-area` مستندات کامل گرفتند (کد قابل کپی + نمونهٔ زنده)؛ قبلاً «ساخته نشده» نشان داده می‌شدند
fix(tuk): گروه فراداده `Kbd` و `CatalogTile` به «Data Display» یکسان شد تا در فهرست دسته ظاهر شوند
style(docs): سربرگ‌های بالای کارت نمونه‌ها حذف و به برچسب کم‌حجم تبدیل شد
style(tokens,tuk): سربرگ کارت مینیمال شد؛ فاصلهٔ `--tds-card-gap` از space-3 به space-2 و اندازهٔ عنوان به توکن جدید `--tds-card-title-size` (font-size-sm) رفت

v0.2.0 · 2026-10-15

fix(tuk): Slug metadata sound value matches component schema
docs: NumberInput docs, layout knowledge phase, project briefs and status
feat(api,layout): admin OTP login, layout knowledge base, tasks, admin & MCP apps
feat(tuk): NumberInput component and Input updates
feat(tuk,themes,docs,mcp): page transaction contract and pending feature work
perf(icons): explicit per-icon lazy loaders and named barrel exports