حرفة التجميع

# Seam Craft — متطلبات العرض للانتقالات بين المشاهد

هذا هو **مبدأ صحة العرض** للانتقالات بين مشاهد PLV: المتطلبات الأساسية وآليات الجدول الزمني الرئيسي التي تجعل أي مركب انتقال صحيحا، بغض النظر عن الانتقال المحدد المختار. يعيش كتالوج الانتقالات الفردية (التلاشي المتقاطع، الدفع-الانزلاق، التكبير-التصغير، قطع المنحنى، ...) في سجل الانتقالات — هذه الصفحة هي المبدأ الذي يقع تحتها جميعا.

الانتقالات التي يحكمها هذا المبدأ هي **جاهزة للمستوى B**: تحويل / عتامة / فلتر خالص على **أغلفة المقاطع** للمشهدين (`#el-<sid>`)، لا يوجد DOM تراكبي محقون، ولا تعاون لكل مشهد. عائلات التراكبات (الكتل المتداخلة، الستائر، تسرب الضوء، تذويب الشبكة، حرق الصفحة) وانتقالات التظليل مؤجلة إلى مراحل لاحقة.

## المتطلب الأساسي للمرحلة (حماية الوميض الأبيض)

تفتح العديد من القوالب نافذة يكون فيها مجموع عتامة الغلافين < 1 (قطع منتصف نافذة "قطع المنحنى"، أرضية 0.15 ل "التكبير-التصغير"، انخفاض منحنى القوة ل "التلاشي المتقاطع" العادي). ما هو خلف الأغلفة يظهر خلال تلك النافذة. إذا كان `#root` في `index.html` المجمع لا يحتوي على خلفية معتمة، فإن العارض يركب الانخفاض فوق صفحته **البيضاء** الافتراضية → وميض أبيض عند كل وصلة، ساطع على الأفلام الداكنة (لوحظ في تشغيلين ل Spotify قبل الإصلاح). **يجب على المجمع طلاء المرحلة:** `#root { background: var(--canvas-deep, var(--canvas, #000)) }` — `assemble-index.mjs` يصدر هذا الآن؛ أي مستهلك آخر لهذه القوالب يضمن نفس الشيء.

## كيف يطبق المحقن الانتقال

عند حد `break` بين المشهد _i_ (`from`) والمشهد _i+1_ (`to`)، يقوم المحقن بما يلي:

1. يمدد `data-duration` لغلاف `#el-<from>` بمقدار `duration_s` (يحمل إطاره النهائي — تم التحقق: فرع الفتحة الخارجية `core/src/runtime/init.ts:1393-1410`). 2. يسحب `data-start` لغلاف `#el-<to>` مبكرا بمقدار `duration_s` (ينشئ نافذة التداخل). 3. يعيد تعيين **جميع** `data-track-index` للمقطع ك 0/1 ping-pong بحيث لا يتشارك الغلافان المتداخلان أبدا في مسار واحد (تداخل نفس المسار غير قانوني — `core/src/lint/rules/composition.ts`). المسار الأعلى يركب في الأعلى. 4. يختم `gsap_template` في `window.__timelines["main"]` عند `T = overlap-start`.

تم التحقق من خلال عرض النموذج الأولي (2026-05-31): يتم البحث عن tween غلاف الجدول الزمني الرئيسي وعرضه (لا يوجد بحث مزدوج مع الجدول الزمني المتوقف للمركب الفرعي — يقوم وقت التشغيل بتشغيلهما بشكل مستقل)، يحمل الغلاف الممتد الإطار النهائي للمشهد _i_، ويركب الغلاف الوارد ذو المسار الأعلى فوق الغلاف الصادر ويمتزج معه.

## عناصر نائبة للقالب

يستبدل المحقن هذه الرموز في كل سطر من `gsap_template`:

| الرمز | المعنى | | ---------------------------------- | ------------------------------------------------------------------------ | | `__OLD__` | `"#el-<from>"` — محدد غلاف المقطع الصادر (مقتبس) | | `__NEW__` | `"#el-<to>"` — محدد غلاف المقطع الوارد (مقتبس) | | `__T__` | وقت بدء التداخل بالثواني (الساعة الرئيسية) | | `__DUR__` | `duration_s` لهذا الحد | | `__DX__` | الحركة الأفقية للأنواع الاتجاهية: `-1920` (يسار) / `1920` (يمين) | | `__DY__` | الحركة العمودية: `-1080` (أعلى) / `1080` (أسفل) | | `__ORIGIN_OUT__` / `__ORIGIN_IN__` | زوج `transformOrigin` ل `squeeze` |

`filter` / `scaleX` / `transformOrigin` نظيفة من الأخطاء في الجدول الزمني الرئيسي (تم التحقق: `core/src/lint/rules/gsap.ts` لا يحتوي على قائمة بيضاء لكل خاصية ويحدد نطاق فحوصاته إلى نطاقات `data-composition-id`؛ القائمة البيضاء ل x/y/scale/rotation/opacity هي قاعدة موجه _عامل المشهد_ فقط — لا تربط index.html).