@nodaro/shared 2.8.0 → 2.11.0

package/src/i18n/index.ts

@@ -30,6 +30,33 @@ function cacheKey(catalog: I18nCatalogId, locale: LocaleId): string {
   return `${catalog}:${locale}`
 }
 
+/**
+ * Pack-sidecar overlay: localized strings contributed by registered catalog
+ * packs (e.g. an extension pack's `sidecars.he`), keyed `<catalog>:<locale>`.
+ * Consulted by `getLocalizedEntry` when the file sidecar lacks an id. Empty on
+ * mainline. Populated by `@nodaro/prompts` at pack registration — the content
+ * (the translated strings) lives in the pack (the deployment overlay), never
+ * in this Apache package.
+ */
+const packSidecars = new Map<string, LocaleCatalogMap>()
+
+export function registerCatalogSidecars(
+  catalog: string,
+  sidecars: Partial<Record<LocaleId, LocaleCatalogMap>> | undefined,
+): void {
+  if (!sidecars) return
+  for (const locale of Object.keys(sidecars) as LocaleId[]) {
+    const map = sidecars[locale]
+    if (!map) continue
+    const key = `${catalog}:${locale}`
+    packSidecars.set(key, { ...(packSidecars.get(key) ?? {}), ...map })
+  }
+}
+
+export function resetCatalogSidecars(): void {
+  packSidecars.clear()
+}
+
 /**
  * Lazy-load a sidecar catalog. Returns `null` if the locale is `en` (no
  * sidecar — English lives in the canonical catalog file) or if no sidecar
@@ -82,9 +109,12 @@ export function getLocalizedEntry(
   locale: LocaleId,
 ): LocalizedEntry | undefined {
   if (locale === "en") return undefined
-  const map = cache.get(cacheKey(catalog, locale))
-  if (!map) return undefined
-  return map[id]
+  const key = cacheKey(catalog, locale)
+  const fromFile = cache.get(key)?.[id]
+  if (fromFile) return fromFile
+  // Fall back to a pack-registered sidecar overlay (G10). File sidecars win;
+  // pack sidecars cover ids the deployment overlay added. Empty on mainline.
+  return packSidecars.get(key)?.[id]
 }
 
 /**

package/src/i18n/transitions.ar.ts

@@ -7,12 +7,15 @@ const map: LocaleCatalogMap = {
   "cross-dissolve": { label: "تلاشٍ متقاطع", description: "مزج تدريجي بين اللقطتين" },
   "fade-to-black": { label: "تلاشٍ إلى الأسود", description: "تظلم تدريجي ثم تظهر اللقطة التالية" },
   "fade-to-white": { label: "تلاشٍ إلى الأبيض", description: "توهج حتى الأبيض ثم تظهر اللقطة" },
+  "snap-to-black": { label: "قطع فوري إلى السواد", description: "قطع فوري إلى سواد كامل للحظة، ثم تدخل اللقطة التالية" },
   "match-cut": { label: "قطع متطابق", description: "تطابق الشكل أو الحركة بين اللقطتين" },
   "smash-cut": { label: "قطع مفاجئ", description: "قطع مفاجئ صارخ بين لقطتين متباينتين" },
   "iris": { label: "انتقال القزحية", description: "دائرة تنغلق ثم تنفتح على اللقطة الجديدة" },
   "wipe": { label: "مسح خطي", description: "خط يجتاح الإطار ليكشف اللقطة الجديدة" },
   "roll-transition": { label: "دوران", description: "الإطار يدور 90-180 درجة للانتقال" },
   "seamless-match": { label: "تطابق سلس", description: "قطع خفي يُموَّه بتطابق الحركة واللون" },
+  "whip-pan": { label: "بان سريع", description: "الكاميرا تنعطف جانبًا بسرعة مع ضبابية، واللقطة التالية تتابع الاتجاه نفسه" },
+  "jump-cut": { label: "قطع قافز", description: "الإطار نفسه، والزمن يقفز إلى الأمام" },
 
   // ── Time ──
   "fast-forward-day-night": { label: "تسريع (نهار ← ليل)", description: "مرور الزمن من النهار إلى الليل في نفس المشهد" },
@@ -62,6 +65,8 @@ const map: LocaleCatalogMap = {
   "zoom-into-mouth": { label: "تكبير في الفم", description: "الكاميرا تدخل الفم لتظهر في عالم جديد" },
   "push-through-glass": { label: "اختراق الزجاج", description: "الكاميرا تخترق لوح زجاج لعالم آخر" },
   "soul-jump": { label: "قفزة الروح", description: "روح شفافة تخرج وتدخل جسداً جديداً" },
+  "mask-transition": { label: "انتقال بالقناع", description: "جسم في المقدمة يحجب الإطار، والكاميرا تعبر العتمة إلى المشهد الجديد" },
+  "zoom-through": { label: "تقريب عبر التفصيل", description: "الكاميرا تكبّر تفصيلاً واحدًا حتى ينكشف المشهد الجديد داخله" },
 
   // ── Physics ──
   "explosion-blast": { label: "موجة انفجار", description: "انفجار يجتاح الإطار ويكشف المشهد الجديد" },
@@ -73,6 +78,7 @@ const map: LocaleCatalogMap = {
   "vehicle-explosion": { label: "انفجار مركبة", description: "مركبة تنفجر واللهب يغطي الإطار ثم يُكشف المشهد" },
   "jump-match": { label: "قفزة متطابقة", description: "الشخص يقفز وعند الهبوط يكون في مشهد جديد" },
   "hand-swipe": { label: "مسح اليد", description: "يد تمر أمام العدسة ويتغير المشهد" },
+  "action-relay": { label: "قطع على الحركة", description: "الشخصية تغادر الإطار وسط حركة وتكملها في المشهد الجديد" },
 
   // ── Light ──
   "white-flash": { label: "وميض أبيض", description: "الإطار يتوهج أبيض ثم يظهر المشهد الجديد" },

package/src/i18n/transitions.de.ts

@@ -7,12 +7,15 @@ const map: LocaleCatalogMap = {
   "cross-dissolve":         { label: "Überblendung",             description: "Allmähliche Mischung zwischen den Einstellungen" },
   "fade-to-black":          { label: "Abblende auf Schwarz",     description: "Dunkelt auf Schwarz ab, zweite Einstellung erscheint" },
   "fade-to-white":          { label: "Abblende auf Weiß",        description: "Erstrahlt in Weiß, zweite Einstellung erscheint" },
+  "snap-to-black":          { label: "Harter Schnitt auf Schwarz", description: "Sofortiger Schnitt auf volles Schwarz für einen Moment, dann die nächste Einstellung" },
   "match-cut":              { label: "Match Cut",                description: "Form- oder Bewegungsübereinstimmung zwischen Einstellungen" },
   "smash-cut":              { label: "Smash Cut",                description: "Abrupter Schnitt zwischen kontrastierenden Einstellungen" },
   "iris":                   { label: "Irisblende",               description: "Iris schließt und öffnet sich zur zweiten Einstellung" },
   "wipe":                   { label: "Wischblende",              description: "Linearer Wisch ersetzt die erste Einstellung" },
   "roll-transition":        { label: "Drehübergang",             description: "Bild dreht 90-180°, zweite Einstellung am Ende" },
   "seamless-match":         { label: "Nahtloser Schnitt",        description: "Versteckter Schnitt durch angeglichene Bewegung und Farbe" },
+  "whip-pan":               { label: "Whip Pan",                 description: "Die Kamera reißt seitwärts in Bewegungsunschärfe, die zweite Einstellung folgt derselben Richtung" },
+  "jump-cut":               { label: "Jump Cut",                 description: "Gleiche Einstellung, die Zeit springt vorwärts" },
 
   // ── Time ──
   "fast-forward-day-night": { label: "Zeitraffer Tag → Nacht",  description: "Zeitraffer von Tag zu Nacht in derselben Szene" },
@@ -62,6 +65,8 @@ const map: LocaleCatalogMap = {
   "zoom-into-mouth":        { label: "Zoom in den Mund",        description: "Die Kamera tritt durch den geöffneten Mund in die neue Welt" },
   "push-through-glass":     { label: "Durch das Glas",          description: "Die Kamera durchquert das Glas in die neue Welt" },
   "soul-jump":              { label: "Seelensprung",            description: "Eine transluzente Seele verlässt den Körper und betritt den neuen" },
+  "mask-transition":        { label: "Maskenübergang",          description: "Ein Objekt im Vordergrund verdunkelt das Bild, die Kamera fährt hindurch" },
+  "zoom-through":           { label: "Zoom Hindurch",           description: "Die Kamera vergrößert ein Detail, bis die neue Szene darin entsteht" },
 
   // ── Physics ──
   "explosion-blast":        { label: "Explosionsdruckwelle",    description: "Die Explosion fegt den Rahmen frei, neue Szene erscheint" },
@@ -73,6 +78,7 @@ const map: LocaleCatalogMap = {
   "vehicle-explosion":      { label: "Fahrzeugexplosion",       description: "Das Fahrzeug explodiert im Vordergrund, die Szene wechselt" },
   "jump-match":             { label: "Sprung-Schnitt",          description: "Das Sujet springt, die Landung verbindet mit der neuen Szene" },
   "hand-swipe":             { label: "Hand-Wisch",              description: "Eine Hand wischt über das Objektiv, die Szene wechselt dahinter" },
+  "action-relay":           { label: "Schnitt auf Bewegung",    description: "Das Sujet verlässt das Bild in einer Bewegung und setzt sie in der neuen Szene fort" },
 
   // ── Light ──
   "white-flash":            { label: "Weißblitz",               description: "Der Rahmen erstrahlt in reinem Weiß" },

package/src/i18n/transitions.es.ts

@@ -7,12 +7,15 @@ const map: LocaleCatalogMap = {
   "cross-dissolve":         { label: "Disolvencia Cruzada",      description: "Mezcla gradual entre planos" },
   "fade-to-black":          { label: "Fundido a Negro",          description: "Oscurece a negro, emerge el segundo plano" },
   "fade-to-white":          { label: "Fundido a Blanco",         description: "Estalla en blanco, emerge el segundo plano" },
+  "snap-to-black":          { label: "Corte a Negro",           description: "Corte instantáneo a negro por un instante, luego el siguiente plano" },
   "match-cut":              { label: "Corte de Raccord",         description: "Coincidencia de forma o movimiento entre planos" },
   "smash-cut":              { label: "Corte Brusco",             description: "Corte abrupto entre planos contrastados" },
   "iris":                   { label: "Iris",                     description: "Iris circular cierra y abre en el segundo plano" },
   "wipe":                   { label: "Barrido",                  description: "Barrido lineal reemplaza el primer plano" },
   "roll-transition":        { label: "Rotación",                 description: "Cuadro gira 90-180°, segundo plano al aterrizar" },
   "seamless-match":         { label: "Corte Invisible",          description: "Corte oculto por movimiento y color sincronizados" },
+  "whip-pan":               { label: "Barrido Rápido",           description: "La cámara barre de lado con desenfoque, el siguiente plano sigue esa dirección" },
+  "jump-cut":               { label: "Corte de Salto",           description: "Mismo encuadre, el tiempo salta hacia adelante" },
 
   // ── Time ──
   "fast-forward-day-night": { label: "Time-lapse Día → Noche",   description: "Time-lapse de día a noche en la misma escena" },
@@ -62,6 +65,8 @@ const map: LocaleCatalogMap = {
   "zoom-into-mouth":        { label: "Zoom a la Boca",          description: "La cámara entra en la boca abierta hacia el nuevo mundo" },
   "push-through-glass":     { label: "Atravesar el Cristal",    description: "La cámara atraviesa el cristal hacia el nuevo mundo" },
   "soul-jump":              { label: "Salto del Alma",          description: "Un alma translúcida sale del cuerpo y entra en el nuevo" },
+  "mask-transition":        { label: "Transición de Máscara",   description: "Un objeto en primer plano tapa el cuadro y la cámara lo atraviesa" },
+  "zoom-through":           { label: "Zoom Atravesado",         description: "La cámara amplía un detalle hasta que la nueva escena surge dentro" },
 
   // ── Physics ──
   "explosion-blast":        { label: "Explosión",               description: "Explosión barre el cuadro, emerge la nueva escena" },
@@ -73,6 +78,7 @@ const map: LocaleCatalogMap = {
   "vehicle-explosion":      { label: "Explosión de Vehículo",   description: "Vehículo explota en primer plano, la escena cambia" },
   "jump-match":             { label: "Salto Raccord",            description: "El sujeto salta, el aterrizaje enlaza con la nueva escena" },
   "hand-swipe":             { label: "Barrido de Mano",         description: "Una mano barre la lente, la escena cambia al descubrirse" },
+  "action-relay":           { label: "Corte por Acción",        description: "El sujeto sale de cuadro en una acción y la continúa en la nueva escena" },
 
   // ── Light ──
   "white-flash":            { label: "Destello Blanco",         description: "El cuadro estalla en blanco puro" },

package/src/i18n/transitions.fr.ts

@@ -7,12 +7,15 @@ const map: LocaleCatalogMap = {
   "cross-dissolve":         { label: "Fondu Enchaîné",           description: "Mélange progressif entre les plans" },
   "fade-to-black":          { label: "Fondu au Noir",            description: "S'assombrit, le second plan émerge du noir" },
   "fade-to-white":          { label: "Fondu au Blanc",           description: "Sature de blanc, le second plan en émerge" },
+  "snap-to-black":          { label: "Coupe au Noir",           description: "Coupe instantanée au noir pendant un temps, puis le plan suivant" },
   "match-cut":              { label: "Coupe sur Raccord",        description: "Correspondance de forme ou mouvement entre plans" },
   "smash-cut":              { label: "Coupe Violente",           description: "Coupe abrupte entre plans contrastés" },
   "iris":                   { label: "Cache Iris",               description: "L'iris ferme puis ouvre sur le second plan" },
   "wipe":                   { label: "Balayage",                 description: "Balayage linéaire remplace le premier plan" },
   "roll-transition":        { label: "Rotation",                 description: "Le cadre pivote 90-180°, second plan à l'arrivée" },
   "seamless-match":         { label: "Coupe Invisible",          description: "Coupe masquée par mouvement et couleur synchronisés" },
+  "whip-pan":               { label: "Filé Panoramique",         description: "La caméra file latéralement en flou, le plan suivant garde la direction" },
+  "jump-cut":               { label: "Jump Cut",                 description: "Même cadrage, le temps saute en avant" },
 
   // ── Time ──
   "fast-forward-day-night": { label: "Accéléré Jour → Nuit",    description: "Accéléré de jour à nuit sur la même scène" },
@@ -62,6 +65,8 @@ const map: LocaleCatalogMap = {
   "zoom-into-mouth":        { label: "Zoom dans la Bouche",     description: "La caméra pénètre la bouche ouverte vers le nouveau monde" },
   "push-through-glass":     { label: "Traversée du Verre",      description: "La caméra traverse le verre vers le nouveau monde" },
   "soul-jump":              { label: "Saut d'Âme",              description: "Une âme translucide quitte le corps et entre dans le nouveau" },
+  "mask-transition":        { label: "Transition Masquée",      description: "Un objet au premier plan masque le cadre, la caméra le traverse" },
+  "zoom-through":           { label: "Zoom Traversant",         description: "La caméra grossit un détail jusqu'à ce que la nouvelle scène s'y déploie" },
 
   // ── Physics ──
   "explosion-blast":        { label: "Souffle d'Explosion",     description: "L'explosion balaie le cadre, la nouvelle scène émerge" },
@@ -73,6 +78,7 @@ const map: LocaleCatalogMap = {
   "vehicle-explosion":      { label: "Explosion de Véhicule",   description: "Le véhicule explose au premier plan, la scène change" },
   "jump-match":             { label: "Raccord de Saut",         description: "Le sujet saute, l'atterrissage enchaîne sur la nouvelle scène" },
   "hand-swipe":             { label: "Balayage de Main",        description: "Une main balaie l'objectif, la scène change en se dégageant" },
+  "action-relay":           { label: "Raccord dans le Mouvement", description: "Le sujet sort du cadre sur une action et la poursuit dans la nouvelle scène" },
 
   // ── Light ──
   "white-flash":            { label: "Flash Blanc",             description: "Le cadre sature en blanc pur" },

package/src/i18n/transitions.he.ts

@@ -7,12 +7,15 @@ const map: LocaleCatalogMap = {
   "cross-dissolve": { label: "דיסולב הצלבה", description: "מיזוג הדרגתי בין שתי הסצנות" },
   "fade-to-black": { label: "דהייה לשחור", description: "חשיכה הדרגתית ואז הסצנה הבאה" },
   "fade-to-white": { label: "דהייה ללבן", description: "הבהרה עד לבן ואז הסצנה הבאה" },
+  "snap-to-black": { label: "חיתוך לשחור", description: "חיתוך מיידי לשחור מלא לרגע, ואז השוט הבא" },
   "match-cut": { label: "חיתוך התאמה", description: "התאמת צורה או תנועה בין הסצנות" },
   "smash-cut": { label: "חיתוך חד", description: "חיתוך מפתיע בין סצנות מנוגדות" },
   "iris": { label: "אירוס", description: "עיגול נסגר ונפתח על הסצנה החדשה" },
   "wipe": { label: "מחיקה", description: "קו סורק את הפריים וחושף את הסצנה" },
   "roll-transition": { label: "סיבוב", description: "הפריים מסתובב 90-180 מעלות" },
   "seamless-match": { label: "התאמה חלקה", description: "חיתוך נסתר בתנועה וצבע תואמים" },
+  "whip-pan": { label: "פאן מהיר", description: "המצלמה מסתובבת הצידה במהירות לכדי טשטוש, והשוט הבא ממשיך באותו כיוון" },
+  "jump-cut": { label: "ג'אמפ קאט", description: "אותו קאדר, הזמן מדלג קדימה" },
 
   // ── Time ──
   "fast-forward-day-night": { label: "הרצה מהירה (יום ← לילה)", description: "מעבר זמן מהיום ללילה באותה סצנה" },
@@ -62,6 +65,8 @@ const map: LocaleCatalogMap = {
   "zoom-into-mouth": { label: "זום לתוך פה", description: "המצלמה נכנסת לפה ומגיחה לעולם חדש" },
   "push-through-glass": { label: "דחיפה דרך זכוכית", description: "המצלמה חודרת לוח זכוכית לעולם אחר" },
   "soul-jump": { label: "קפיצת נשמה", description: "נשמה שקופה עוזבת גוף אחד ונכנסת לאחר" },
+  "mask-transition": { label: "מעבר מסכה", description: "עצם בחזית מכסה את הפריים והמצלמה חוצה את החושך אל הסצנה החדשה" },
+  "zoom-through": { label: "זום אל תוך פרט", description: "המצלמה מגדילה פרט אחד עד שהסצנה החדשה נפרשת בתוכו" },
 
   // ── Physics ──
   "explosion-blast": { label: "גל פיצוץ", description: "פיצוץ סורק את הפריים וחושף את הסצנה החדשה" },
@@ -73,6 +78,7 @@ const map: LocaleCatalogMap = {
   "vehicle-explosion": { label: "פיצוץ רכב", description: "רכב מתפוצץ, להבות מכסות את הפריים, והסצנה מתחלפת" },
   "jump-match": { label: "קפיצה תואמת", description: "הדמות קופצת ונוחתת בסצנה חדשה" },
   "hand-swipe": { label: "מחיקת יד", description: "יד עוברת מול העדשה והסצנה משתנה" },
+  "action-relay": { label: "חיתוך על תנועה", description: "הדמות יוצאת מהפריים בתנועה וממשיכה אותה בסצנה החדשה" },
 
   // ── Light ──
   "white-flash": { label: "הבזק לבן", description: "הפריים מתמלא לבן ואז מגיחה הסצנה החדשה" },

package/src/i18n/transitions.hi.ts

@@ -7,12 +7,15 @@ const map: LocaleCatalogMap = {
   "cross-dissolve": { label: "क्रॉस-डिसॉल्व", description: "दोनों दृश्यों के बीच क्रमिक मिश्रण" },
   "fade-to-black": { label: "काले में फ़ेड", description: "धीरे-धीरे काला होकर नया दृश्य उभरता है" },
   "fade-to-white": { label: "सफ़ेद में फ़ेड", description: "पूरी तरह सफ़ेद होकर नया दृश्य उभरता है" },
+  "snap-to-black": { label: "तुरंत ब्लैक", description: "एक पल के लिए पूरी तरह काला, फिर अगला शॉट" },
   "match-cut": { label: "मैच कट", description: "दोनों दृश्यों में आकार या गति का मिलान" },
   "smash-cut": { label: "स्मैश कट", description: "विपरीत दृश्यों के बीच अचानक कट" },
   "iris": { label: "आइरिस", description: "गोल वृत्त बंद होकर नए दृश्य पर खुलता है" },
   "wipe": { label: "वाइप", description: "रेखा फ्रेम पार करके नया दृश्य दिखाती है" },
   "roll-transition": { label: "रोल", description: "फ्रेम 90-180° घूमकर नए दृश्य पर रुकता है" },
   "seamless-match": { label: "सीमलेस मैच", description: "मिलान गति-रंग से छिपाया गया कट" },
+  "whip-pan": { label: "व्हिप पैन", description: "कैमरा तेज़ी से बगल घूमता है और अगला शॉट उसी दिशा में चलता है" },
+  "jump-cut": { label: "जंप कट", description: "वही फ्रेमिंग, समय आगे छलांग लगाता है" },
 
   // ── Time ──
   "fast-forward-day-night": { label: "फ़ास्ट-फ़ॉरवर्ड (दिन → रात)", description: "उसी दृश्य में दिन से रात का टाइम-लैप्स" },
@@ -62,6 +65,8 @@ const map: LocaleCatalogMap = {
   "zoom-into-mouth": { label: "मुँह में ज़ूम", description: "कैमरा मुँह में जाकर नई दुनिया में निकलता है" },
   "push-through-glass": { label: "काँच से गुज़रना", description: "कैमरा काँच से गुज़रकर नई दुनिया में जाता है" },
   "soul-jump": { label: "आत्मा की छलाँग", description: "आत्मा एक शरीर से निकलकर दूसरे में जाती है" },
+  "mask-transition": { label: "मास्क ट्रांज़िशन", description: "अग्रभूमि की वस्तु फ्रेम को ढक देती है, कैमरा अंधेरे से होकर निकलता है" },
+  "zoom-through": { label: "ज़ूम थ्रू", description: "कैमरा एक विवरण को बड़ा करता है और नया दृश्य उसी के भीतर खुलता है" },
 
   // ── Physics ──
   "explosion-blast": { label: "विस्फोट की लहर", description: "विस्फोट फ्रेम पार करता है, नया दृश्य उभरता है" },
@@ -73,6 +78,7 @@ const map: LocaleCatalogMap = {
   "vehicle-explosion": { label: "वाहन विस्फोट", description: "वाहन फटता है, आग छाती है फ्रेम पर, नया दृश्य दिखता है" },
   "jump-match": { label: "जंप मैच", description: "पात्र कूदता है, उतरने पर नए दृश्य में होता है" },
   "hand-swipe": { label: "हाथ का झटका", description: "हाथ लेंस पर झटका देता है, दृश्य बदलता है" },
+  "action-relay": { label: "एक्शन मैच कट", description: "विषय गति में फ्रेम से बाहर जाता है और नए दृश्य में वही गति जारी रखता है" },
 
   // ── Light ──
   "white-flash": { label: "सफ़ेद फ़्लैश", description: "फ्रेम सफ़ेद होता है, नया दृश्य उभरता है" },

package/src/i18n/transitions.ja.ts

@@ -7,12 +7,15 @@ const map: LocaleCatalogMap = {
   "cross-dissolve": { label: "クロスディゾルブ", description: "ショット間の緩やかなブレンド" },
   "fade-to-black": { label: "暗転", description: "暗転後、次のシーンが浮かび上がる" },
   "fade-to-white": { label: "ホワイトアウト", description: "白飛び後、次のシーンが現れる" },
+  "snap-to-black": { label: "黒への瞬間カット", description: "一瞬で真っ黒になり、間を置いて次のショットへ" },
   "match-cut": { label: "マッチカット", description: "形や動きを合わせたカット" },
   "smash-cut": { label: "スマッシュカット", description: "対照的なシーン間の衝撃的な急転" },
   "iris": { label: "アイリス", description: "円形のアイリスが閉じ、次のシーンで開く" },
   "wipe": { label: "ワイプ", description: "直線的なワイプで次のシーンへ" },
   "roll-transition": { label: "ロール", description: "フレームが90〜180°回転して次のシーンへ" },
   "seamless-match": { label: "シームレスカット", description: "動きと色で隠された完全なシームレスカット" },
+  "whip-pan": { label: "ホイップパン", description: "カメラが横に振り切れてブレ、次のショットも同じ方向に流れる" },
+  "jump-cut": { label: "ジャンプカット", description: "同じ画角のまま時間が前に飛ぶ" },
 
   // ── Time ──
   "fast-forward-day-night": { label: "日中→夜 早送り", description: "同じ場面の昼から夜へのタイムラプス" },
@@ -62,6 +65,8 @@ const map: LocaleCatalogMap = {
   "zoom-into-mouth": { label: "口へのズーム", description: "開いた口へ接近し、内側に新しい世界が" },
   "push-through-glass": { label: "ガラスをすり抜ける", description: "ガラス面をカメラが屈折しながら通り抜ける" },
   "soul-jump": { label: "魂の跳躍", description: "半透明の魂が体を出て新しい体へ入る" },
+  "mask-transition": { label: "マスクトランジション", description: "手前の物体が画面を覆い、その暗闇をカメラが抜けて新しい場面へ" },
+  "zoom-through": { label: "ズームスルー", description: "細部を拡大し続け、その中から新しい場面が広がる" },
 
   // ── Physics ──
   "explosion-blast": { label: "爆発", description: "爆発がフレームを吹き飛ばし、新シーンへ" },
@@ -73,6 +78,7 @@ const map: LocaleCatalogMap = {
   "vehicle-explosion": { label: "車両爆発", description: "前景の車両が爆発し、煙が晴れると新シーン" },
   "jump-match": { label: "ジャンプマッチ", description: "被写体が跳び、着地が新しいシーンに合致" },
   "hand-swipe": { label: "手のスワイプ", description: "手がレンズを横切り、遮蔽中にシーン転換" },
+  "action-relay": { label: "アクションつなぎ", description: "動作の途中でフレームから出て、新しい場面で同じ動きを続ける" },
 
   // ── Light ──
   "white-flash": { label: "ホワイトフラッシュ", description: "フレームが純白に膨らむ" },

package/src/i18n/transitions.ko.ts

@@ -7,12 +7,15 @@ const map: LocaleCatalogMap = {
   "cross-dissolve": { label: "크로스 디졸브", description: "샷 간의 점진적인 블렌드" },
   "fade-to-black": { label: "페이드 투 블랙", description: "화면이 어두워지고 두 번째 장면이 등장" },
   "fade-to-white": { label: "페이드 투 화이트", description: "화면이 밝아지고 두 번째 장면이 등장" },
+  "snap-to-black": { label: "블랙 스냅 컷", description: "즉시 완전한 검은 화면으로 끊었다가 다음 샷으로 전환" },
   "match-cut": { label: "매치 컷", description: "샷 간 형태나 동작의 시각적 운율" },
   "smash-cut": { label: "스매시 컷", description: "대조적인 샷 사이의 충격적인 급전환" },
   "iris": { label: "아이리스", description: "원형 조리개가 닫히고 두 번째 장면에서 열림" },
   "wipe": { label: "와이프", description: "직선 와이프로 첫 번째 샷을 대체" },
   "roll-transition": { label: "롤", description: "프레임이 90–180° 회전 후 두 번째 샷이 안정됨" },
   "seamless-match": { label: "심리스 매치", description: "동작과 색상으로 위장한 보이지 않는 컷" },
+  "whip-pan": { label: "휩 팬", description: "카메라가 옆으로 휘몰아치며 흐려지고 다음 샷도 같은 방향으로 이어짐" },
+  "jump-cut": { label: "점프 컷", description: "같은 프레이밍에서 시간만 앞으로 건너뜀" },
 
   // ── Time ──
   "fast-forward-day-night": { label: "낮→밤 타임랩스", description: "같은 장면에서 낮에서 밤으로의 타임랩스" },
@@ -62,6 +65,8 @@ const map: LocaleCatalogMap = {
   "zoom-into-mouth": { label: "입 속으로 줌", description: "열린 입 속으로 밀어 들어가 새 세계로" },
   "push-through-glass": { label: "유리를 통과", description: "카메라가 유리 면을 굴절하며 통과해 새 세계로" },
   "soul-jump": { label: "영혼 점프", description: "반투명한 영혼이 몸을 떠나 새 몸으로 들어감" },
+  "mask-transition": { label: "마스크 트랜지션", description: "전경의 물체가 화면을 가리고 카메라가 그 어둠을 통과함" },
+  "zoom-through": { label: "줌 스루", description: "카메라가 한 디테일을 확대해 그 안에서 새 장면이 펼쳐짐" },
 
   // ── Physics ──
   "explosion-blast": { label: "폭발", description: "폭발이 화면을 쓸어내고 새 장면이 드러남" },
@@ -73,6 +78,7 @@ const map: LocaleCatalogMap = {
   "vehicle-explosion": { label: "차량 폭발", description: "전경의 차량이 폭발하고 연기 걷히면 새 장면" },
   "jump-match": { label: "점프 매치", description: "피사체가 점프하고 착지가 새 장면과 연결" },
   "hand-swipe": { label: "손 스와이프", description: "손이 렌즈를 가리는 사이 장면이 전환됨" },
+  "action-relay": { label: "액션 매치 컷", description: "피사체가 동작 중 프레임을 벗어나 새 장면에서 그 동작을 이어감" },
 
   // ── Light ──
   "white-flash": { label: "화이트 플래시", description: "화면이 순백으로 빛남" },

package/src/i18n/transitions.pt-BR.ts

@@ -7,12 +7,15 @@ const map: LocaleCatalogMap = {
   "cross-dissolve": { label: "Fusão Cruzada", description: "Mistura gradual entre cenas" },
   "fade-to-black": { label: "Fade para Preto", description: "Escurece ao preto, segunda cena emerge" },
   "fade-to-white": { label: "Fade para Branco", description: "Clareia ao branco, segunda cena emerge" },
+  "snap-to-black": { label: "Corte Seco para Preto", description: "Corte instantâneo ao preto por um instante, depois a próxima cena" },
   "match-cut": { label: "Corte de Raccord", description: "Correspondência de forma ou movimento entre cenas" },
   "smash-cut": { label: "Corte Brusco", description: "Corte abrupto entre cenas visualmente contrastantes" },
   "iris": { label: "Íris", description: "Íris circular fecha e abre na segunda cena" },
   "wipe": { label: "Varredura", description: "Varredura linear substitui a primeira cena" },
   "roll-transition": { label: "Rolagem", description: "Quadro gira 90–180°, segunda cena estável" },
   "seamless-match": { label: "Corte Invisível", description: "Corte oculto disfarçado por movimento e cor" },
+  "whip-pan": { label: "Chicote de Câmera", description: "Câmera varre de lado com borrão, a próxima cena segue a mesma direção" },
+  "jump-cut": { label: "Jump Cut", description: "Mesmo enquadramento, o tempo salta adiante" },
 
   // ── Time ──
   "fast-forward-day-night": { label: "Dia → Noite (Time-lapse)", description: "Time-lapse do dia para a noite na mesma cena" },
@@ -62,6 +65,8 @@ const map: LocaleCatalogMap = {
   "zoom-into-mouth": { label: "Zoom na Boca", description: "Push na boca aberta, emerge em novo mundo" },
   "push-through-glass": { label: "Atravessar o Vidro", description: "Câmera atravessa vidro com refração para nova cena" },
   "soul-jump": { label: "Salto de Alma", description: "Alma translúcida sai do corpo, entra em novo corpo" },
+  "mask-transition": { label: "Transição de Máscara", description: "Objeto em primeiro plano cobre o quadro, câmera atravessa o escuro" },
+  "zoom-through": { label: "Zoom Atravessado", description: "Câmera amplia um detalhe até a nova cena surgir dentro dele" },
 
   // ── Physics ──
   "explosion-blast": { label: "Explosão", description: "Explosão limpa o quadro, nova cena emerge" },
@@ -73,6 +78,7 @@ const map: LocaleCatalogMap = {
   "vehicle-explosion": { label: "Explosão de Veículo", description: "Veículo explode em primeiro plano, cena muda" },
   "jump-match": { label: "Salto Combinado", description: "Sujeito pula, aterrissagem combina com nova cena" },
   "hand-swipe": { label: "Varredura de Mão", description: "Mão passa pela lente, cena muda durante a oclusão" },
+  "action-relay": { label: "Corte na Ação", description: "Sujeito sai de quadro numa ação e continua o movimento na nova cena" },
 
   // ── Light ──
   "white-flash": { label: "Flash Branco", description: "Quadro clareia ao branco" },

package/src/i18n/transitions.ru.ts

@@ -7,12 +7,15 @@ const map: LocaleCatalogMap = {
   "cross-dissolve": { label: "Перекрёстный наплыв", description: "Плавное смешение двух сцен" },
   "fade-to-black": { label: "Затемнение", description: "Постепенное затемнение, затем новая сцена" },
   "fade-to-white": { label: "Засветка", description: "Осветление до белого, затем новая сцена" },
+  "snap-to-black": { label: "Резкий уход в чёрное", description: "Мгновенный переход в чёрное на удар, затем следующий кадр" },
   "match-cut": { label: "Монтаж по форме", description: "Совпадение формы или движения между сценами" },
   "smash-cut": { label: "Резкий монтаж", description: "Резкий переход между контрастными сценами" },
   "iris": { label: "Ирис", description: "Круг закрывается, затем открывается на новой сцене" },
   "wipe": { label: "Шторка", description: "Линия пересекает кадр, открывая новую сцену" },
   "roll-transition": { label: "Прокрутка", description: "Кадр вращается на 90-180°, останавливаясь на новой сцене" },
   "seamless-match": { label: "Незаметный переход", description: "Скрытый монтаж, замаскированный движением и цветом" },
+  "whip-pan": { label: "Резкая панорама", description: "Камера резко уходит вбок в смазе, новый кадр движется в ту же сторону" },
+  "jump-cut": { label: "Джамп-кат", description: "Та же крупность, время скачком уходит вперёд" },
 
   // ── Time ──
   "fast-forward-day-night": { label: "Ускорение (день → ночь)", description: "Тайм-лапс от дня к ночи в той же сцене" },
@@ -62,6 +65,8 @@ const map: LocaleCatalogMap = {
   "zoom-into-mouth": { label: "Зум в рот", description: "Камера входит в рот и оказывается в новом мире" },
   "push-through-glass": { label: "Проход сквозь стекло", description: "Камера проходит сквозь стеклянную панель в другой мир" },
   "soul-jump": { label: "Прыжок души", description: "Полупрозрачная душа покидает одно тело и входит в другое" },
+  "mask-transition": { label: "Переход через маску", description: "Объект на переднем плане перекрывает кадр, камера проходит сквозь темноту" },
+  "zoom-through": { label: "Наезд сквозь деталь", description: "Камера укрупняет деталь, пока внутри неё не раскроется новая сцена" },
 
   // ── Physics ──
   "explosion-blast": { label: "Взрывная волна", description: "Взрыв захлёстывает кадр, открывая новую сцену" },
@@ -73,6 +78,7 @@ const map: LocaleCatalogMap = {
   "vehicle-explosion": { label: "Взрыв транспорта", description: "Машина взрывается, огонь захлёстывает кадр, открывается новая сцена" },
   "jump-match": { label: "Совпадающий прыжок", description: "Персонаж прыгает и приземляется уже в новой сцене" },
   "hand-swipe": { label: "Смахивание рукой", description: "Рука проходит перед объективом, сцена меняется" },
+  "action-relay": { label: "Монтаж по действию", description: "Герой уходит из кадра на движении и продолжает его в новой сцене" },
 
   // ── Light ──
   "white-flash": { label: "Белая вспышка", description: "Кадр заливается белым, затем появляется новая сцена" },

package/src/i18n/transitions.zh-CN.ts

@@ -7,12 +7,15 @@ const map: LocaleCatalogMap = {
   "cross-dissolve": { label: "交叉溶解", description: "两个镜头间的渐进融合" },
   "fade-to-black": { label: "淡出至黑", description: "画面变暗至全黑，第二幕浮现" },
   "fade-to-white": { label: "淡出至白", description: "画面泛白，第二幕从白光中显现" },
+  "snap-to-black": { label: "瞬切黑场", description: "瞬间切入全黑停顿一拍，随后切入下一镜头" },
   "match-cut": { label: "匹配剪辑", description: "镜头间形状或动作的视觉呼应" },
   "smash-cut": { label: "撞击剪辑", description: "对比强烈的镜头间的突兀硬切" },
   "iris": { label: "虹膜转场", description: "圆形虹膜收缩后展开至第二幕" },
   "wipe": { label: "划像", description: "直线划过替换第一个镜头" },
   "roll-transition": { label: "滚动转场", description: "画面旋转90–180°，第二幕正立落定" },
   "seamless-match": { label: "无缝匹配", description: "以运动与色调伪装的隐形剪辑" },
+  "whip-pan": { label: "甩镜", description: "镜头横向急甩带出模糊，下一镜头顺着同一方向接上" },
+  "jump-cut": { label: "跳切", description: "同一构图，时间向前跳跃" },
 
   // ── Time ──
   "fast-forward-day-night": { label: "快进（日→夜）", description: "同一场景日转夜的延时摄影" },
@@ -62,6 +65,8 @@ const map: LocaleCatalogMap = {
   "zoom-into-mouth": { label: "推入口腔", description: "推入张开的嘴，进入内部新世界" },
   "push-through-glass": { label: "穿越玻璃", description: "镜头推过玻璃折射进入新世界" },
   "soul-jump": { label: "灵魂跃迁", description: "半透明灵魂离体，跃入新身体" },
+  "mask-transition": { label: "遮罩转场", description: "前景物体遮黑画面，镜头穿过黑暗进入新场景" },
+  "zoom-through": { label: "推进穿越", description: "镜头不断放大一处细节，新场景在其中展开" },
 
   // ── Physics ──
   "explosion-blast": { label: "爆炸", description: "爆炸席卷画面，新场景从烟尘中浮现" },
@@ -73,6 +78,7 @@ const map: LocaleCatalogMap = {
   "vehicle-explosion": { label: "车辆爆炸", description: "前景车辆爆炸，火焰散去后新场景" },
   "jump-match": { label: "跳跃匹配", description: "主体起跳，落地衔接新场景" },
   "hand-swipe": { label: "手掌划过", description: "手掌扫过镜头，遮挡间场景切换" },
+  "action-relay": { label: "动作接力剪辑", description: "主体带着动作出画，在新场景中延续同一动作" },
 
   // ── Light ──
   "white-flash": { label: "白色闪光", description: "画面泛出纯白" },

package/src/i18n/types.ts

@@ -52,8 +52,6 @@ export interface LanguageDefinition {
   readonly shortCode: string
   /** Reading direction. */
   readonly dir: LocaleDirection
