প্রকল্প সম্পর্কে

XenolithGraph হল ওয়েবের জন্য একটি এমবেডযোগ্য, ড্রপ-ইন নোড-গ্রাফ এডিটর, বর্তমানে v0.7 BETA-তে রয়েছে। এটি AI ওয়ার্কফ্লো নির্মাতা, ComfyUI-শ্রেণির টুল এবং ভিজ্যুয়াল ডিবাগারদের লক্ষ্য করে, এবং এটি সংরক্ষণাগারভুক্ত BluePrintRenderer প্রকল্পের উত্তরসূরি, যা PIXI v8 (WebGL)-এ TypeScript-এ পুনর্লিখিত। মূল ক্ষমতা - Blueprint-প্রথম মডেল: টাইপড পিন (exec বনাম data), প্রতি-টাইপ রঙ এবং আকৃতি, নিবন্ধনযোগ্য টাইপ রূপান্তর, exec পিন নোড হেডারে উত্তোলিত। - লাইভ টেমপ্লেট এবং ম্যাক্রো: একটি সংজ্ঞা এবং অনেক ইনস্ট্যান্স সহ পুনঃব্যবহারযোগ্য সাবগ্রাফ, ব্রেডক্রাম্ব সহ ডুব-ইন সম্পাদনা, ম্যাক্রো এবং টেমপ্লেটের মধ্যে রূপান্তর, ইনস্ট্যান্স আনপ্যাকিং। - মন্তব্য: নোডের পিছনে রঙিন আয়তক্ষেত্র যা তাদের বিষয়বস্তু একটি গ্রুপ হিসাবে সরায়। - ইন-নোড উইজেট: ঘোষণামূলক সংখ্যা/স্লাইডার/কম্বো/টেক্সট/টগল/রঙ/বোতাম প্লাস কাস্টম ক্যানভাস-ড্র বা DOM-মাউন্টেড উইজেট (registerWidget এর মাধ্যমে React/Vue/Svelte), শর্তসাপেক্ষ দৃশ্যমানতা, ফ্রি-ফ্লোটিং উইজেট, বৈশিষ্ট্য সাইডবার। - কমান্ড এবং হটকি: টাইপড ধ্রুবক সহ নামযুক্ত কমান্ড এবং একটি ক্রস-প্ল্যাটফর্ম হটকি ব্যাকরণ; বিল্ট-ইন শর্টকাট ওভাররাইডযোগ্য। - ইভেন্ট এবং ইতিহাস: বাতিলযোগ্য ভেরিয়েন্ট সহ টাইপড ইভেন্ট, লেনদেন এবং গ্রুপিং যাতে অনেক মিউটেশন একটি আনডু এন্ট্রিতে একত্রিত হয়। - স্থায়িত্ব: সংস্করণযুক্ত xenolith.v1 JSON পরিষ্কার ডিফের জন্য সাজানো, প্রতি-স্কিমা মাইগ্রেট হুক, ComfyUI ওয়ার্কফ্লো ইম্পোর্টার, সম্পূর্ণ-গ্রাফ PNG/JPEG রপ্তানি। - Dagre এবং ELK অ্যাডাপ্টার সহ অটো-লেআউট প্লাগইন, অ্যানিমেটেড এবং একটি আনডু এন্ট্রি হিসাবে প্রতিশ্রুতিবদ্ধ। - প্লাগযোগ্য এজ পাথ (bezier, smoothstep, step, linear) লেবেল, তীরচিহ্ন এবং অ্যানিমেটেড ড্যাশ সহ। - প্লাগইন হোস্ট যা স্কিমা, টাইপ, আইকন, উইজেট, একটি ইভেন্ট বাস এবং রানটাইম-ডেলিগেশন সারফেস প্রকাশ করে। - তিনটি শিপড থিম (Xen dark/gold, Daylight light, Liquid Glass শেডার-ভিত্তিক) রানটাইমে অদলবদলযোগ্য এবং অবস্থা সংরক্ষিত; লাইভ মোড প্রিভিউর জন্য এডিটর ক্রোম লুকায়। - পারফরম্যান্স বৈশিষ্ট্য: ভিউপোর্ট ভার্চুয়ালাইজেশন, তিন-স্তর LOD, চাহিদা-অনুযায়ী রেন্ডার, BitmapText গ্লিফ অ্যাটলাস, শেয়ার্ড GPU টেক্সচার ক্যাশ। অ্যাডাপ্টার এবং প্যাকেজ React এবং Vue 3 অ্যাডাপ্টার প্যানেল, নিয়ন্ত্রণ, মিনিম্যাপ এবং বোতাম উপাদান সরবরাহ করে প্রতিক্রিয়াশীল হুক/কম্পোজেবল এবং কাস্টম-উইজেট র্যাপার সহ। Svelte, Solid, Angular এবং Web Components-এর জন্য পাতলা স্টার্টার অ্যাডাপ্টার বিদ্যমান। হেডলেস কোর প্যাকেজ শূন্য-নির্ভরতা। একটি টেস্ট-ইউটিলস প্যাকেজ vitest এবং jsdom-এর অধীনে আসল WebGL এডিটর বুট করে। AI ইন্টিগ্রেশন একটি বান্ডেলড MCP সার্ভার stdio MCP-কে ব্রাউজার এডিটরে একটি WebSocket সংযোগে ব্রিজ করে, তাই Claude Desktop বা Cursor নোড টাইপ তালিকাভুক্ত করতে, নোড যোগ করতে, পিন সংযোগ করতে এবং অটো-লেআউট করতে পারে। মিউটেশনগুলি মানব সম্পাদনার মতো একই কমান্ড বাসের মাধ্যমে প্রবাহিত হয়, তাই আনডু কাজ করে। টোকেন অথ এবং রিড-অনলি মোড সমর্থিত, এবং একটি প্রস্তাব মোড মানব অনুমোদনের জন্য এজেন্ট সম্পাদনাগুলিকে একটি পারমাণবিক আনডুযোগ্য লেনদেন হিসাবে সারিবদ্ধ করে। ডিবাগিং এডিটর প্যাকেজে একটি StepDebugger প্রিমিটিভ যেকোনো এক্সিকিউটরকে পজ/স্টেপ/কন্টিনিউ, ব্রেকপয়েন্ট, প্রতি-নোড টাইমিং এবং একটি লাইভ ট্রেস প্রদানের জন্য মোড়ানো করে, এবং ডিবাগার, টাইম-ট্রাভেল, হিটম্যাপ এবং গ্রাফ-ডিফ শোকেসকে ভিত্তি দেয়। বান্ডেল সাইজ এবং ট্রেড-অফ README পরিমাপিত gzipped সাইজ রিপোর্ট করে: কোর 8.4 KB, PIXI রেন্ডারার 17.4 KB, এডিটর 74.3 KB, React অ্যাডাপ্টার 2.3 KB, থিম 2.3-7.9 KB, pixi.js প্রায় 250 KB পিয়ার নির্ভরতা হিসাবে এবং একটি বাস্তবসম্মত React অ্যাপ লোড প্রায় 330 KB। প্রকল্পটি স্পষ্টভাবে উল্লেখ করে যে এটি Drawflow, LiteGraph.js, Rete.js, Baklava এবং React Flow-এর তুলনায় সবচেয়ে ভারী বিকল্প, এবং মোবাইল-প্রথম বা Vue-কেবল ক্ষেত্রে হালকা বিকল্পের পরামর্শ দেয় যখন নিজেকে এমন পণ্যগুলির জন্য অবস্থান করে যেখানে এডিটরটি মূল। স্থিতি এবং রোডম্যাপ STABLE-API.md-এ নথিভুক্ত পাবলিক API হিমায়িত করার উদ্দেশ্যে কিন্তু এখনও হিমায়িত নয়; v1.0-এর আগে ব্রেকিং পরিবর্তন আসতে পারে, তাই একটি সঠিক সংস্করণ পিন করার পরামর্শ দেওয়া হয়। প্রাথমিক টাচ/মোবাইল সমর্থন শিপড হয়েছে (পিঞ্চ, দুই-আঙুল প্যান, লং-প্রেস মেনু, ড্রয়ার ক্রোম) পলিশ আইটেম বাকি আছে। ক্যানভাস অ্যাক্সেসিবিলিটি (ARIA, কীবোর্ড নেভিগেশন) এবং আরও টাচ পলিশ খোলা। মাল্টি-গ্রাফ প্রসঙ্গ, সহযোগিতা, RTL লেআউট, একটি অ- PIXI রেন্ডারার, বাধা-এড়ানো তার এবং WASM লেআউট স্পষ্টভাবে নির্ধারিত নয়। একটি পরীক্ষামূলক Blueprint VM প্লাগইন চলছে; হোস্ট ডেটাফ্লো কোর প্যাকেজ থেকে evaluateGraph ব্যবহার করে। পরীক্ষা এবং উন্নয়ন README 1326 ইউনিট টেস্ট এবং 117 Playwright ইন্টারঅ্যাকশন টেস্ট, রেন্ডারারের জন্য ভিজ্যুয়াল স্ন্যাপশট টেস্ট এবং CI-প্রয়োগকৃত প্রতি-প্যাকেজ বান্ডেল বাজেট রিপোর্ট করে। উন্নয়ন প্লেগ্রাউন্ড, ডক্স সাইট, vitest, Playwright এবং tsc বিল্ড কমান্ড সহ pnpm ব্যবহার করে। লাইসেন্স MIT।