عن المشروع

Tinte هو مترجم لأنظمة التصميم وسلسلة أدوات للثيمات. وتتمثل فرضيتُه في أن وكيل البرمجة (coding agent) يكتب واجهة مستخدم متوافقة مع العلامة التجارية عندما يتمكن من قراءة الرموز (tokens) كواجهة برمجة تطبيقات (API) وقواعد التكوين كتعليمات؛ حيث يقوم Tinte بتجميع كليهما من إعداد هوية واحد إلى عنصر قابل للتثبيت. تعتمد عمليات الاستخراج والتجميع والفرض جميعها على نفس ملف tinte.config.json. وتشمل أوامر واجهة السطر البرمجي (CLI) الموثقة: from --emit-script (لطباعة نص استخراج لصفحة مباشرة)، وfrom --normalize (لتحويل الأنماط الملتقطة إلى مسودة هوية)، وbuild --plugin (لتجميع الهوية إلى Agent Plugin)، وlint مع مسار واحد أو أكثر، والذي يخرج بالرمز 1 عند وجود أي لون يتجاوز الرموز. يقوم الأمر tinte build --plugin بإصدار دليل إضافي يحتوي على plugin.json ومجلد skill يضم SKILL.md بالإضافة إلى references/tokens.css. يحمل ملف SKILL.md مقياس النوع، والصوت، وقانون التكوين؛ بينما ملف tokens.css هو ملف الرموز الذي يقرأه الوكيل كواجهة برمجة تطبيقات. يتم تنسيق موقع المشروع tinte.dev بواسطة الإضافة التي يجمعها Tinte من إعداداته الخاصة، ويمكن جلب ملفات design.md وtokens.css من مساراتهما الحقيقية. وبشكل منفصل، يظل منشئ الثيمات متاحاً: ابدأ من مرجع، وحوله إلى مزود (provider)، ثم قم بتثبيته. يتم تجميع ثلاثة عشر رمزاً دلالياً بتنسيق OKLCH إلى مسبقات shadcn/ui، وثيمات VS Code، وتكوينات الطرفية (Alacritty, Kitty, Warp, Windows Terminal) وأكثر من 19 تنسيقاً من مصدر حقيقة واحد. يمكن تثبيت الثيمات العامة كعناصر shadcn registry:base من خلال واجهة برمجة مسبقات (preset API)، بما في ذلك طلب متغيرات الخط ونقطة نهاية حزمة تعيد الأساس والخطوط وأوامر التثبيت، بالإضافة إلى نقطة نهاية لتصفح الثيمات العامة مع ميزة البحث. تغطي أداة Ray by Tinte، المتاحة على ray.tinte.dev، لقطات شاشة للأكواد واستخراج الثيمات: أكثر من 500 ثيم للنحو البرمجي، و16 لغة، وتصدير بصيغ PNG/SVG، وواجهة برمجة تطبيقات REST مجانية موثقة بـ 60 طلباً في الدقيقة دون الحاجة إلى مصادقة. وتعمل نقاط النهاية الموثقة على استخراج ثيم ألوان من صورة وأخذ لقطة شاشة للكود بأي ثيم من Tinte. تشمل الحزم المنشورة لإعادة الاستخدام @tinte/core لبدائيات الثيمات ونموذج ألوان OKLCH وتعاريف الأنواع؛ و@tinte/providers لمحولات التنسيق؛ وحزمة tinte على npm لمترجم Agent Plugin ومثبت الثيمات. يستخدم التطوير bun لتثبيت التبعيات، وخادم تطوير، وبناء للإنتاج. تم إصدار المشروع بموجب رخصة MIT.