-  /** Optional flag emoji for visual recognition. */
-  readonly flag: string
 }
 
 /**
@@ -62,18 +60,18 @@ export interface LanguageDefinition {
  * languages, then RTL languages last.
  */
 export const LANGUAGES: ReadonlyArray<LanguageDefinition> = [
-  { id: "en",    englishName: "English",              nativeName: "English",         shortCode: "EN",  dir: "ltr", flag: "🇬🇧" },
-  { id: "es",    englishName: "Spanish",              nativeName: "Español",         shortCode: "ES",  dir: "ltr", flag: "🇪🇸" },
-  { id: "fr",    englishName: "French",               nativeName: "Français",        shortCode: "FR",  dir: "ltr", flag: "🇫🇷" },
-  { id: "de",    englishName: "German",               nativeName: "Deutsch",         shortCode: "DE",  dir: "ltr", flag: "🇩🇪" },
-  { id: "pt-BR", englishName: "Portuguese (Brazil)",  nativeName: "Português",       shortCode: "PT",  dir: "ltr", flag: "🇧🇷" },
-  { id: "ru",    englishName: "Russian",              nativeName: "Русский",         shortCode: "RU",  dir: "ltr", flag: "🇷🇺" },
-  { id: "hi",    englishName: "Hindi",                nativeName: "हिन्दी",          shortCode: "HI",  dir: "ltr", flag: "🇮🇳" },
-  { id: "ja",    englishName: "Japanese",             nativeName: "日本語",          shortCode: "JA",  dir: "ltr", flag: "🇯🇵" },
-  { id: "ko",    englishName: "Korean",               nativeName: "한국어",          shortCode: "KO",  dir: "ltr", flag: "🇰🇷" },
-  { id: "zh-CN", englishName: "Chinese (Simplified)", nativeName: "简体中文",        shortCode: "ZH",  dir: "ltr", flag: "🇨🇳" },
-  { id: "he",    englishName: "Hebrew",               nativeName: "עברית",           shortCode: "HE",  dir: "rtl", flag: "🇮🇱" },
-  { id: "ar",    englishName: "Arabic",               nativeName: "العربية",         shortCode: "AR",  dir: "rtl", flag: "🇸🇦" },
+  { id: "en",    englishName: "English",              nativeName: "English",         shortCode: "EN",  dir: "ltr" },
+  { id: "es",    englishName: "Spanish",              nativeName: "Español",         shortCode: "ES",  dir: "ltr" },
+  { id: "fr",    englishName: "French",               nativeName: "Français",        shortCode: "FR",  dir: "ltr" },
+  { id: "de",    englishName: "German",               nativeName: "Deutsch",         shortCode: "DE",  dir: "ltr" },
+  { id: "pt-BR", englishName: "Portuguese (Brazil)",  nativeName: "Português",       shortCode: "PT",  dir: "ltr" },
+  { id: "ru",    englishName: "Russian",              nativeName: "Русский",         shortCode: "RU",  dir: "ltr" },
+  { id: "hi",    englishName: "Hindi",                nativeName: "हिन्दी",          shortCode: "HI",  dir: "ltr" },
+  { id: "ja",    englishName: "Japanese",             nativeName: "日本語",          shortCode: "JA",  dir: "ltr" },
+  { id: "ko",    englishName: "Korean",               nativeName: "한국어",          shortCode: "KO",  dir: "ltr" },
+  { id: "zh-CN", englishName: "Chinese (Simplified)", nativeName: "简体中文",        shortCode: "ZH",  dir: "ltr" },
+  { id: "he",    englishName: "Hebrew",               nativeName: "עברית",           shortCode: "HE",  dir: "rtl" },
+  { id: "ar",    englishName: "Arabic",               nativeName: "العربية",         shortCode: "AR",  dir: "rtl" },
 ] as const
 
 export const LOCALE_IDS: ReadonlyArray<LocaleId> = LANGUAGES.map((l) => l.id)

