{
  "title": "سیستم طراحی نانس",
  "slug": "team/frontend/design-system/index",
  "url": "/docs/team/frontend/design-system/index",
  "frontmatter": {
    "layout": "doc",
    "title": "سیستم طراحی نانس (Design System)",
    "description": "نقطه ورود مستندات سیستم طراحی — توکن‌های گرافیکی، حالت‌های تعاملی و تایپوگرافی",
    "version": "1.0.0",
    "status": "PRIVATE",
    "author": "xoxxel",
    "owner": "xoxxel",
    "created_at": "2026-07-11",
    "updated_at": "2026-07-11",
    "tags": "",
    "reviewers": ""
  },
  "sections": [
    {
      "level": 1,
      "heading": "سیستم طراحی نانس",
      "content": "**Nons Design System — Documentation**\n\nاینجا شروع کنید. سیستم طراحی فقط **دادهٔ خام توکن‌ها** (YAML) را تولید می‌کند؛ CLI مستقل `nons` آن‌ها را به CSS Custom Property تبدیل می‌کند که محصولات مصرف می‌کنند.\n\n---"
    },
    {
      "level": 2,
      "heading": "فهرست محتوا",
      "content": "1. [برای توسعه‌دهندگان (مصرف‌کنندگان سیستم)](#برای-توسعه‌دهندگان-مصرف‌کنندگان-سیستم)\n2. [برای نگه‌دارندگان (ویرایش‌کنندگان سیستم)](#برای-نگه‌دارندگان-ویرایش‌کنندگان-سیستم)\n3. [قانون طلایی](#قانون-طلایی)\n\n---"
    },
    {
      "level": 2,
      "heading": "برای توسعه‌دهندگان (مصرف‌کنندگان سیستم)",
      "content": "* **[راهنمای مصرف توسعه‌دهنده (Developer Usage)](developer-usage)** — نحوهٔ مصرف توکن‌ها و بازتولید رابط کاربری مرجع. **اول این را بخوانید.**\n* **[حالت‌های تعاملی (Interactive States)](interactive-states)** — الگوهای hover / active / selected / disabled (filled در مقابل selection)، رفتار light/dark.\n* **[تایپوگرافی (Typography)](typography)** — قانون سلسله‌مراتب (Hierarchy Rule) و مقیاس تایپوگرافی هر محصول.\n\n---"
    },
    {
      "level": 2,
      "heading": "برای نگه‌دارندگان (ویرایش‌کنندگان سیستم)",
      "content": "* **گزارش پوشش توکن‌ها (Token Coverage Report)** — حسابرسی توکن‌های موردنیاز مصرف‌کننده در برابر آنچه Registry ارائه می‌دهد (توسط نگه‌دارنده تکمیل می‌شود).\n* `manifest.json` — منبع حقیقت (Source of Truth) برای رجیستری‌ها، تم‌ها، نسخه‌ها و `colorGuide`.\n* `registry/*.yaml` — توکن‌های خام اولیه (Primitive). `themes/*.yaml` — نگاشت نقش‌های معنایی (Role mappings).\n* `preview/index.html` — پیش‌نمایش زندهٔ light/dark مجموعهٔ توکن‌ها.\n* `CHANGELOG.md` — تاریخچهٔ انتشار.\n\n---"
    },
    {
      "level": 2,
      "heading": "قانون طلایی",
      "content": "توکن‌ها را مصرف کن؛ هرگز مقدار خام را به‌صورت مستقیم (hardcode) ننویس. اگر مقداری کم است، آن را به Registry اضافه کن."
    }
  ]
}