بلڈرز کے لیے Lolly

تکنیکی دستاویزات — ہر اُس شخص کے لیے جو ٹولز تصنیف کرتا ہے، Lolly کو کسی پائپ لائن میں مربوط کرتا ہے، اسے خود ہوسٹ کرتا ہے، یا پلیٹ فارم کو وسعت دیتا ہے۔

اِس میں آپ کے لیے کیا ہے۔ ایک بار ٹول بنا لیں اور وہی درخواست بار بار آپ کے پاس آنا بند ہو جاتی ہے۔ "کیا آپ مجھے بس ایک… بنا دیں گے" جیسی تکراری فرمائش جو آپ کی دوپہریں کھا جاتی ہے، ایک ٹیمپلیٹ بن جاتی ہے جسے دوسرے لوگ خود بھرتے ہیں — درست طریقے سے، آپ کو درمیان میں لائے بغیر۔ آپ کا کام سادہ HTML/CSS/JS ہے: ورژن کنٹرولڈ، قابلِ diff، قابلِ جائزہ، اور ایک کھلے انجن پر چلتا ہے جس میں کوئی وینڈر لاک اِن نہیں، سو یہ آپ ہی کا رہتا ہے۔ پروڈکشن رن کو خودکار بنا دیں اور آپ کا وقت دلچسپ مسئلے کو جاتا ہے، دس ہزارویں ایکسپورٹ کو نہیں۔

Lolly ایک پلیٹ فارم سے آزاد انجن ہے جو کئی شیلز (web PWA، Tauri ڈیسک ٹاپ/موبائل، CLI، TUI) میں یکساں رینڈر پاتھ چلاتا ہے۔ ٹولز کوڈ نہیں بلکہ ڈیٹا ہیں — ایک مینی فیسٹ جمع ایک ٹیمپلیٹ جمع اختیاری hooks — سو نئے ٹولز کسی ایپ اپ ڈیٹ کے بغیر آتے ہیں۔ آرکیٹیکچر کے لیے جائزہ سے شروع کریں، پھر وہ ٹریک اپنائیں جو آپ کی تعمیر سے میل کھاتا ہے۔

پلیٹ فارم پر نئے ہیں؟ گہرائی میں جانے سے پہلے کوئیک اسٹارٹ ایک برانڈ اور آپ کا پہلا رینڈر اپنی جگہ لے آتا ہے۔

آرکیٹیکچر کو سمجھیں

• جائزہ — Lolly کیوں وجود رکھتا ہے، engine/shell/tools کی علیحدگی، capability bridge، اور طے شدہ آرکیٹیکچرل وابستگیاں۔
• ڈیزائن ٹوکنز — وہ DTCG ٹوکن ماڈل جس میں برانڈز کا اظہار ہوتا ہے، اور ٹولز اُنہیں کیسے استعمال کرتے ہیں۔

ٹولز تصنیف کریں

نیچے دکھایا گیا ہر کنٹرول tool.json میں بیان کیے گئے کسی ان پٹ سے تیار ہوا ہے۔ آپ مینی فیسٹ کی لائن لکھتے ہیں، ہوسٹ ویجٹ بناتا ہے، اور وہی ماڈل CLI اور URL کو بھی چلاتا ہے۔

یہ پانچ کنٹرولز سے کہیں آگے تک پھیلتا ہے۔ کسی ان پٹ کو section دیں اور ہوسٹ اسے سمیٹ دیتا ہے، چنانچہ D3 Chart Studio جیسا پچاس ان پٹ والا ٹول بھی ایک مختصر فہرست کی صورت میں کھلتا ہے اور باقی سب نام والے گروپوں کے پیچھے ترتیب سے رہتا ہے۔

• ٹولز کی تصنیف — مکمل رہنما: مینی فیسٹ، ٹیمپلیٹ، اسٹائلز، hooks، کمپوزیشن، اور اشاعت۔
• ایسیٹس کی تصنیف — کیٹلاگ ایسیٹس، ٹئیرز، لوکیلز، پیلیٹس، تھیم ایبل آئیکنز، اور فونٹس۔
• Host API — HostV1 capability bridge جس کے مطابق ہر ٹول لکھا جاتا ہے (واحد API جو ٹولز دیکھتے ہیں)۔
• URL موڈ — ہر ان پٹ بطور URL پیرامیٹر؛ محفوظ params، compact encoding، پیک شدہ لنکس۔

چلائیں اور مربوط کریں

• CLI — headless رینڈرنگ؛ GUI جیسا ہی رینڈر پاتھ، --foo=bar argv سے چلایا گیا۔
• TUI — انٹرایکٹو ٹرمینل شیل۔
• MCP سرور — وہ نیٹو اینڈ پوائنٹ جو کسی AI ایجنٹ کو ٹولز دریافت کرنے اور چلانے دیتا ہے۔
• AI ایجنٹس — Lolly کو کسی ماڈل سے چلانا: URL ہی API ہے۔
• Chrome ایکسٹینشن — کسی لائیو URL کو قابلِ استعمال ایسیٹ کے طور پر کیپچر کریں۔

اسے شپ اور آپریٹ کریں

• بلڈ گائیڈ — ہر ٹارگٹ بنائیں: CLI، TUI، ڈیسک ٹاپ، موبائل۔
• ڈیپلائمنٹ — ویب ایپ، ایپس، اور بیک اینڈ سروسز؛ ہر جزو کہاں چلتا ہے۔
• کنفیگریشن — پروفائلز، برانڈ پیکس، capability gating، فیچر فلیگز، اور کیٹلاگ ویلیڈیشن۔

اعتماد اور ڈیٹا

حقوق اور تصنیف بھی باقی سب کی طرح ان پٹ ہی ہیں۔ Embed & Track Image تخلیق کار، کاپی رائٹ، لائسنس اور رابطے کے خانے بیان کرتا ہے، اور ایکسپورٹ اُنہیں فائل کے اپنے میٹا ڈیٹا اور اُس کے C2PA مینی فیسٹ میں لکھ دیتا ہے۔

• Content Credentials Identity — آن ڈیوائس C2PA کے لیے CA سے جاری کردہ سائننگ؛ engine کنٹریکٹس اور آپریٹر رن بک۔
• ڈیٹا ٹرانسفر — lolly-backup بنڈل: اینویلپ، سالمیت، اور کراس شیل ضمانتیں۔
• بابت — پروجیکٹ، اس کی لائسنس حد، اور ریپازٹری۔