package/src/index.ts

@@ -110,6 +110,7 @@ export {
   VIDEO_MODE_ALIASES,
   VIDEO_GEN_COLLAPSED_T2V_IDS,
   resolveVideoProviderForMode,
+  resolveVideoModeForInputs,
   isSeedance2Provider,
   MINIMAX_H3_PROVIDERS,
   isMinimaxH3Provider,
@@ -396,7 +397,6 @@ export {
   TILT_CARRIED_FRACTION,
   isTiltDirection,
   defaultCarriedFraction,
-  buildSurroundFillPrompt,
   type SurroundDirection,
 } from "./surround.js"
 
@@ -511,6 +511,7 @@ export {
   PARAMETER_NODE_TYPES,
   HINT_EXEMPT_PARAMETER_TYPES,
   getParameterValue,
+  setRegisteredPersonPackFields,
 } from "./parameter-node-value.js"
 
 export {
@@ -746,6 +747,8 @@ export {
   getLocaleDirection,
   ensureLocaleCatalogLoaded,
   registerSidecarLoaders,
+  registerCatalogSidecars,
+  resetCatalogSidecars,
   resolveLabel,
   resolveDescription,
   entryMatchesQuery,
@@ -762,6 +765,9 @@ export type {
   WorkflowExportObject,
   WorkflowExportCreature,
   WorkflowExportLocation,
+  WorkflowMediaRef,
+  WorkflowPortability,
+  WorkflowImportReport,
 } from "./workflow-export.js"
 export { stripExportContent } from "./workflow-export.js"
 
@@ -860,6 +866,8 @@ export * from "./reduce-strategy-registry.js"
 export {
   COMBINE_TRANSITIONS,
   COMBINE_TRANSITION_IDS,
+  PICKER_TO_COMBINE_TRANSITION,
+  resolveSlideshowTransition,
   COMBINE_TRANSITION_GROUP_ORDER,
   COMBINE_TRANSITION_GROUP_LABELS,
   getCombineTransition,
@@ -886,6 +894,8 @@ export {
   FAN_OUT_EACH_TYPES,
 } from "./producer-types.js"
 
+export { SUNO_TRACK_SOURCE_TYPES } from "./suno-track-sources.js"
+
 export {
   VOICE_CHANGER_MODELS,
   VOICE_CHANGER_MODEL_IDS,
@@ -953,3 +963,22 @@ export * from "./smart-cut-windows.js"
 
 export * from "./entity-asset-types.js"
 export * from "./hint-graph-types.js"
+
+// --- Tag-free /v1/catalogs projection wire shape (the ONLY catalog type in shared) ---
+export * from "./catalog-projection.js"
+
+// --- Organizations (second tenancy axis): wire contract only — enums, settings request schemas, error codes ---
+export * from "./organizations/index.js"
+
+export {
+  ENTITY_DB_ID_FIELD,
+  ENTITY_NAME_FIELD,
+  ENTITY_TABLE,
+  ENTITY_BUCKET_FIELDS,
+  ENTITY_KIND_SCALAR_FIELDS,
+  ENTITY_SCALAR_FIELDS,
+  entityScalarFields,
+  entityHydrationColumns,
+} from "./entity-node-fields.js"
+export { ENTITY_NODE_KINDS } from "./entity-node-fields.js"
+export type { EntityNodeKind } from "./entity-node-fields.js"

package/src/llm-models.ts

@@ -529,6 +529,9 @@ export type LlmFeature =
   // feature (not ai-writer, which it used to piggyback on) so the model
   // default and the tiered credit ids are the strategy's own.
   | "pick-best-llm"
+  // In-app Workflow Copilot turns (backend agent loop; metered, reservation
+  // ceiling under `STATIC_CREDIT_COSTS["workflow-copilot"]`).
+  | "workflow-copilot"
 
 /** Engine-dependent LlmFeature for the motion-graphics node (design §8: every credit-id site must branch on engine). */
 export function motionGraphicsFeature(engine?: string): LlmFeature {
@@ -553,6 +556,7 @@ export const LLM_FEATURE_DEFAULTS: Record<LlmFeature, string> = {
   "translate": "gemini-3.6-flash",
   "image-critic": "claude-sonnet-4.6",
   "pick-best-llm": "claude-sonnet-4.6",
+  "workflow-copilot": "claude-sonnet-5",
 }
 
 /**