@nodaro/shared 2.10.0 → 2.11.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nodaro/shared",
-  "version": "2.10.0",
+  "version": "2.11.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__/catalog-projection.test.ts

@@ -0,0 +1,14 @@
+import { describe, it, expectTypeOf } from "vitest"
+import type { ProjectedCatalog } from "../catalog-projection.js"
+
+describe("ProjectedCatalog wire shape (Apache boundary)", () => {
+  it("is tag-free and policy-free (the deferred CatalogPolicy never crosses the wire)", () => {
+    // @ts-expect-error — no `tags` field may exist on the projection shape
+    const _t: ProjectedCatalog["tags"] = undefined
+    // @ts-expect-error — no policy field may exist either
+    const _p: ProjectedCatalog["policy"] = undefined
+    void _t
+    void _p
+    expectTypeOf<ProjectedCatalog>().toHaveProperty("catalogId")
+  })
+})

package/src/__tests__/default-video-provider.test.ts

@@ -23,7 +23,7 @@ describe("DEFAULT_VIDEO_PROVIDER", () => {
   })
 
   it("nothing-specified request resolves to the cheapest seeded composite", () => {
-    const sel = applyDefaultVideoSelection({})
+    const sel = applyDefaultVideoSelection<number>({})
     const id = buildVideoCreditModelIdentifier(
       sel.provider, sel.duration, undefined, "image-to-video", undefined, undefined, false,
     )

package/src/__tests__/pack-sidecar-localization.test.ts

@@ -0,0 +1,21 @@
+import { describe, it, expect, afterEach } from "vitest"
+import { registerCatalogSidecars, resetCatalogSidecars, resolveLabel, entryMatchesQuery } from "../index.js"
+
+afterEach(() => resetCatalogSidecars())
+
+describe("pack sidecars resolve through the shared localizer (G10)", () => {
+  it("resolveLabel returns a pack-registered localized label", () => {
+    // English fallback before registration
+    expect(resolveLabel("person", "attire-x", "Modest Suit", "he")).toBe("Modest Suit")
+    registerCatalogSidecars("person", { he: { "attire-x": { label: "חליפה צנועה" } } })
+    expect(resolveLabel("person", "attire-x", "Modest Suit", "he")).toBe("חליפה צנועה")
+  })
+  it("english locale ignores sidecars", () => {
+    registerCatalogSidecars("person", { he: { "attire-x": { label: "חליפה צנועה" } } })
+    expect(resolveLabel("person", "attire-x", "Modest Suit", "en")).toBe("Modest Suit")
+  })
+  it("search matches the localized pack label", () => {
+    registerCatalogSidecars("person", { he: { "attire-x": { label: "חליפה צנועה" } } })
+    expect(entryMatchesQuery("person", "attire-x", "Modest Suit", "d", "he", "חליפה")).toBe(true)
+  })
+})

package/src/__tests__/parameter-node-value.test.ts

@@ -1,8 +1,9 @@
-import { describe, it, expect } from "vitest"
+import { describe, it, expect, afterEach } from "vitest"
 import {
   PARAMETER_NODE_TYPES,
   getParameterValue,
 } from "../parameter-node-value.js"
+import { setRegisteredPersonPackFields } from "../index.js"
 
 describe("PARAMETER_NODE_TYPES", () => {
   it("includes the existing parameter node types", () => {
@@ -135,3 +136,19 @@ describe("parameter-node-value — furniture", () => {
     expect(getParameterValue({}, "furniture")).toBeUndefined()
   })
 })
+
+describe("getParameterValue person pack-dimension fallback (G4)", () => {
+  afterEach(() => setRegisteredPersonPackFields([]))
+
+  it("returns undefined for an unregistered pack field", () => {
+    expect(getParameterValue({ sectorAttire: "attire-modest-suit" }, "person")).toBeUndefined()
+  })
+  it("resolves a registered pack field when no base dimension is set", () => {
+    setRegisteredPersonPackFields(["sectorAttire"])
+    expect(getParameterValue({ sectorAttire: "attire-modest-suit" }, "person")).toBe("attire-modest-suit")
+  })
+  it("base dimensions still win over pack fields", () => {
+    setRegisteredPersonPackFields(["sectorAttire"])
+    expect(getParameterValue({ type: "man", sectorAttire: "attire-modest-suit" }, "person")).toBe("man")
+  })
+})

package/src/__tests__/resolve-pipeline-model.test.ts

@@ -28,8 +28,8 @@ describe("resolvePipelineModel", () => {
   })
 
   it("returns the global script_llm for the script_llm stage", () => {
-    const config: Partial<PipelineConfig> = { script_llm: "claude-opus-4-6" }
-    expect(resolvePipelineModel(config, "script_llm")).toBe("claude-opus-4-6")
+    const config: Partial<PipelineConfig> = { script_llm: "claude-opus-4-7" }
+    expect(resolvePipelineModel(config, "script_llm")).toBe("claude-opus-4-7")
   })
 
   it("per-stage override beats the matching global field", () => {
@@ -52,12 +52,12 @@ describe("resolvePipelineModel", () => {
       stage_models: {
         scene_keyframes_image: "gpt-image",
         shots_video: "veo3",
-        script_llm: "claude-opus-4-6",
+        script_llm: "claude-opus-4-7",
       },
     }
     expect(resolvePipelineModel(config, "scene_keyframes_image")).toBe("gpt-image")
     expect(resolvePipelineModel(config, "shots_video")).toBe("veo3")
-    expect(resolvePipelineModel(config, "script_llm")).toBe("claude-opus-4-6")
+    expect(resolvePipelineModel(config, "script_llm")).toBe("claude-opus-4-7")
     // Entity image stages keep the global pick.
     expect(resolvePipelineModel(config, "characters_image")).toBe("flux")
   })

package/src/animals.ts

@@ -30,6 +30,16 @@ export interface Animal {
   readonly label: string
   readonly subcategory: AnimalSubcategory
   readonly description: string
+  /**
+   * Optional authored compact term — the short phrase a professional would
+   * write in a prompt, as opposed to the user-facing `label` (see the `term`
+   * convention in `@nodaro/prompts`'s `term.ts`). Authored ONLY where the
+   * lowercased label is not that phrase — a UI compound naming two things at
+   * once ("Airship / Dirigible" -> "airship", "Plasma Sword / Lightsaber" ->
+   * "plasma sword"). Everywhere else the lowercased label IS the term for a
+   * concrete object ("golden retriever", "katana"), so nothing is authored.
+   */
+  readonly term?: string
 }
 
 export const ANIMALS: ReadonlyArray<Animal> = [

package/src/catalog-projection.ts

@@ -0,0 +1,48 @@
+/**
+ * Tag-free, policy-free wire shape for the `GET /v1/catalogs` projection — the
+ * server-driven, pack-composed catalog view thin clients render their own
+ * pickers from. This is the ONLY catalog-related type in `@nodaro/shared`
+ * (Apache): catalog DATA stays in `@nodaro/prompts` (FSL), and the deferred
+ * `CatalogPolicy` (tags / deny-by-tag / per-read-kind filter) is deliberately
+ * NOT represented here — nothing tag- or policy-shaped may cross this boundary.
+ */
+export interface ProjectedCatalogOption {
+  id: string
+  label: string
+  description?: string
+  category?: string
+  /** The prompt fragment this id injects downstream. Present only when detail="full". */
+  promptHint?: string
+  /**
+   * Short professional term injected by compact hint mode; `label` is for
+   * display. Present at BOTH detail levels — a thin client renders `label`
+   * and injects `term`. Empty for a no-op ("auto"/"none") entry that injects
+   * nothing.
+   */
+  term?: string
+  icon?: string
+}
+
+export interface ProjectedCatalogDimension {
+  field: string
+  label: string
+  options: ProjectedCatalogOption[]
+}
+
+export interface ProjectedCatalog {
+  nodeType: string
+  label: string
+  catalogId: string
+  kind: "single" | "multi"
+  /** single only — the node-data field the chosen id writes to. */
+  valueField?: string
+  defaultValue?: string
+  categoryOrder?: readonly string[]
+  categoryLabels?: Readonly<Record<string, string>>
+  detail: "compact" | "full"
+  /** single-dim catalogs. */
+  options?: ProjectedCatalogOption[]
+  /** multi-dim catalogs. */
+  fields?: readonly string[]
+  dimensions?: ProjectedCatalogDimension[]
+}

package/src/entity-node-fields.ts

@@ -0,0 +1,147 @@
+/**
+ * Which DB columns of a saved entity land on its canvas node, per kind.
+ *
+ * Four surfaces copy an entity row onto a node: the browser's load-time
+ * hydrator, the browser's library picker, the backend's run-time hydration, and
+ * (indirectly) anything that reads a node expecting those fields to be there.
+ * They used to be four hand-written lists, and they drifted exactly as you would
+ * expect — the load-time hydrator covers `character` and nothing else, so an
+ * object node bound by an agent stays media-less until someone rebinds it by
+ * hand.
+ *
+ * This is the field NAMES only — the structural vocabulary. Merge behaviour
+ * (defaults, `prev` fallbacks, type narrowing) stays with each caller, because
+ * a browser node and a server row disagree about nulls and it is not worth
+ * pretending otherwise.
+ */
+
+/**
+ * Every entity kind, in the order surfaces present them.
+ *
+ * The list is the invariant: `Record<EntityNodeKind, …>` makes the compiler
+ * find every table below, every per-kind UI row in the `@` picker, and the
+ * picker’s kind→query map. What the compiler cannot see — that the MCP read
+ * tools for a kind exist and are reachable — is pinned by a test instead.
+ *
+ * Tool names are derivable from it too: `list_<kind>s` / `get_<kind>`.
+ */
+export const ENTITY_NODE_KINDS = ["character", "object", "creature", "location"] as const
+
+export type EntityNodeKind = (typeof ENTITY_NODE_KINDS)[number]
+
+/** The `data.*DbId` field that binds each entity node to its row. */
+export const ENTITY_DB_ID_FIELD: Record<EntityNodeKind, string> = {
+  character: "characterDbId",
+  object: "objectDbId",
+  creature: "creatureDbId",
+  location: "locationDbId",
+}
+
+/** The `data.*Name` field each kind stores its display name under. */
+export const ENTITY_NAME_FIELD: Record<EntityNodeKind, string> = {
+  character: "characterName",
+  object: "objectName",
+  creature: "creatureName",
+  location: "locationName",
+}
+
+/** Postgres table per kind. */
+export const ENTITY_TABLE: Record<EntityNodeKind, string> = {
+  character: "characters",
+  object: "objects",
+  creature: "creatures",
+  location: "locations",
+}
+
+/**
+ * `{name,url}[]` buckets per kind, as `[db_column, nodeField]`.
+ *
+ * These are what a generation actually consumes — the variant a prompt
+ * `@mentions`, the extra references a user attaches. A node missing them is not
+ * visibly broken; it just quietly generates the wrong picture.
+ */
+export const ENTITY_BUCKET_FIELDS: Record<EntityNodeKind, ReadonlyArray<readonly [string, string]>> = {
+  character: [
+    ["expressions", "expressions"],
+    ["poses", "poses"],
+    ["motions", "motions"],
+    ["angles", "angles"],
+    ["body_angles", "bodyAngles"],
+    ["lighting_variations", "lightingVariations"],
+    ["outfit_variations", "outfitVariations"],
+    ["detail_closeups", "detailCloseups"],
+    ["sheets", "sheets"],
+  ],
+  object: [
+    ["angles", "angles"],
+    ["materials", "materials"],
+    ["variations", "variations"],
+    ["motion_clips", "motionClips"],
+    ["detail_closeups", "detailCloseups"],
+    ["sheets", "sheets"],
+  ],
+  creature: [
+    ["angles", "angles"],
+    ["poses", "poses"],
+    ["variations", "variations"],
+    ["motion_clips", "motionClips"],
+    ["detail_closeups", "detailCloseups"],
+    ["sheets", "sheets"],
+  ],
+  location: [
+    ["time_of_day", "timeOfDay"],
+    ["weather", "weather"],
+    ["angles", "angles"],
+    ["lighting", "lighting"],
+    ["seasons", "seasons"],
+    ["atmosphere_motions", "atmosphereMotions"],
+    ["detail_closeups", "detailCloseups"],
+    ["sheets", "sheets"],
+  ],
+}
+
+/**
+ * Scalars every kind shares, as `[db_column, nodeField]`.
+ *
+ * `source_image_url` is the load-bearing one: the run engine reads
+ * `defaultAssetUrl || sourceImageUrl` and SKIPS the reference entirely when
+ * both are empty — no error, no warning, just a generation of the wrong
+ * person. A node with an id but no image is the shape an agent produces.
+ */
+export const ENTITY_SCALAR_FIELDS: ReadonlyArray<readonly [string, string]> = [
+  ["name", "__name"], // routed to the kind's own name field by the caller
+  ["description", "description"],
+  ["canonical_description", "canonicalDescription"],
+  ["source_image_url", "sourceImageUrl"],
+]
+
+/**
+ * Scalars only SOME kinds have.
+ *
+ * `style_lock` looks shared and is not: characters never grew the column,
+ * because a character's likeness is the lock. Selecting it from `characters`
+ * anyway is a PostgREST error, which the run-time hydrator swallows by design
+ * — so the whole kind would quietly stop hydrating and every test that mocks
+ * the database would still pass. That is why the column lists are checked
+ * against the migrations by `entity-hydration-columns.test.ts`.
+ */
+export const ENTITY_KIND_SCALAR_FIELDS: Record<EntityNodeKind, ReadonlyArray<readonly [string, string]>> = {
+  character: [],
+  object: [["style_lock", "styleLock"]],
+  creature: [["style_lock", "styleLock"]],
+  location: [["style_lock", "styleLock"]],
+}
+
+/** Every DB column a full hydration of `kind` reads. */
+export function entityHydrationColumns(kind: EntityNodeKind): string[] {
+  return [
+    "id",
+    ...entityScalarFields(kind).map(([column]) => column),
+    ...ENTITY_BUCKET_FIELDS[kind].map(([column]) => column),
+  ]
+}
+
+/** Every scalar `kind` actually has, shared plus its own. */
+export function entityScalarFields(kind: EntityNodeKind): ReadonlyArray<readonly [string, string]> {
+  return [...ENTITY_SCALAR_FIELDS, ...ENTITY_KIND_SCALAR_FIELDS[kind]]
+}

package/src/furniture.ts

@@ -26,6 +26,16 @@ export interface Furniture {
   readonly label: string
   readonly subcategory: FurnitureSubcategory
   readonly description: string
+  /**
+   * Optional authored compact term — the short phrase a professional would
+   * write in a prompt, as opposed to the user-facing `label` (see the `term`
+   * convention in `@nodaro/prompts`'s `term.ts`). Authored ONLY where the
+   * lowercased label is not that phrase — a UI compound naming two things at
+   * once ("Airship / Dirigible" -> "airship", "Plasma Sword / Lightsaber" ->
+   * "plasma sword"). Everywhere else the lowercased label IS the term for a
+   * concrete object ("golden retriever", "katana"), so nothing is authored.
+   */
+  readonly term?: string
 }
 
 export const FURNITURE: ReadonlyArray<Furniture> = [

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: "फ्रेम सफ़ेद होता है, नया दृश्य उभरता है" },