@nodaro/shared 3.21.0 → 3.24.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (84) hide show
  1. package/dist/index.cjs +2291 -195
  2. package/dist/index.cjs.map +1 -1
  3. package/dist/index.d.cts +1929 -75
  4. package/dist/index.d.ts +1929 -75
  5. package/dist/index.js +2123 -196
  6. package/dist/index.js.map +1 -1
  7. package/package.json +1 -1
  8. package/src/__tests__/add-captions-plan.test.ts +33 -0
  9. package/src/__tests__/caption-plan-parse.test.ts +23 -0
  10. package/src/__tests__/caption-segment-schema.test.ts +30 -0
  11. package/src/__tests__/collections.test.ts +253 -0
  12. package/src/__tests__/dialogue-capabilities.test.ts +157 -0
  13. package/src/__tests__/edit-plan-review.test.ts +70 -0
  14. package/src/__tests__/edl-clocks.test.ts +97 -0
  15. package/src/__tests__/edl.test.ts +34 -0
  16. package/src/__tests__/execution-outcome.test.ts +44 -0
  17. package/src/__tests__/fan-out-meta.test.ts +23 -0
  18. package/src/__tests__/fan-out-rows.test.ts +36 -0
  19. package/src/__tests__/fan-out-url-item.test.ts +44 -0
  20. package/src/__tests__/fixtures/speaker-tracks.fixtures.json +622 -0
  21. package/src/__tests__/input-field-extra-keys.test.ts +34 -0
  22. package/src/__tests__/list-consumers-fan-in.test.ts +40 -0
  23. package/src/__tests__/model-tree.test.ts +7 -0
  24. package/src/__tests__/node-pass-through.test.ts +23 -0
  25. package/src/__tests__/node-runtime-keys.test.ts +1 -0
  26. package/src/__tests__/picker-restrictions.test.ts +36 -0
  27. package/src/__tests__/preview-gate.test.ts +305 -0
  28. package/src/__tests__/render-basis.test.ts +176 -0
  29. package/src/__tests__/render-nodes.test.ts +73 -0
  30. package/src/__tests__/render-output.test.ts +392 -0
  31. package/src/__tests__/run-continuation.test.ts +32 -0
  32. package/src/__tests__/speaker-tracks.test.ts +474 -0
  33. package/src/__tests__/speech-pricing.test.ts +69 -0
  34. package/src/__tests__/telegram-channel.test.ts +91 -0
  35. package/src/__tests__/tts-capabilities.test.ts +81 -4
  36. package/src/__tests__/tts-neighbour-text.test.ts +19 -0
  37. package/src/__tests__/ugc-call-body.test.ts +38 -0
  38. package/src/__tests__/ugc-run-state.test.ts +68 -0
  39. package/src/__tests__/video-character-refs.test.ts +213 -0
  40. package/src/__tests__/video-overlay-layer-plan.test.ts +94 -0
  41. package/src/add-captions-plan.ts +50 -0
  42. package/src/caption-plan.ts +45 -0
  43. package/src/caption-segment-schema.ts +82 -0
  44. package/src/collections.ts +482 -0
  45. package/src/competitors.ts +77 -0
  46. package/src/credit-estimators/index.ts +9 -0
  47. package/src/credit-estimators/speech.ts +51 -0
  48. package/src/dialogue-capabilities.ts +48 -0
  49. package/src/edit-plan-contract.ts +20 -9
  50. package/src/edit-plan-review.ts +40 -1
  51. package/src/edl.ts +27 -1
  52. package/src/execution-outcome.ts +41 -0
  53. package/src/fan-out-meta.ts +23 -0
  54. package/src/fan-out-rows.ts +74 -5
  55. package/src/gemini-omni-voices.ts +59 -0
  56. package/src/handle-aliases.ts +298 -0
  57. package/src/i18n/camera-motions.pt-BR.ts +14 -14
  58. package/src/i18n/transitions.pt-BR.ts +13 -13
  59. package/src/index.ts +180 -1
  60. package/src/model-catalog.ts +122 -13
  61. package/src/model-constants.ts +24 -4
  62. package/src/model-tree.ts +5 -1
  63. package/src/node-execution-state.ts +13 -0
  64. package/src/node-mappable-fields.ts +7 -1
  65. package/src/node-pass-through.ts +37 -0
  66. package/src/node-runtime-keys.ts +14 -0
  67. package/src/picker-restrictions.ts +49 -0
  68. package/src/presentation-types.ts +26 -2
  69. package/src/presentation-utils.ts +25 -7
  70. package/src/preview-gate.ts +279 -0
  71. package/src/producer-types.ts +58 -0
  72. package/src/render-final.ts +20 -0
  73. package/src/render-nodes.ts +92 -0
  74. package/src/render-output.ts +565 -0
  75. package/src/run-continuation.ts +39 -0
  76. package/src/speaker-tracks.ts +638 -0
  77. package/src/telegram-channel.ts +140 -0
  78. package/src/transcribe-preflight.ts +8 -4
  79. package/src/tts-capabilities.ts +19 -5
  80. package/src/tts-neighbour-text.ts +46 -0
  81. package/src/ugc-call-body.ts +86 -0
  82. package/src/ugc-run-state.ts +64 -0
  83. package/src/video-character-refs.ts +233 -0
  84. package/src/video-overlay.ts +78 -21
