@nodaro/shared 3.7.0 → 3.9.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nodaro/shared",
-  "version": "3.7.0",
+  "version": "3.9.0",
   "description": "Shared types, model catalog, wire contracts, and structural vocabularies for the Nodaro platform and SDK.",
   "type": "module",
   "license": "Apache-2.0",

package/src/__tests__/model-tree.test.ts

@@ -10,6 +10,9 @@ describe("modelToNodeTarget", () => {
     expect(modelToNodeTarget("suno")).toEqual({ nodeType: "suno-generate", field: "model", value: "V4" })
     expect(modelToNodeTarget("suno-v5")).toEqual({ nodeType: "suno-generate", field: "model", value: "V5" })
     expect(modelToNodeTarget("suno-v5_5")).toEqual({ nodeType: "suno-generate", field: "model", value: "V5_5" })
+    expect(modelToNodeTarget("suno-v6")).toEqual({ nodeType: "suno-generate", field: "model", value: "V6" })
+    expect(modelToNodeTarget("suno-v6_wild")).toEqual({ nodeType: "suno-generate", field: "model", value: "V6_WILD" })
+    expect(modelToNodeTarget("suno-v6_mini")).toEqual({ nodeType: "suno-generate", field: "model", value: "V6_MINI" })
   })
   // `elevenlabs-dubbing` is a single-provider utility whose id is NOT in any
   // provider-enum array, so it exercises the modes fallback → bare node, no preset.

package/src/__tests__/normalize-model-input.test.ts

@@ -76,6 +76,38 @@ describe("normalizeModelInput", () => {
     expect(normalizeModelInput("gpt-image-2", { aspectRatio: "1:1", resolution: "4K" }).resolution).toBe("2K")
   })
 
+  // GPT Image 2.5 is NOT GPT Image 2. Its KIE docs
+  // (docs.kie.ai/market/gpt/gpt-image-2-5-*) state no aspect_ratio x resolution
+  // restriction, so the cross-field block above must NOT be widened to these
+  // ids "for consistency" — doing so would silently downgrade a paid 4K render
+  // to 1K. If GPT Image 2.5 ever documents such a limit, add it deliberately
+  // and change this test in the same commit.
+  it.each([
+    "gpt-image-2-5-flare",
+    "gpt-image-2-5-flare-i2i",
+    "gpt-image-2-5-sunburst",
+    "gpt-image-2-5-sunburst-i2i",
+  ])("%s has NO cross-field aspect-ratio x resolution rule", (modelId) => {
+    const auto4k = normalizeModelInput(modelId, { aspectRatio: "auto", resolution: "4K" })
+    expect(auto4k.resolution).toBe("4K")
+    expect(auto4k.adjustments).toEqual([])
+
+    const square4k = normalizeModelInput(modelId, { aspectRatio: "1:1", resolution: "4K" })
+    expect(square4k.resolution).toBe("4K")
+    expect(square4k.adjustments).toEqual([])
+  })
+
+  // The four ratios 2.5 introduced are new to the platform vocabulary; the snap
+  // must accept them rather than rewrite them to a neighbour.
+  it.each(["27:16", "16:27", "9:8", "8:9", "21:9", "3:2"])(
+    "gpt-image-2.5 keeps the newly-added ratio %s",
+    (ratio) => {
+      const out = normalizeModelInput("gpt-image-2-5-flare", { aspectRatio: ratio })
+      expect(out.aspectRatio).toBe(ratio)
+      expect(out.adjustments).toEqual([])
+    },
+  )
+
   it("passes unknown model ids through untouched (the Zod enum owns those)", () => {
     const out = normalizeModelInput("totally-fake-model", { aspectRatio: "21:9" })
     expect(out.aspectRatio).toBe("21:9")

package/src/__tests__/scene3d-render-pricing.test.ts

@@ -0,0 +1,157 @@
+import { describe, it, expect } from "vitest"
+import {
+  PRO3D_RENDER_QUALITY_PROFILES,
+  RENDER_VIDEO_CREDIT_ID,
+  SCENE3D_LIMITS,
+  SCENE3D_RENDER_BASE_MAX_PX,
+  SCENE3D_RENDER_TIERS,
+  SCENE3D_RENDER_TIER_MULTIPLIERS,
+  SCENE3D_RENDER_XLARGE_MIN_AREA_PX,
+  pro3DRenderFrameUnit,
+  renderVideoCreditId,
+  scene3DRenderTier,
+  scene3DRenderTierCredits,
+} from "../index.js"
+
+/** The three reference frames the tiers are anchored to (PR #1328). */
+const REFERENCE_FRAMES = {
+  base: { width: 1920, height: 1080 },
+  large: { width: 2560, height: 1440 },
+  xlarge: { width: 2560, height: 2560 },
+} as const
+
+describe("scene3DRenderTier", () => {
+  it("places each reference frame in its own tier", () => {
+    for (const [tier, frame] of Object.entries(REFERENCE_FRAMES)) {
+      expect(scene3DRenderTier(frame.width, frame.height)).toBe(tier)
+    }
+  })
+
+  it("holds every pre-cap frame at the base price, square ones included", () => {
+    // The promise of the 1920 gate: raising maxDimensionPx never reprices a
+    // frame that was already renderable. 1920x1920 has the SAME pixel count as
+    // 2560x1440 and is still base — area only decides ABOVE the gate.
+    expect(scene3DRenderTier(1920, 1080)).toBe("base")
+    expect(scene3DRenderTier(1080, 1920)).toBe("base")
+    expect(scene3DRenderTier(1920, 1920)).toBe("base")
+    expect(scene3DRenderTier(1680, 720)).toBe("base")
+    expect(SCENE3D_RENDER_BASE_MAX_PX).toBe(1920)
+  })
+
+  it("tiers every aspect the 2560 cap makes reachable", () => {
+    expect(scene3DRenderTier(2560, 1440)).toBe("large") // 16:9
+    expect(scene3DRenderTier(1440, 2560)).toBe("large") // 9:16
+    expect(scene3DRenderTier(2560, 1097)).toBe("large") // 21:9
+    expect(scene3DRenderTier(2048, 2560)).toBe("xlarge") // 4:5
+    expect(scene3DRenderTier(2560, 2560)).toBe("xlarge") // 1:1
+  })
+
+  it("splits large from xlarge at the midpoint of the two upper reference frames", () => {
+    const midpoint = (REFERENCE_FRAMES.large.width * REFERENCE_FRAMES.large.height + REFERENCE_FRAMES.xlarge.width * REFERENCE_FRAMES.xlarge.height) / 2
+    expect(SCENE3D_RENDER_XLARGE_MIN_AREA_PX).toBe(midpoint)
+    // One pixel either side of the boundary, at a width past the gate.
+    expect(scene3DRenderTier(2560, 2000)).toBe("large") // 5,120,000 exactly
+    expect(scene3DRenderTier(2560, 2001)).toBe("xlarge") // 5,122,560
+  })
+
+  it("is base for anything that is not a pair of positive finite numbers", () => {
+    expect(scene3DRenderTier(undefined, undefined)).toBe("base")
+    expect(scene3DRenderTier("2560", "2560")).toBe("base")
+    expect(scene3DRenderTier(Number.NaN, 2560)).toBe("base")
+    expect(scene3DRenderTier(Infinity, 2560)).toBe("base")
+    expect(scene3DRenderTier(0, 2560)).toBe("base")
+    expect(scene3DRenderTier(-2560, -2560)).toBe("base")
+  })
+
+  it("covers the whole admissible range with a declared tier", () => {
+    const max = SCENE3D_LIMITS.maxDimensionPx
+    for (const w of [SCENE3D_LIMITS.minDimensionPx, 640, 1920, 1921, 2048, max]) {
+      for (const h of [SCENE3D_LIMITS.minDimensionPx, 640, 1920, 1921, 2048, max]) {
+        expect(SCENE3D_RENDER_TIERS).toContain(scene3DRenderTier(w, h))
+      }
+    }
+  })
+})
+
+describe("scene3DRenderTierCredits", () => {
+  it("is the declared ratio, rounded up", () => {
+    // The worked examples the public docs print, from the built-in base of 50.
+    expect(scene3DRenderTierCredits(50, "base")).toBe(50)
+    expect(scene3DRenderTierCredits(50, "large")).toBe(75)
+    expect(scene3DRenderTierCredits(50, "xlarge")).toBe(125)
+  })
+
+  it("never rounds a tier down below the base render it multiplies", () => {
+    for (const base of [1, 3, 7, 15, 33, 50, 137]) {
+      for (const tier of SCENE3D_RENDER_TIERS) {
+        expect(scene3DRenderTierCredits(base, tier)).toBeGreaterThanOrEqual(base)
+        expect(scene3DRenderTierCredits(base, tier)).toBe(
+          Math.ceil(base * SCENE3D_RENDER_TIER_MULTIPLIERS[tier]),
+        )
+      }
+    }
+  })
+
+  it("keeps the ladder monotonic", () => {
+    expect(SCENE3D_RENDER_TIER_MULTIPLIERS.base).toBe(1)
+    expect(SCENE3D_RENDER_TIER_MULTIPLIERS.large).toBeGreaterThan(SCENE3D_RENDER_TIER_MULTIPLIERS.base)
+    expect(SCENE3D_RENDER_TIER_MULTIPLIERS.xlarge).toBeGreaterThan(SCENE3D_RENDER_TIER_MULTIPLIERS.large)
+  })
+})
+
+describe("renderVideoCreditId", () => {
+  it("keeps the bare identifier for a base-sized 3D scene plan", () => {
+    expect(renderVideoCreditId({ planType: "3d-scene", plan: { width: 1920, height: 1080 } })).toBe(
+      RENDER_VIDEO_CREDIT_ID,
+    )
+  })
+
+  it("names the tier for a plan past the 1920 gate", () => {
+    expect(renderVideoCreditId({ planType: "3d-scene", plan: { width: 2560, height: 1440 } })).toBe(
+      "render-video:3d-large",
+    )
+    expect(renderVideoCreditId({ planType: "3d-scene", plan: { width: 2560, height: 2560 } })).toBe(
+      "render-video:3d-xlarge",
+    )
+  })
+
+  it("leaves every non-3D render on the flat identifier", () => {
+    // scene-graph admits frames up to 3840 today at the flat price; tiering it
+    // would raise the price of work people already run.
+    expect(renderVideoCreditId({ planType: "scene-graph", plan: { width: 3840, height: 2160 } })).toBe(
+      RENDER_VIDEO_CREDIT_ID,
+    )
+    expect(renderVideoCreditId({ planType: "lottie-graphic", plan: { width: 2560, height: 2560 } })).toBe(
+      RENDER_VIDEO_CREDIT_ID,
+    )
+    expect(renderVideoCreditId({ template: "slideshow", aspectRatio: "16:9" })).toBe(RENDER_VIDEO_CREDIT_ID)
+  })
+
+  it("answers the flat identifier for anything unparseable", () => {
+    expect(renderVideoCreditId(undefined)).toBe(RENDER_VIDEO_CREDIT_ID)
+    expect(renderVideoCreditId(null)).toBe(RENDER_VIDEO_CREDIT_ID)
+    expect(renderVideoCreditId("3d-scene")).toBe(RENDER_VIDEO_CREDIT_ID)
+    expect(renderVideoCreditId({ planType: "3d-scene" })).toBe(RENDER_VIDEO_CREDIT_ID)
+    expect(renderVideoCreditId({ planType: "3d-scene", plan: "{}" })).toBe(RENDER_VIDEO_CREDIT_ID)
+    expect(renderVideoCreditId({ planType: "3d-scene", plan: {} })).toBe(RENDER_VIDEO_CREDIT_ID)
+  })
+})
+
+describe("pro3DRenderFrameUnit", () => {
+  it("keeps the configured spelling for base-sized frames", () => {
+    for (const quality of PRO3D_RENDER_QUALITY_PROFILES) {
+      expect(pro3DRenderFrameUnit(quality)).toBe(`pro-3d-render:render-frame:${quality}`)
+      expect(pro3DRenderFrameUnit(quality, "base")).toBe(`pro-3d-render:render-frame:${quality}`)
+    }
+  })
+
+  it("suffixes the tier for a frame past the gate", () => {
+    expect(pro3DRenderFrameUnit("standard", "large")).toBe("pro-3d-render:render-frame:standard:large")
+    expect(pro3DRenderFrameUnit("standard", "xlarge")).toBe("pro-3d-render:render-frame:standard:xlarge")
+  })
+
+  it("produces one distinct unit per tier", () => {
+    const units = new Set(SCENE3D_RENDER_TIERS.map((tier) => pro3DRenderFrameUnit("standard", tier)))
+    expect(units.size).toBe(SCENE3D_RENDER_TIERS.length)
+  })
+})

package/src/__tests__/scene3d-v2.test.ts

@@ -108,7 +108,10 @@ describe("scene3d v2 — v1 is untouched", () => {
     expect(SCENE3D_LIMITS.maxObjects).toBe(100)
     expect(SCENE3D_LIMITS.maxKeyframes).toBe(240)
     expect(SCENE3D_LIMITS.maxHierarchyDepth).toBe(8)
-    expect(SCENE3D_LIMITS.maxDimensionPx).toBe(1920)
+    // Widened from 1920 deliberately (measured, both versions together) —
+    // every other v1 bound above is still frozen.
+    expect(SCENE3D_LIMITS.maxDimensionPx).toBe(2560)
+    expect(SCENE3D_V2_LIMITS.maxDimensionPx).toBe(SCENE3D_LIMITS.maxDimensionPx)
     expect(SCENE3D_LIMITS.maxReferences).toBe(8)
   })
 

package/src/__tests__/suno-credit-type.test.ts

@@ -1,18 +1,64 @@
 import { describe, it, expect } from "vitest"
 import {
   sunoCreditType,
+  SUNO_VERSION_CREDIT_KEYS,
   SUNO_VERSION_PRICED_OPERATIONS,
   SUNO_SELECT_OPERATIONS,
   SUNO_MODELS,
+  SUNO_ACTIVE_MODELS,
+  SUNO_LEGACY_MODELS,
+  SUNO_ADD_TRACK_MODELS,
+  DEFAULT_SUNO_MODEL,
+  sunoModelHonoursDuration,
+  MODEL_CATALOG,
 } from "../index.js"
 
 describe("sunoCreditType — the ONE implementation of the Suno route pricing contract", () => {
   it("prices generate/cover/extend by model version", () => {
+    expect(sunoCreditType("V6", "suno-generate")).toBe("suno-v6")
+    expect(sunoCreditType("V6_WILD", "suno-cover")).toBe("suno-v6_wild")
+    expect(sunoCreditType("V6_MINI", "suno-extend")).toBe("suno-v6_mini")
     expect(sunoCreditType("V5_5", "suno-generate")).toBe("suno-v5_5")
     expect(sunoCreditType("V5", "suno-cover")).toBe("suno-v5")
     expect(sunoCreditType("V5_5", "suno-extend")).toBe("suno-v5_5")
   })
 
+  // A new active version with no key would silently bill at the operation
+  // key — and be invisible in /admin/models. Every active version must own a
+  // key, and that key must be the pricing identifier of the catalog entry
+  // whose dataValue is that version (the Models tab + /v1/models contract).
+  it("gives every ACTIVE version its own credit key, matching its catalog entry", () => {
+    const sunoEntries = Object.values(MODEL_CATALOG).filter((m) => m.family === "Suno")
+    for (const model of SUNO_ACTIVE_MODELS) {
+      const key = SUNO_VERSION_CREDIT_KEYS[model]
+      expect(key, `${model} has no SUNO_VERSION_CREDIT_KEYS row`).toBeTruthy()
+      for (const op of SUNO_VERSION_PRICED_OPERATIONS) {
+        expect(sunoCreditType(model, op)).toBe(key)
+      }
+      const entry = sunoEntries.find((m) => m.dataValue === model)
+      expect(entry, `${model} has no MODEL_CATALOG entry with dataValue`).toBeTruthy()
+      expect(entry!.pricing.map((p) => p.identifier)).toContain(key)
+    }
+  })
+
+  it("keeps the model lists active-first with the default at the head", () => {
+    expect([...SUNO_ACTIVE_MODELS]).toEqual(["V6", "V6_WILD", "V6_MINI"])
+    expect(SUNO_MODELS[0]).toBe(DEFAULT_SUNO_MODEL)
+    expect([...SUNO_MODELS]).toEqual([...SUNO_ACTIVE_MODELS, ...SUNO_LEGACY_MODELS])
+    // The two halves never overlap.
+    for (const legacy of SUNO_LEGACY_MODELS) {
+      expect(SUNO_ACTIVE_MODELS as readonly string[]).not.toContain(legacy)
+    }
+    for (const m of SUNO_ADD_TRACK_MODELS) expect(SUNO_MODELS as readonly string[]).toContain(m)
+    for (const m of SUNO_ACTIVE_MODELS) expect(SUNO_ADD_TRACK_MODELS as readonly string[]).toContain(m)
+  })
+
+  it("honours duration on the V6 family only (V5_5 was struck from the docs sentence)", () => {
+    for (const m of SUNO_ACTIVE_MODELS) expect(sunoModelHonoursDuration(m)).toBe(true)
+    for (const m of SUNO_LEGACY_MODELS) expect(sunoModelHonoursDuration(m)).toBe(false)
+    expect(sunoModelHonoursDuration(undefined)).toBe(false)
+  })
+
   it("falls back to the operation key for versions with no dedicated price", () => {
     expect(sunoCreditType("V4", "suno-generate")).toBe("suno-generate")
     expect(sunoCreditType("V4_5ALL", "suno-cover")).toBe("suno-cover")

package/src/credit-identifiers.ts

@@ -598,14 +598,29 @@ export const SUNO_SELECT_OPERATIONS = [
  * node badges. It is a billing key — NEVER a KIE provider id — which is what
  * satisfies the B3 egress invariant.
  *
- * V5_5 → "suno-v5_5", V5 → "suno-v5", any other version → the operation key.
- * A non-version-priced operation is returned unchanged.
+ * The version → key map is {@link SUNO_VERSION_CREDIT_KEYS}; a version with no
+ * entry (V4 / V4_5 / V4_5ALL / V4_5PLUS) falls back to the operation key, and a
+ * non-version-priced operation is returned unchanged.
  */
 export function sunoCreditType(model: string | undefined, operation: string): string {
   if (!(SUNO_VERSION_PRICED_OPERATIONS as readonly string[]).includes(operation)) {
     return operation
   }
-  if (model === "V5_5") return "suno-v5_5"
-  if (model === "V5") return "suno-v5"
-  return operation
+  return (model && SUNO_VERSION_CREDIT_KEYS[model]) || operation
+}
+
+/**
+ * Suno version → Nodaro credit key for the version-priced operations. One row
+ * per version that has its own `model_pricing` row / `STATIC_CREDIT_COSTS`
+ * entry / `MODEL_CATALOG` pricing row, so an admin can reprice one version
+ * without touching code. Every ACTIVE version MUST have a row here — guarded
+ * by `__tests__/suno-credit-type.test.ts` (a new active version with no key
+ * would silently bill at the operation key).
+ */
+export const SUNO_VERSION_CREDIT_KEYS: Readonly<Record<string, string>> = {
+  V6: "suno-v6",
+  V6_WILD: "suno-v6_wild",
+  V6_MINI: "suno-v6_mini",
+  V5_5: "suno-v5_5",
+  V5: "suno-v5",
 }

package/src/i18n/camera-motions.ar.ts

@@ -22,8 +22,8 @@ const map: LocaleCatalogMap = {
   "dolly-in": { label: "Dolly In", description: "دفع الكاميرا نحو الموضوع (تباين منظور)" },
   "dolly-out": { label: "Dolly Out", description: "سحب الكاميرا للخلف (تباين منظور)" },
   "dolly-zoom": { label: "Dolly Zoom", description: "تأثير Vertigo: Dolly يعاكس Zoom" },
-  "push-in": { label: "Push In", description: "دفع بطيء خفيف نحو الموضوع" },
-  "pull-out": { label: "Pull Out", description: "سحب بطيء خفيف عن الموضوع" },
+  "push-in": { label: "Push In", description: "دفع سريع قوي نحو الموضوع" },
+  "pull-out": { label: "Pull Out", description: "سحب سريع قوي عن الموضوع" },
   "breathing": { label: "كاميرا تتنفس", description: "تذبذب مستمر خفيف من الدفع والسحب، إحساس عضوي بالكاميرا المحمولة باليد" },
   "push-pull": { label: "Push-Pull / تأرجح", description: "تتحرك الكاميرا نحو الموضوع ثم تعود للخلف، اقتراب وانسحاب متأرجح" },
   "creep-in": { label: "Creep-In", description: "Push-in بطيء بشكل غير محسوس يبني الرعب أو التوتر" },
@@ -39,8 +39,8 @@ const map: LocaleCatalogMap = {
   "roll-right": { label: "Roll لليمين", description: "تدوير الكاميرا مع عقارب الساعة" },
   "dutch-angle": { label: "Dutch Angle", description: "إطار ثابت مائل للتوتر" },
 
-  "orbit-left": { label: "دوران Orbit يسار", description: "دائرة كاملة حول الموضوع لليسار" },
-  "orbit-right": { label: "دوران Orbit يمين", description: "دائرة كاملة حول الموضوع لليمين" },
+  "orbit-left": { label: "دوران Orbit يسار", description: "دوران جزئي واسع حول الموضوع لليسار" },
+  "orbit-right": { label: "دوران Orbit يمين", description: "دوران جزئي واسع حول الموضوع لليمين" },
   "spin-360": { label: "دوران كامل 360°", description: "تدور الكاميرا 360 درجة كاملة حول محورها" },
   "orbit-360": { label: "Orbit كامل 360°", description: "تتحرك الكاميرا في قوس كامل 360 درجة حول الموضوع" },
   "arc-left": { label: "قوس Arc يسار", description: "قوس جزئي حول الموضوع لليسار" },
@@ -75,7 +75,7 @@ const map: LocaleCatalogMap = {
   "handheld-vlog": { label: "Handheld Vlog", description: "محمول باليد بأسلوب Vlog عفوي" },
   "pov-walk": { label: "POV مشي", description: "مشي بمنظور الشخص الأول" },
   "velocity-edit": { label: "Velocity Edit", description: "إيقاع Speed-Ramp بأسلوب TikTok" },
-  "match-cut-zoom": { label: "Match Cut Zoom", description: "تقريب موقت على الإيقاع للقطع" },
+  "match-cut-zoom": { label: "Match Cut Zoom", description: "تقريب سريع مع قطع حاد إلى شكل مطابق" },
   "screen-tap": { label: "Screen Tap", description: "انتقال نقر إصبع على الشاشة" },
   "phone-flip": { label: "قلب الهاتف", description: "قلب الكاميرا الأمامية/الخلفية" },
   // Location-studio extension (PR #2505 follow-up)

package/src/i18n/camera-motions.de.ts

@@ -18,8 +18,8 @@ const map: LocaleCatalogMap = {
   "dolly-in": { label: "Dolly hinein", description: "Kamera zum Motiv schieben (Parallaxe)" },
   "dolly-out": { label: "Dolly heraus", description: "Kamera wegziehen (Parallaxe)" },
   "dolly-zoom": { description: "Vertigo-Effekt: Dolly entgegen Zoom" },
-  "push-in": { label: "Push-In", description: "Langsames sanftes Schieben zum Motiv" },
-  "pull-out": { label: "Pull-Out", description: "Langsames sanftes Zurückziehen vom Motiv" },
+  "push-in": { label: "Push-In", description: "Schnelles kraftvolles Schieben zum Motiv" },
+  "pull-out": { label: "Pull-Out", description: "Schnelles kraftvolles Zurückziehen vom Motiv" },
   "breathing": { label: "Atmende Kamera", description: "Subtile, kontinuierliche Push-In/Pull-Out-Oszillation, organisches Handkamera-Gefühl" },
   "push-pull": { label: "Push-Pull / Schwingen", description: "Kamera bewegt sich zum Motiv und wieder zurück, schwingende Annäherung und Rückzug" },
   "creep-in": { label: "Creep-In", description: "Unmerklich langsames Heranschieben, baut Bedrohung oder Spannung auf" },
@@ -31,8 +31,8 @@ const map: LocaleCatalogMap = {
   "roll-left": { label: "Rollen nach links", description: "Kamera gegen den Uhrzeigersinn drehen" },
   "roll-right": { label: "Rollen nach rechts", description: "Kamera im Uhrzeigersinn drehen" },
   "dutch-angle": { description: "Statischer geneigter Bildausschnitt für Spannung" },
-  "orbit-left": { label: "Orbit nach links", description: "Vollkreis um das Motiv nach links" },
-  "orbit-right": { label: "Orbit nach rechts", description: "Vollkreis um das Motiv nach rechts" },
+  "orbit-left": { label: "Orbit nach links", description: "Großer Teil-Orbit um das Motiv nach links" },
+  "orbit-right": { label: "Orbit nach rechts", description: "Großer Teil-Orbit um das Motiv nach rechts" },
   "spin-360": { label: "Volle 360°-Drehung", description: "Kamera dreht sich vollständig um 360 Grad um die eigene Achse" },
   "orbit-360": { label: "Voller 360°-Orbit", description: "Kamera beschreibt einen vollständigen 360-Grad-Bogen um das Motiv" },
   "arc-left": { label: "Bogen nach links", description: "Teilbogen um das Motiv nach links" },
@@ -63,7 +63,7 @@ const map: LocaleCatalogMap = {
   "handheld-vlog": { label: "Handgehaltenes Vlog", description: "Lässige vlog-artige Handkamera" },
   "pov-walk": { label: "POV-Gehen", description: "First-Person-Walking-POV" },
   "velocity-edit": { description: "TikTok-Speed-Ramp-Tempo" },
-  "match-cut-zoom": { description: "Beat-getakteter Zoom für Schnitte" },
+  "match-cut-zoom": { description: "Schneller Zoom mit hartem Schnitt auf eine passende Form" },
   "screen-tap": { label: "Screen-Tap", description: "On-Screen-Fingertipp-Übergang" },
   "phone-flip": { label: "Phone-Flip", description: "Front-/Rückkamera-Wechsel" },
   // Location-studio extension (PR #2505 follow-up)

package/src/i18n/camera-motions.es.ts

@@ -22,8 +22,8 @@ const map: LocaleCatalogMap = {
   "dolly-in": { label: "Dolly In", description: "Empujar la cámara hacia el sujeto (paralaje)" },
   "dolly-out": { label: "Dolly Out", description: "Alejar la cámara (paralaje)" },
   "dolly-zoom": { label: "Dolly Zoom", description: "Efecto vértigo: dolly opuesto al zoom" },
-  "push-in": { label: "Empuje", description: "Empuje sutil y lento hacia el sujeto" },
-  "pull-out": { label: "Retroceso", description: "Retroceso sutil y lento desde el sujeto" },
+  "push-in": { label: "Empuje", description: "Empuje rápido y enérgico hacia el sujeto" },
+  "pull-out": { label: "Retroceso", description: "Retroceso rápido y enérgico desde el sujeto" },
   "breathing": { label: "Cámara Respirante", description: "Oscilación sutil y continua de empuje y retroceso, sensación orgánica de cámara en mano" },
   "push-pull": { label: "Push-Pull / Vaivén", description: "La cámara se mueve hacia el sujeto y luego se aleja, una aproximación y retirada oscilante" },
   "creep-in": { label: "Acercamiento Imperceptible", description: "Empuje extremadamente lento e imperceptible que crea pavor o tensión" },
@@ -39,8 +39,8 @@ const map: LocaleCatalogMap = {
   "roll-right": { label: "Rotación a la Derecha", description: "Rotar la cámara en sentido horario" },
   "dutch-angle": { description: "Cuadro inclinado estático para tensión" },
 
-  "orbit-left": { label: "Órbita a la Izquierda", description: "Círculo completo alrededor del sujeto a la izquierda" },
-  "orbit-right": { label: "Órbita a la Derecha", description: "Círculo completo alrededor del sujeto a la derecha" },
+  "orbit-left": { label: "Órbita a la Izquierda", description: "Órbita parcial amplia alrededor del sujeto a la izquierda" },
+  "orbit-right": { label: "Órbita a la Derecha", description: "Órbita parcial amplia alrededor del sujeto a la derecha" },
   "spin-360": { label: "Giro Completo 360°", description: "La cámara rota 360 grados completos sobre su eje" },
   "orbit-360": { label: "Órbita Completa 360°", description: "La cámara describe un arco completo de 360 grados alrededor del sujeto" },
   "arc-left": { label: "Arco a la Izquierda", description: "Arco parcial alrededor del sujeto a la izquierda" },
@@ -75,7 +75,7 @@ const map: LocaleCatalogMap = {
   "handheld-vlog": { label: "Vlog en Mano", description: "Cámara casual estilo vlog en mano" },
   "pov-walk": { label: "POV Caminando", description: "POV caminando en primera persona" },
   "velocity-edit": { label: "Edición de Velocidad", description: "Ritmo con rampa de velocidad estilo TikTok" },
-  "match-cut-zoom": { label: "Zoom de Match Cut", description: "Zoom sincronizado al ritmo para cortes" },
+  "match-cut-zoom": { label: "Zoom de Match Cut", description: "Zoom rápido con corte seco a una forma coincidente" },
   "screen-tap": { label: "Toque de Pantalla", description: "Transición con toque de dedo en pantalla" },
   "phone-flip": { label: "Cambio de Cámara del Teléfono", description: "Cambio entre cámara frontal y trasera" },
   // Location-studio extension (PR #2505 follow-up)

package/src/i18n/camera-motions.fr.ts

@@ -23,8 +23,8 @@ const map: LocaleCatalogMap = {
   "dolly-in": { label: "Travelling avant", description: "Pousser la caméra vers le sujet (parallaxe)" },
   "dolly-out": { label: "Travelling arrière", description: "Reculer la caméra (parallaxe)" },
   "dolly-zoom": { description: "Effet vertigo : travelling opposé au zoom" },
-  "push-in": { label: "Push in", description: "Poussée subtile et lente vers le sujet" },
-  "pull-out": { label: "Pull out", description: "Recul subtil et lent depuis le sujet" },
+  "push-in": { label: "Push in", description: "Poussée rapide et énergique vers le sujet" },
+  "pull-out": { label: "Pull out", description: "Recul rapide et énergique depuis le sujet" },
   "breathing": { label: "Caméra respirante", description: "Oscillation continue et subtile de poussée et recul, sensation organique caméra à l'épaule" },
   "push-pull": { label: "Push-Pull / Va-et-vient", description: "La caméra avance vers le sujet puis recule, approche-retrait oscillant" },
   "creep-in": { label: "Approche imperceptible", description: "Poussée extrêmement lente et imperceptible qui installe la peur ou la tension" },
@@ -40,8 +40,8 @@ const map: LocaleCatalogMap = {
   "roll-right": { label: "Roulis à droite", description: "Pivoter la caméra dans le sens horaire" },
   "dutch-angle": { description: "Cadre incliné statique pour la tension" },
   // Orbit
-  "orbit-left": { label: "Orbite à gauche", description: "Cercle complet autour du sujet vers la gauche" },
-  "orbit-right": { label: "Orbite à droite", description: "Cercle complet autour du sujet vers la droite" },
+  "orbit-left": { label: "Orbite à gauche", description: "Grande orbite partielle autour du sujet vers la gauche" },
+  "orbit-right": { label: "Orbite à droite", description: "Grande orbite partielle autour du sujet vers la droite" },
   "spin-360": { label: "Tour complet 360°", description: "La caméra effectue un tour complet de 360 degrés sur son axe" },
   "orbit-360": { label: "Orbite complète 360°", description: "La caméra décrit un arc complet de 360 degrés autour du sujet" },
   "arc-left": { label: "Arc à gauche", description: "Arc partiel autour du sujet à gauche" },
@@ -75,7 +75,7 @@ const map: LocaleCatalogMap = {
   "handheld-vlog": { label: "Vlog à l'épaule", description: "Caméra à l'épaule décontractée style vlog" },
   "pov-walk": { label: "Marche en POV", description: "POV de marche à la première personne" },
   "velocity-edit": { description: "Cadence en speed-ramp style TikTok" },
-  "match-cut-zoom": { description: "Zoom synchronisé sur un beat pour des coupes" },
+  "match-cut-zoom": { description: "Zoom rapide avec coupe franche sur une forme identique" },
   "screen-tap": { description: "Transition tap à l'écran à l'image" },
   "phone-flip": { description: "Bascule entre caméra avant et arrière" },
   // Location-studio extension (PR #2505 follow-up)

package/src/i18n/camera-motions.he.ts

@@ -22,8 +22,8 @@ const map: LocaleCatalogMap = {
   "dolly-in": { label: "Dolly In", description: "דחף מצלמה לעבר הסובייקט (פרלקסה)" },
   "dolly-out": { label: "Dolly Out", description: "משוך מצלמה הרחק (פרלקסה)" },
   "dolly-zoom": { label: "Dolly Zoom", description: "אפקט ורטיגו: dolly מנוגד ל-zoom" },
-  "push-in": { label: "Push In", description: "דחיפה איטית עדינה לעבר הסובייקט" },
-  "pull-out": { label: "Pull Out", description: "משיכה איטית עדינה מהסובייקט" },
+  "push-in": { label: "Push In", description: "דחיפה מהירה ונמרצת לעבר הסובייקט" },
+  "pull-out": { label: "Pull Out", description: "משיכה מהירה ונמרצת מהסובייקט" },
   "breathing": { label: "מצלמה נושמת", description: "תנודה עדינה ורציפה של push-in / pull-out, תחושת handheld אורגנית" },
   "push-pull": { label: "Push-Pull / נדנוד", description: "המצלמה נעה לעבר הסובייקט וחזרה אחורה, גישה והתרחקות מתנדנדות" },
   "creep-in": { label: "Creep-In", description: "Push-in איטי באופן בלתי מורגש, בונה אימה או מתח" },
@@ -39,8 +39,8 @@ const map: LocaleCatalogMap = {
   "roll-right": { label: "Roll ימינה", description: "סובב מצלמה עם כיוון השעון" },
   "dutch-angle": { label: "Dutch Angle", description: "פריים מוטה סטטי ליצירת מתח" },
 
-  "orbit-left": { label: "Orbit שמאלה", description: "מעגל שלם סביב הסובייקט שמאלה" },
-  "orbit-right": { label: "Orbit ימינה", description: "מעגל שלם סביב הסובייקט ימינה" },
+  "orbit-left": { label: "Orbit שמאלה", description: "הקפה חלקית רחבה סביב הסובייקט שמאלה" },
+  "orbit-right": { label: "Orbit ימינה", description: "הקפה חלקית רחבה סביב הסובייקט ימינה" },
   "spin-360": { label: "סיבוב מלא 360°", description: "המצלמה מסתובבת 360 מעלות מלאות סביב צירה" },
   "orbit-360": { label: "Orbit מלא 360°", description: "המצלמה מתארת קשת מלאה של 360 מעלות סביב הסובייקט" },
   "arc-left": { label: "Arc שמאלה", description: "קשת חלקית סביב הסובייקט שמאלה" },
@@ -75,7 +75,7 @@ const map: LocaleCatalogMap = {
   "handheld-vlog": { label: "Vlog יד", description: "מצלמת יד קז'ואל בסגנון vlog" },
   "pov-walk": { label: "POV הליכה", description: "POV הליכה בגוף ראשון" },
   "velocity-edit": { label: "Velocity Edit", description: "קצב Speed-ramp של TikTok" },
-  "match-cut-zoom": { label: "Match Cut Zoom", description: "Zoom בקצב לחיתוכים" },
+  "match-cut-zoom": { label: "Match Cut Zoom", description: "Zoom מהיר עם חיתוך חד לצורה תואמת" },
   "screen-tap": { label: "Screen Tap", description: "מעבר עם נקישת אצבע על המסך" },
   "phone-flip": { label: "היפוך טלפון", description: "היפוך מצלמה קדמית/אחורית" },
   // Location-studio extension (PR #2505 follow-up)

package/src/i18n/camera-motions.hi.ts

@@ -27,8 +27,8 @@ const map: LocaleCatalogMap = {
   "dolly-in": { label: "Dolly In", description: "camera को subject की ओर धकेलें (parallax)" },
   "dolly-out": { label: "Dolly Out", description: "camera को दूर खींचें (parallax)" },
   "dolly-zoom": { label: "Dolly Zoom", description: "Vertigo प्रभाव: dolly zoom के विपरीत" },
-  "push-in": { label: "Push In", description: "subject की ओर धीमा सूक्ष्म push" },
-  "pull-out": { label: "Pull Out", description: "subject से धीमा सूक्ष्म pull back" },
+  "push-in": { label: "Push In", description: "subject की ओर तेज़ ज़ोरदार push" },
+  "pull-out": { label: "Pull Out", description: "subject से तेज़ ज़ोरदार pull back" },
   "breathing": { label: "Breathing Camera", description: "सूक्ष्म निरंतर push-in / pull-out दोलन, organic handheld अनुभव" },
   "push-pull": { label: "Push-Pull / Swing", description: "Camera subject की ओर बढ़ता है फिर पीछे, झूलता हुआ approach-and-retreat" },
   "creep-in": { label: "Creep-In", description: "अदृश्य रूप से धीमा push-in जो भय या तनाव बढ़ाता है" },
@@ -48,8 +48,8 @@ const map: LocaleCatalogMap = {
   "dutch-angle": { label: "Dutch Angle", description: "तनाव के लिए स्थिर tilted frame" },
 
   // Orbit / Arc
-  "orbit-left": { label: "Orbit बाएँ", description: "subject के चारों ओर बाएँ पूरा वृत्त" },
-  "orbit-right": { label: "Orbit दाएँ", description: "subject के चारों ओर दाएँ पूरा वृत्त" },
+  "orbit-left": { label: "Orbit बाएँ", description: "subject के चारों ओर बाएँ बड़ा आंशिक orbit" },
+  "orbit-right": { label: "Orbit दाएँ", description: "subject के चारों ओर दाएँ बड़ा आंशिक orbit" },
   "spin-360": { label: "Full 360 Spin", description: "Camera अपनी धुरी पर पूरे 360 degree घूमता है" },
   "orbit-360": { label: "Full 360 Orbit", description: "Camera subject के चारों ओर पूरे 360 degree का arc बनाता है" },
   "arc-left": { label: "Arc बाएँ", description: "subject के चारों ओर बाएँ आंशिक arc" },
@@ -88,7 +88,7 @@ const map: LocaleCatalogMap = {
   "handheld-vlog": { label: "Handheld Vlog", description: "Casual vlog-शैली का handheld" },
   "pov-walk": { label: "POV Walk", description: "प्रथम-व्यक्ति चलते हुए POV" },
   "velocity-edit": { label: "Velocity Edit", description: "TikTok speed-ramp pacing" },
-  "match-cut-zoom": { label: "Match Cut Zoom", description: "Cut के लिए beat-समय वाला zoom" },
+  "match-cut-zoom": { label: "Match Cut Zoom", description: "मेल खाती आकृति पर hard cut वाला तेज़ zoom" },
   "screen-tap": { label: "Screen Tap", description: "On-screen finger-tap transition" },
   "phone-flip": { label: "Phone Flip", description: "आगे/पीछे camera flip" },
   // Location-studio extension (PR #2505 follow-up)

package/src/i18n/camera-motions.ja.ts

@@ -27,8 +27,8 @@ const map: LocaleCatalogMap = {
   "dolly-in": { label: "ドリー・イン", description: "被写体に向かってカメラを押し込む（パララックスあり）" },
   "dolly-out": { label: "ドリー・アウト", description: "カメラを引いていく（パララックスあり）" },
   "dolly-zoom": { label: "ドリーズーム", description: "ヴァーティゴ効果：ドリーがズームと逆方向" },
-  "push-in": { label: "プッシュイン", description: "被写体へのゆっくり繊細な押し込み" },
-  "pull-out": { label: "プルアウト", description: "被写体からのゆっくり繊細な引き戻し" },
+  "push-in": { label: "プッシュイン", description: "被写体への速く力強い押し込み" },
+  "pull-out": { label: "プルアウト", description: "被写体からの速く力強い引き戻し" },
   "breathing": { label: "ブリージング・カメラ", description: "繊細で連続的なプッシュインとプルアウトの揺らぎ、有機的な手持ちの感触" },
   "push-pull": { label: "プッシュプル／スウィング", description: "カメラが被写体に近づいてから離れる、振り子のような接近と後退" },
   "creep-in": { label: "クリープイン", description: "ほとんど気づかれないほどゆっくりのプッシュイン、恐怖や緊張を高める" },
@@ -48,8 +48,8 @@ const map: LocaleCatalogMap = {
   "dutch-angle": { label: "ダッチアングル", description: "緊張感を与える固定の傾いたフレーム" },
 
   // Orbit
-  "orbit-left": { label: "オービット・レフト", description: "被写体の周りを左に1周回る" },
-  "orbit-right": { label: "オービット・ライト", description: "被写体の周りを右に1周回る" },
+  "orbit-left": { label: "オービット・レフト", description: "被写体の周りを左に大きく部分的に回る" },
+  "orbit-right": { label: "オービット・ライト", description: "被写体の周りを右に大きく部分的に回る" },
   "spin-360": { label: "フル360°スピン", description: "カメラが軸上で360度フル回転する" },
   "orbit-360": { label: "フル360°オービット", description: "カメラが被写体の周りを360度の完全な弧で回る" },
   "arc-left": { label: "アーク・レフト", description: "被写体の周りを左に部分的に弧を描く" },
@@ -88,7 +88,7 @@ const map: LocaleCatalogMap = {
   "handheld-vlog": { label: "ハンドヘルド・ヴログ", description: "カジュアルなヴログ風の手持ち" },
   "pov-walk": { label: "POVウォーク", description: "一人称の歩行POV" },
   "velocity-edit": { label: "ベロシティエディット", description: "TikTok風のスピードランプ・ペーシング" },
-  "match-cut-zoom": { label: "マッチカット・ズーム", description: "カット用にビートに合わせたズーム" },
+  "match-cut-zoom": { label: "マッチカット・ズーム", description: "同じ形にハードカットする速いズーム" },
   "screen-tap": { label: "スクリーンタップ", description: "画面上の指タップによるトランジション" },
   "phone-flip": { label: "フォンフリップ", description: "前面／背面カメラの切り替え" },
   // Location-studio extension (PR #2505 follow-up)

package/src/i18n/camera-motions.ko.ts

@@ -27,8 +27,8 @@ const map: LocaleCatalogMap = {
   "dolly-in": { label: "달리 인", description: "피사체를 향해 카메라를 밀어 넣습니다 (시차)" },
   "dolly-out": { label: "달리 아웃", description: "카메라를 멀리 밀어냅니다 (시차)" },
   "dolly-zoom": { label: "달리 줌", description: "버티고 효과: 달리와 줌이 반대로 동작합니다" },
-  "push-in": { label: "푸시 인", description: "피사체를 향한 천천히 미묘한 푸시입니다" },
-  "pull-out": { label: "풀 아웃", description: "피사체로부터 천천히 미묘한 풀백입니다" },
+  "push-in": { label: "푸시 인", description: "피사체를 향한 빠르고 힘찬 푸시입니다" },
+  "pull-out": { label: "풀 아웃", description: "피사체로부터 빠르고 힘찬 풀백입니다" },
   "breathing": { label: "브리딩 카메라", description: "은은하게 지속되는 푸시 인 / 풀 아웃의 진동, 유기적인 핸드헬드 느낌입니다" },
   "push-pull": { label: "푸시 풀 / 스윙", description: "카메라가 피사체를 향해 다가갔다가 다시 멀어지는, 흔들리는 접근과 후퇴입니다" },
   "creep-in": { label: "크리프 인", description: "감지하기 어려울 만큼 느린 푸시 인으로 공포감이나 긴장감을 쌓아갑니다" },
@@ -48,8 +48,8 @@ const map: LocaleCatalogMap = {
   "dutch-angle": { label: "더치 앵글", description: "긴장감을 주는 정적 기울어진 프레임입니다" },
 
   // Orbit / Arc
-  "orbit-left": { label: "오비트 왼쪽", description: "피사체 주위를 왼쪽으로 한 바퀴 도는 궤도입니다" },
-  "orbit-right": { label: "오비트 오른쪽", description: "피사체 주위를 오른쪽으로 한 바퀴 도는 궤도입니다" },
+  "orbit-left": { label: "오비트 왼쪽", description: "피사체 주위를 왼쪽으로 크게 부분 선회합니다" },
+  "orbit-right": { label: "오비트 오른쪽", description: "피사체 주위를 오른쪽으로 크게 부분 선회합니다" },
   "spin-360": { label: "풀 360° 스핀", description: "카메라가 자신의 축을 중심으로 360도 완전 회전합니다" },
   "orbit-360": { label: "풀 360° 오비트", description: "카메라가 피사체 주위를 360도 완전한 호로 돕니다" },
   "arc-left": { label: "아크 왼쪽", description: "피사체 주위를 왼쪽으로 부분적으로 도는 호입니다" },
@@ -88,7 +88,7 @@ const map: LocaleCatalogMap = {
   "handheld-vlog": { label: "핸드헬드 블로그", description: "캐주얼한 블로그 스타일 핸드헬드입니다" },
   "pov-walk": { label: "POV 워크", description: "1인칭 보행 POV입니다" },
   "velocity-edit": { label: "벨로시티 에디트", description: "TikTok 스피드 램프 페이싱입니다" },
-  "match-cut-zoom": { label: "매치 컷 줌", description: "컷에 맞춘 비트 타이밍 줌입니다" },
+  "match-cut-zoom": { label: "매치 컷 줌", description: "일치하는 형태로 하드 컷하는 빠른 줌입니다" },
   "screen-tap": { label: "스크린 탭", description: "화면 위 손가락 탭 트랜지션입니다" },
   "phone-flip": { label: "폰 플립", description: "전면/후면 카메라 플립입니다" },
   // Location-studio extension (PR #2505 follow-up)