@@ -0,0 +1,298 @@
1
+ /**
2
+ * Legacy handle ids and the canonical id each one means today.
3
+ *
4
+ * A node's handle ids are declared ONCE, in the editor's `NODE_DEFINITIONS`
5
+ * (`frontend/src/types/nodes.ts`), which generates the MCP handle map, the
6
+ * node skills and the public tool docs. Saved workflows, though, still carry
7
+ * the ids a node rendered before a rename, and an MCP client may send a name
8
+ * it read in an older doc. These tables map those spellings to the current
9
+ * ids, keyed by node TYPE, so every reader rewires an edge the same way:
10
+ *
11
+ * - the editor, when it loads a workflow (`use-workflow-store.ts`);
12
+ * - the server, when an MCP client writes one (`workflow-edge-normalization.ts`),
13
+ * and the Workflow Copilot's own edge check.
14
+ *
15
+ * Structural vocabulary only — no behaviour, no prompt content. A guard test
16
+ * in the frontend fails when an alias points at a handle the node no longer
17
+ * declares, or when a "legacy" spelling is still a declared handle.
18
+ *
19
+ * NOTE: the ffmpeg-overlapping nodes (merge-video-audio, mix-audio,
20
+ * combine-audio, adjust-volume, trim-video, …) keep their live `in` target and
21
+ * their `video-out` / `audio-out` pips from the #2809 migration (trim-audio
22
+ * keeps its `in` and renders `audio`): never alias those AWAY, or a second
23
+ * rewrite would move a live edge onto a pip the node does not render. The
24
+ * entries below go the other way (#1877): the id their definitions used to
25
+ * declare (`video` / `audio`) onto the pip that draws.
26
+ */
27
+ import { AUDIO_PRODUCER_TYPES, VIDEO_PRODUCER_TYPES } from "./producer-types.js"
28
+
29
+ /** Legacy SOURCE handle id → canonical id, per node type. */
30
+ export const LEGACY_SOURCE_HANDLE_ALIASES: Readonly<Record<string, Readonly<Record<string, string>>>> = {
31
+ // Batch 1
32
+ "generate-music": { "audio-out": "audio" },
33
+ // Batch 2 — Suno output id normalization
34
+ "suno-add-instrumental": { "audio-out": "audio" },
35
+ "suno-add-vocals": { "audio-out": "audio" },
36
+ "suno-convert-wav": { "audio-out": "audio" },
37
+ "suno-mashup": { "audio-out": "audio" },
38
+ "suno-replace-section": { "audio-out": "audio" },
39
+ "suno-upload-extend": { "audio-out": "audio" },
40
+ "suno-music-video": { "video-out": "video" },
41
+ "suno-style-boost": { "text-out": "text" },
42
+ "suno-separate": { "vocal-out": "vocals", "instrumental-out": "instrumental" },
43
+ // Batch 4 — Processing output id normalization (non-ffmpeg ones only)
44
+ "split-text": { out: "text" },
45
+ // split-media produces dual-typed outputs; map each leg of the legacy
46
+ // `*-out` pair to the new single-word form.
47
+ "split-media": { "audio-out": "audio", "video-out": "video" },
48
+ // Phase 20 — Image-producer output id normalization. Pre-migration these
49
+ // nodes shipped a single generic `out` source handle; after the typed-handle
50
+ // migration their source pip is the canonical type name.
51
+ "edit-image": { out: "image" },
52
+ "modify-image": { out: "image" },
53
+ "image-to-image": { out: "image" },
54
+ "upscale-image": { out: "image" },
55
+ "remove-background": { out: "image" },
56
+ "face-swap": { out: "video" },
57
+ // Phase 21 — Video-producer output id normalization.
58
+ "motion-transfer": { out: "video" },
59
+ // Phase 22 — Upload/source-node output id normalization.
60
+ "reference-audio": { "audio-out": "audio" },
61
+ // Phase 24c — Compositing-stragglers output id normalization.
62
+ "speed-ramp": { "video-out": "video" },
63
+ "fade-video": { "video-out": "video" },
64
+ "transcode-video": { "video-out": "video" },
65
+ "manual-edit": { "video-out": "video" },
66
+ "social-media-format": { "media-out": "media", "text-out": "text" },
67
+ // Telegram Channel Feed: the pip was `out` until it took the platform's
68
+ // text id (`text`), which its definition and docs always named.
69
+ "telegram-channel-feed": { out: "text" },
70
+ // Telegram Trigger: the docs once named six outputs; the component renders
71
+ // one, `out`, and media rides it by kind on both engines.
72
+ "telegram-trigger": { text: "out", imageUrl: "out", videoUrl: "out", audioUrl: "out" },
73
+ // #1877 — the definitions now declare the pips these components render. The
74
+ // id they used to declare (what MCP clients and the docs were told) moves
75
+ // onto the pip that draws, so an edge written with it still connects.
76
+ "add-captions": { video: "video-out" },
77
+ "adjust-volume": { audio: "audio-out" },
78
+ "audio-fx": { audio: "audio-out" },
79
+ "combine-audio": { audio: "audio-out" },
80
+ "loop-video": { video: "video-out" },
81
+ "merge-video-audio": { video: "video-out" },
82
+ "mix-audio": { audio: "audio-out" },
83
+ "resize-video": { video: "video-out" },
84
+ "trim-video": { video: "video-out" },
85
+ "save-to-storage": { asset: "out" },
86
+ // (audio-separation's old `audio` is NOT aliased: it could mean any of the
87
+ // seven stems, and a stem is never guessed.)
88
+ }
89
+
90
+ /** Legacy TARGET handle id → canonical id, per node type. */
91
+ export const LEGACY_TARGET_HANDLE_ALIASES: Readonly<Record<string, Readonly<Record<string, string>>>> = {
92
+ // Batch 1
93
+ "text-to-speech": { in: "prompt" },
94
+ "text-to-audio": { in: "prompt" },
95
+ "generate-music": { in: "prompt" },
96
+ "audio-isolation": { in: "audio" },
97
+ "text-to-dialogue": { in: "prompt" },
98
+ "voice-changer": { in: "audio" },
99
+ dubbing: { in: "audio" },
100
+ // voice-remix / voice-design keep the legacy `audio-style` target id intact
101
+ // — that name is hard-coded in the runtime hint composers. Only `in` moves.
102
+ "voice-remix": { in: "audio" },
103
+ "voice-design": { in: "prompt" },
104
+ "forced-alignment": { in: "audio" },
105
+ // Batch 2 — Suno target id normalization
106
+ "suno-generate": { in: "prompt" },
107
+ "suno-lyrics": { in: "prompt" },
108
+ "suno-style-boost": { text: "prompt" },
109
+ // Batch 3 — Script & Text target id normalization
110
+ "generate-script": { in: "prompt" },
111
+ transcribe: { in: "audio" },
112
+ // Batch 4 — Processing target id normalization (non-ffmpeg only)
113
+ "combine-text": { in: "text" },
114
+ "split-text": { in: "text" },
115
+ "split-media": { "video-in": "video", "audio-in": "audio" },
116
+ // Phase 20 — Image-producer target id normalization.
117
+ "face-swap": { in: "video" },
118
+ // Phase 21 — Video-producer target id normalization.
119
+ "video-to-video": { in: "video" },
120
+ "video-upscale": { in: "video" },
121
+ "extend-video": { in: "video" },
122
+ "motion-transfer": { in: "video" },
123
+ "lip-sync": { videoIn: "video" },
124
+ // Phase 24c — Compositing-stragglers target id normalization.
125
+ "after-effects": { in: "video" },
126
+ "motion-graphics": { in: "video" },
127
+ "lottie-overlay": { in: "video" },
128
+ // video-composer renders ONE target pip, `in` ("Media"). An earlier table
129
+ // sent saved edges to a `video` pip the node never had; this heals those.
130
+ "video-composer": { video: "in" },
131
+ "render-video": { in: "composition" },
132
+ "speed-ramp": { in: "video" },
133
+ "fade-video": { in: "video" },
134
+ "transcode-video": { in: "video" },
135
+ // (manual-edit keeps `in` as a multi-asset target.)
136
+ "social-media-format": { "media-in": "media", "text-in": "text" },
137
+ }
138
+
139
+ /**
140
+ * Node types whose handles are created at run time — a column per list field,
141
+ * a lane per Router route, a slot per overlay layer, a sub-workflow's ports —
142
+ * so an edge into them cannot be checked against the declared handle list.
143
+ */
144
+ export const DYNAMIC_HANDLE_NODE_TYPES: ReadonlySet<string> = new Set([
145
+ "list",
146
+ "loop",
147
+ "group",
148
+ "collect",
149
+ "router",
150
+ "component",
151
+ "sub-workflow",
152
+ "sub-workflow-input",
153
+ "sub-workflow-output",
154
+ "selector",
155
+ // Payload parameters become handles.
156
+ "webhook-trigger",
157
+ // One `variant:<id>` handle per layer.
158
+ "image-overlay",
159
+ ])
160
+
161
+ /** The canonical source handle id for a legacy spelling on this node type, or the spelling itself. */
162
+ export function canonicalSourceHandle(nodeType: string | undefined, handle: string): string {
163
+ return (nodeType && LEGACY_SOURCE_HANDLE_ALIASES[nodeType]?.[handle]) || handle
164
+ }
165
+
166
+ /** The canonical target handle id for a legacy spelling on this node type, or the spelling itself. */
167
+ export function canonicalTargetHandle(nodeType: string | undefined, handle: string): string {
168
+ return (nodeType && LEGACY_TARGET_HANDLE_ALIASES[nodeType]?.[handle]) || handle
169
+ }
170
+
171
+ // ---------------------------------------------------------------------------
172
+ // The classifiers that follow the tables — a target handle decided by the
173
+ // SOURCE node's type. The editor applied these on load with five private
174
+ // sets; they live beside the tables so the server's write-time pass
175
+ // (backend/src/lib/workflow-edge-normalization.ts) makes the same decision.
176
+ // ---------------------------------------------------------------------------
177
+
178
+ /** Suno nodes whose typed shape split the legacy `in` into `audio` + `prompt`. */
179
+ const SUNO_IN_CLASSIFIER_TARGETS: ReadonlySet<string> = new Set([
180
+ "suno-cover", "suno-extend", "suno-replace-section", "suno-upload-extend",
181
+ ])
182
+ /** Suno nodes with a typed `voice` target — the resolvers that wire personaId
183
+ * (suno-upload-extend's payload takes none). */
184
+ const SUNO_VOICE_CAPABLE_TARGETS: ReadonlySet<string> = new Set(["suno-generate", "suno-cover", "suno-extend"])
185
+ /** motion-transfer's legacy `in` took an image, a video or a text; the blanket
186
+ * `in → video` rewrite loses the first and the last. The editor's own list,
187
+ * less face-swap: its one output is a video (the source table above says so),
188
+ * and an image lane for it fed the resolver a video as `imageUrl`. */
189
+ const IMAGE_SOURCE_TYPES_FOR_CLASSIFIER: ReadonlySet<string> = new Set([
190
+ "generate-image", "upload-image", "edit-image", "image-to-image",
191
+ "modify-image", "upscale-image", "remove-background", "generate-mask",
192
+ "scene",
193
+ ])
194
+ /** Identity entities route to the `assets` typed handle (mirrors generate-video's). */
195
+ const IDENTITY_TYPES_FOR_CLASSIFIER: ReadonlySet<string> = new Set([
196
+ "character", "face", "object", "creature", "location",
197
+ ])
198
+ /** The video producers — the ONE set the canvas validators and the
199
+ * orchestrator read, so a node is a video source here the day it is added.
200
+ * (A frozen copy of the editor's list missed thirteen of them — youtube-video,
201
+ * face-swap, slideshow, ai-avatar, … — and sent their legacy wires to
202
+ * `prompt` / `audio`.) A dynamic producer (list, sub-workflow, the dual-mode
203
+ * media nodes) is deliberately NOT one: its lane is unknown until run time,
204
+ * and the rules treat it as they always did. */
205
+ const VIDEO_SOURCE_TYPES_FOR_CLASSIFIER: ReadonlySet<string> = VIDEO_PRODUCER_TYPES
206
+ /** The audio producers plus youtube-video (audio-extractable on the backend). */
207
+ const AUDIO_SOURCE_TYPES_FOR_CLASSIFIER: ReadonlySet<string> = new Set([...AUDIO_PRODUCER_TYPES, "youtube-video"])
208
+ /** Dual-mode revoice nodes: `audio` in → audio out, `video` in → video out. Their
209
+ * legacy `in` was both, and the table alone would send a video to `audio`. */
210
+ const DUAL_MODE_REVOICE_TARGETS: ReadonlySet<string> = new Set(["voice-changer", "voice-changer-pro", "dubbing"])
211
+
212
+ /**
213
+ * The target handle an edge lands on AFTER the alias table, decided by the
214
+ * source node's type. `handle` is the id after the table; `sentHandle` the id
215
+ * as written, for the rule that only reinterprets a legacy `in`. Returns the
216
+ * handle unchanged when no rule applies — a no-op for every typed wire.
217
+ */
218
+ export function classifyLegacyTargetHandle(
219
+ targetType: string | undefined,
220
+ handle: string | null | undefined,
221
+ sourceType: string | undefined,
222
+ sentHandle: string | null | undefined = handle,
223
+ ): string | null | undefined {
224
+ if (!targetType) return handle
225
+ const source = sourceType ?? ""
226
+ // suno-voice → a Suno node with a typed voice handle: the persona ref, even
227
+ // when the table already sent its `in` to `prompt`.
228
+ if (
229
+ source === "suno-voice" &&
230
+ SUNO_VOICE_CAPABLE_TARGETS.has(targetType) &&
231
+ (handle === "in" || handle === "prompt" || handle == null)
232
+ ) {
233
+ return "voice"
234
+ }
235
+ // Legacy `in` on the Suno continuation nodes → `audio` for an audio source, else `prompt`.
236
+ if (SUNO_IN_CLASSIFIER_TARGETS.has(targetType) && (handle === "in" || handle == null)) {
237
+ return AUDIO_SOURCE_TYPES_FOR_CLASSIFIER.has(source) ? "audio" : "prompt"
238
+ }
239
+ // motion-transfer's `video` (the table's choice for its legacy `in`) by source.
240
+ if (targetType === "motion-transfer" && handle === "video") {
241
+ if (IDENTITY_TYPES_FOR_CLASSIFIER.has(source)) return "assets"
242
+ if (IMAGE_SOURCE_TYPES_FOR_CLASSIFIER.has(source)) return "image"
243
+ if (!VIDEO_SOURCE_TYPES_FOR_CLASSIFIER.has(source)) return "prompt"
244
+ return handle
245
+ }
246
+ // video-to-video / extend-video: the pre-migration `in` also took a prompt.
247
+ if (
248
+ (targetType === "video-to-video" || targetType === "extend-video") &&
249
+ handle === "video" &&
250
+ !VIDEO_SOURCE_TYPES_FOR_CLASSIFIER.has(source)
251
+ ) {
252
+ return "prompt"
253
+ }
254
+ // A legacy `in` (or no handle) on a dual-mode revoice node: the lane the source is.
255
+ if (DUAL_MODE_REVOICE_TARGETS.has(targetType) && (sentHandle === "in" || sentHandle == null)) {
256
+ return VIDEO_SOURCE_TYPES_FOR_CLASSIFIER.has(source) ? "video" : "audio"
257
+ }
258
+ return handle
259
+ }
260
+
261
+ /**
262
+ * Source pips a component renders that its NODE_DEFINITIONS entry does not
263
+ * declare, or declares under another name — the burn-down list of issue
264
+ * #1877, pinned to the rendered JSX by the frontend guard
265
+ * (node-output-handles-completeness.test.ts). The server treats these as the
266
+ * node's real outputs: an edge on one draws; an edge on the declared-only id
267
+ * does not, so the write-time pass moves it onto the one pip that draws. An
268
+ * entry leaves this table the day its definition is fixed.
269
+ *
270
+ * EMPTY since #1877 was burned down: every definition declares the pips its
271
+ * component renders, and the ids they used to declare are source aliases
272
+ * above. The table and `renderedSourceHandle` stay so a drift that is found
273
+ * later can be recorded here instead of shipping an invisible edge; the guard
274
+ * test fails until it is.
275
+ */
276
+ export const RENDERED_OUTPUT_HANDLES: Readonly<Record<string, readonly string[]>> = {}
277
+
278
+ /**
279
+ * The pip that draws for a source handle a node DECLARES but does not render
280
+ * (a `RENDERED_OUTPUT_HANDLES` node): `<handle>-out` when that is a rendered
281
+ * pip (the ffmpeg family), else the node's single rendered pip; null when the
282
+ * handle is not such a case, or several pips could be meant (never guessed).
283
+ * `declaredOutputs` is the node's definition list — `NODE_HANDLES[type].outputs`
284
+ * on the server, `NODE_DEF_MAP.get(type).outputs` in the editor. The editor
285
+ * applies it when it LOADS a graph, the server when it WRITES one: the same
286
+ * move, from one place.
287
+ */
288
+ export function renderedSourceHandle(
289
+ nodeType: string | undefined,
290
+ handle: string | null | undefined,
291
+ declaredOutputs: ReadonlyArray<string> | undefined,
292
+ ): string | null {
293
+ if (!nodeType || !handle) return null
294
+ const rendered = RENDERED_OUTPUT_HANDLES[nodeType]
295
+ if (!rendered || rendered.includes(handle) || !declaredOutputs?.includes(handle)) return null
296
+ if (rendered.includes(`${handle}-out`)) return `${handle}-out`
297
+ return rendered.length === 1 ? rendered[0]! : null
298
+ }
@@ -5,7 +5,7 @@ const map: LocaleCatalogMap = {
5
5
  "auto": { label: "Automático", description: "Deixe o modelo escolher o movimento de câmera apropriado" },
6
6
  "static": { label: "Estática", description: "Câmera fixa, sem movimento" },
7
7
  "handheld": { label: "Câmera na mão", description: "Tremor natural de câmera na mão" },
8
- "steadicam": { description: "Caminhada estabilizada e suave" },
8
+ "steadicam": { label: "Steadicam", description: "Caminhada estabilizada e suave" },
9
9
 
10
10
  // Pan
11
11
  "pan-left": { label: "Pan para a esquerda", description: "Gire a câmera horizontalmente para a esquerda" },
@@ -18,15 +18,15 @@ const map: LocaleCatalogMap = {
18
18
  "tilt-down": { label: "Tilt para baixo", description: "Incline a câmera para baixo" },
19
19
 
20
20
  // Zoom
21
- "zoom-in": { description: "Zoom de lente em direção ao sujeito" },
22
- "zoom-out": { description: "Zoom de lente afastando do sujeito" },
23
- "crash-zoom-in": { description: "Zoom in rápido e brusco, como um whip pan" },
24
- "crash-zoom-out": { description: "Zoom out rápido e brusco, como um whip pan" },
21
+ "zoom-in": { label: "Zoom de aproximação", description: "Zoom de lente em direção ao sujeito" },
22
+ "zoom-out": { label: "Zoom de afastamento", description: "Zoom de lente afastando do sujeito" },
23
+ "crash-zoom-in": { label: "Zoom brusco de aproximação", description: "Zoom in rápido e brusco, como um whip pan" },
24
+ "crash-zoom-out": { label: "Zoom brusco de afastamento", description: "Zoom out rápido e brusco, como um whip pan" },
25
25
 
26
26
  // Dolly
27
- "dolly-in": { description: "Empurra a câmera em direção ao sujeito (com paralaxe)" },
28
- "dolly-out": { description: "Afasta a câmera (com paralaxe)" },
29
- "dolly-zoom": { description: "Efeito vertigo: dolly oposto ao zoom" },
27
+ "dolly-in": { label: "Travelling de aproximação", description: "Empurra a câmera em direção ao sujeito (com paralaxe)" },
28
+ "dolly-out": { label: "Travelling de afastamento", description: "Afasta a câmera (com paralaxe)" },
29
+ "dolly-zoom": { label: "Efeito vertigo", description: "Efeito vertigo: dolly oposto ao zoom" },
30
30
  "push-in": { label: "Aproximação rápida", description: "Aproximação rápida e enérgica em direção ao sujeito" },
31
31
  "pull-out": { label: "Afastamento rápido", description: "Afastamento rápido e enérgico do sujeito" },
32
32
  "breathing": { label: "Câmera que respira", description: "Oscilação contínua e sutil de aproximação e afastamento" },
@@ -72,23 +72,23 @@ const map: LocaleCatalogMap = {
72
72
  "serpentine": { label: "Trajetória serpenteante", description: "A câmera serpenteia entre obstáculos em curvas em S, avançando por um caminho sinuoso" },
73
73
 
74
74
  // Special angles / rigs
75
- "pov": { description: "Ponto de vista em primeira pessoa" },
75
+ "pov": { label: "Câmera subjetiva", description: "Ponto de vista em primeira pessoa" },
76
76
  "over-the-shoulder": { label: "Por cima do ombro", description: "Enquadrar por cima do ombro de um personagem" },
77
77
  "birds-eye": { label: "Plano zenital", description: "Visão direta de cima para baixo" },
78
78
  "worms-eye": { label: "Contra-plongée extremo", description: "Ângulo extremamente baixo olhando para cima" },
79
79
  "aerial": { label: "Aérea", description: "Tomada aérea estilo drone em grande altitude" },
80
80
  "helicopter": { label: "Helicóptero", description: "Aérea ampla e panorâmica em grande altitude" },
81
81
  "fly-over": { label: "Sobrevoo", description: "Passagem aérea baixa e veloz sobre a cena" },
82
- "flythrough": { description: "Câmera atravessa o espaço voando" },
82
+ "flythrough": { label: "Atravessar voando", description: "Câmera atravessa o espaço voando" },
83
83
  "reveal": { label: "Revelação", description: "Revelar gradualmente a cena mais ampla" },
84
- "snorricam": { description: "Câmera presa ao corpo (sujeito travado no quadro)" },
85
- "rack-focus": { description: "Mudança de foco entre primeiro plano e fundo" },
84
+ "snorricam": { label: "Snorricam", description: "Câmera presa ao corpo (sujeito travado no quadro)" },
85
+ "rack-focus": { label: "Mudança de foco", description: "Mudança de foco entre primeiro plano e fundo" },
86
86
 
87
87
  // Modern / social-video
88
88
  "handheld-vlog": { label: "Vlog com câmera na mão", description: "Câmera na mão estilo vlog descontraído" },
89
89
  "pov-walk": { label: "Caminhada em POV", description: "POV de caminhada em primeira pessoa" },
90
- "velocity-edit": { description: "Ritmo com speed ramp estilo TikTok" },
91
- "match-cut-zoom": { description: "Zoom rápido com corte seco para uma forma correspondente" },
90
+ "velocity-edit": { label: "Rampa de velocidade", description: "Ritmo com speed ramp estilo TikTok" },
91
+ "match-cut-zoom": { label: "Zoom com corte de raccord", description: "Zoom rápido com corte seco para uma forma correspondente" },
92
92
  "screen-tap": { label: "Toque na tela", description: "Transição com toque na tela" },
93
93
  "phone-flip": { label: "Troca de câmera", description: "Troca entre câmera frontal e traseira" },
94
94
  // Location-studio extension (PR #2505 follow-up)
@@ -2,7 +2,7 @@ import type { LocaleCatalogMap } from "./types.js"
2
2
 
3
3
  const map: LocaleCatalogMap = {
4
4
  // ── Standard ──
5
- "auto": { label: "Auto", description: "Deixar o modelo escolher" },
5
+ "auto": { label: "Automático", description: "Deixar o modelo escolher" },
6
6
  "none": { label: "Corte seco", description: "Troca instantânea, sem transição" },
7
7
  "cross-dissolve": { label: "Dissolução cruzada", description: "Mistura gradual entre cenas" },
8
8
  "fade-to-black": { label: "Fade para preto", description: "Escurece ao preto, segunda cena emerge" },
@@ -15,11 +15,11 @@ const map: LocaleCatalogMap = {
15
15
  "roll-transition": { label: "Giro", description: "Quadro gira 90–180° e a segunda cena termina endireitada" },
16
16
  "seamless-match": { label: "Corte invisível", description: "Corte oculto disfarçado por movimento e cor" },
17
17
  "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" },
18
- "jump-cut": { label: "Jump cut", description: "Mesmo enquadramento, o tempo salta adiante" },
18
+ "jump-cut": { label: "Corte descontínuo", description: "Mesmo enquadramento, o tempo salta adiante" },
19
19
 
20
20
  // ── Time ──
21
- "fast-forward-day-night": { label: "Dia → noite (time-lapse)", description: "Time-lapse do dia para a noite na mesma cena" },
22
- "fast-forward-night-day": { label: "Noite → dia (time-lapse)", description: "Time-lapse da noite para o amanhecer" },
21
+ "fast-forward-day-night": { label: "Dia → noite (acelerado)", description: "Tempo acelerado do dia para a noite na mesma cena" },
22
+ "fast-forward-night-day": { label: "Noite → dia (acelerado)", description: "Tempo acelerado da noite para o amanhecer na mesma cena" },
23
23
  "seasonal-shift": { label: "Mudança de estação", description: "Mesma cena pelas quatro estações" },
24
24
  "aging": { label: "Envelhecimento", description: "O sujeito envelhece visivelmente" },
25
25
  "rewind": { label: "Rebobinar", description: "Tempo reverte, movimento ao contrário" },
@@ -44,25 +44,25 @@ const map: LocaleCatalogMap = {
44
44
  "powder-burst": { label: "Explosão de pó colorido", description: "Pó colorido explode e se dissipa, nova cena emerge" },
45
45
 
46
46
  // ── Morph ──
47
- "liquid-morph": { label: "Morphing líquido", description: "Sujeito derrete e se recompõe como um novo sujeito" },
47
+ "liquid-morph": { label: "Metamorfose líquida", description: "Sujeito derrete e se recompõe como um novo sujeito" },
48
48
  "pixelate-reform": { label: "Pixelizar e recompor", description: "Pixeliza, se dispersa e se recompõe como novo" },
49
49
  "shatter-glass": { label: "Estilhaçar e recompor", description: "Sujeito se estilhaça como vidro e se recompõe" },
50
50
  "origami-fold": { label: "Dobra de origami", description: "Sujeito se dobra como papel e vira um novo sujeito" },
51
51
  "vortex-swirl": { label: "Redemoinho em vórtice", description: "Sujeito gira num vórtice e se desenrola como um novo sujeito" },
52
52
  "dream-ripple": { label: "Ondulação de sonho", description: "Onda na superfície revela nova cena" },
53
- "wireframe-morph": { label: "Morphing em wireframe", description: "Sujeito vira wireframe e se recompõe como um novo sujeito" },
53
+ "wireframe-morph": { label: "Metamorfose em wireframe", description: "Sujeito vira wireframe e se recompõe como um novo sujeito" },
54
54
  "polygon-shatter": { label: "Fragmentação poligonal", description: "Sujeito se fragmenta em polígonos e se remonta" },
55
55
  "melt-down": { label: "Derretimento", description: "Sujeito derrete em poça, surge como novo" },
56
56
 
57
57
  // ── Portal ──
58
- "zoom-into-eye": { label: "Zoom no olho", description: "Câmera entra na pupila, novo mundo lá dentro" },
59
- "zoom-into-mirror": { label: "Zoom no espelho", description: "Câmera entra no espelho, cena dentro do reflexo" },
60
- "zoom-into-screen": { label: "Zoom na tela", description: "Câmera entra na tela de TV/celular" },
61
- "zoom-into-book": { label: "Zoom no livro", description: "Câmera entra na ilustração da página do livro" },
58
+ "zoom-into-eye": { label: "Entrar no olho", description: "Câmera entra na pupila, novo mundo lá dentro" },
59
+ "zoom-into-mirror": { label: "Entrar no espelho", description: "Câmera entra no espelho, cena dentro do reflexo" },
60
+ "zoom-into-screen": { label: "Entrar na tela", description: "Câmera entra na tela de TV/celular" },
61
+ "zoom-into-book": { label: "Entrar no livro", description: "Câmera entra na ilustração da página do livro" },
62
62
  "walk-through-door": { label: "Atravessar a porta", description: "Pela porta para nova cena" },
63
63
  "fall-into-hole": { label: "Queda no buraco", description: "Câmera cai pela abertura" },
64
64
  "pull-out-reveal": { label: "Recuo revelador", description: "Revela que a cena era uma imagem em contexto maior" },
65
- "zoom-into-mouth": { label: "Zoom na boca", description: "Câmera entra na boca aberta e surge num novo mundo lá dentro" },
65
+ "zoom-into-mouth": { label: "Entrar na boca", description: "Câmera entra na boca aberta e surge num novo mundo lá dentro" },
66
66
  "push-through-glass": { label: "Atravessar o vidro", description: "Câmera atravessa vidro com refração para nova cena" },
67
67
  "soul-jump": { label: "Salto de alma", description: "Alma translúcida sai do corpo, entra em novo corpo" },
68
68
  "mask-transition": { label: "Transição de máscara", description: "Objeto em primeiro plano cobre o quadro, câmera atravessa o escuro" },
@@ -81,10 +81,10 @@ const map: LocaleCatalogMap = {
81
81
  "action-relay": { label: "Corte na ação", description: "Sujeito sai de quadro numa ação e continua o movimento na nova cena" },
82
82
 
83
83
  // ── Light ──
84
- "white-flash": { label: "Flash branco", description: "Quadro clareia ao branco" },
84
+ "white-flash": { label: "Clarão branco", description: "Quadro clareia ao branco" },
85
85
  "lens-flare-swipe": { label: "Varredura de lens flare", description: "Flare anamórfico varre o quadro" },
86
86
  "light-streak": { label: "Rastro de luz", description: "Rastro de luz varre o quadro" },
87
- "color-invert": { label: "Flash de inversão", description: "Cores invertem brevemente" },
87
+ "color-invert": { label: "Lampejo de inversão", description: "Cores invertem brevemente" },
88
88
  "sun-glare": { label: "Clarão solar", description: "Clarão solar lava o quadro" },
89
89
  "lens-crack": { label: "Rachadura na lente", description: "Lente racha, cena vista pelo vidro fraturado" },
90
90
  "dirty-lens-wipe": { label: "Limpeza de lente suja", description: "Sujeira da lente é limpa, cena muda" },