@nodaro/shared 3.21.0 → 3.23.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 +2284 -195
  2. package/dist/index.cjs.map +1 -1
  3. package/dist/index.d.cts +1915 -75
  4. package/dist/index.d.ts +1915 -75
  5. package/dist/index.js +2117 -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 +462 -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 +295 -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 +179 -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,295 @@
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: five ffmpeg-overlapping nodes (merge-video-audio, trim-audio,
20
+ * mix-audio, combine-audio, adjust-volume) are deliberately absent — their
21
+ * ids shipped through a different migration with the single `in` retained,
22
+ * and a second rewrite would silently double-apply.
23
+ */
24
+ import { AUDIO_PRODUCER_TYPES, VIDEO_PRODUCER_TYPES } from "./producer-types.js"
25
+
26
+ /** Legacy SOURCE handle id → canonical id, per node type. */
27
+ export const LEGACY_SOURCE_HANDLE_ALIASES: Readonly<Record<string, Readonly<Record<string, string>>>> = {
28
+ // Batch 1
29
+ "generate-music": { "audio-out": "audio" },
30
+ // Batch 2 — Suno output id normalization
31
+ "suno-add-instrumental": { "audio-out": "audio" },
32
+ "suno-add-vocals": { "audio-out": "audio" },
33
+ "suno-convert-wav": { "audio-out": "audio" },
34
+ "suno-mashup": { "audio-out": "audio" },
35
+ "suno-replace-section": { "audio-out": "audio" },
36
+ "suno-upload-extend": { "audio-out": "audio" },
37
+ "suno-music-video": { "video-out": "video" },
38
+ "suno-style-boost": { "text-out": "text" },
39
+ "suno-separate": { "vocal-out": "vocals", "instrumental-out": "instrumental" },
40
+ // Batch 4 — Processing output id normalization (non-ffmpeg ones only)
41
+ "split-text": { out: "text" },
42
+ // split-media produces dual-typed outputs; map each leg of the legacy
43
+ // `*-out` pair to the new single-word form.
44
+ "split-media": { "audio-out": "audio", "video-out": "video" },
45
+ // Phase 20 — Image-producer output id normalization. Pre-migration these
46
+ // nodes shipped a single generic `out` source handle; after the typed-handle
47
+ // migration their source pip is the canonical type name.
48
+ "edit-image": { out: "image" },
49
+ "modify-image": { out: "image" },
50
+ "image-to-image": { out: "image" },
51
+ "upscale-image": { out: "image" },
52
+ "remove-background": { out: "image" },
53
+ "face-swap": { out: "video" },
54
+ // Phase 21 — Video-producer output id normalization.
55
+ "motion-transfer": { out: "video" },
56
+ // Phase 22 — Upload/source-node output id normalization.
57
+ "reference-audio": { "audio-out": "audio" },
58
+ // Phase 24c — Compositing-stragglers output id normalization.
59
+ "speed-ramp": { "video-out": "video" },
60
+ "fade-video": { "video-out": "video" },
61
+ "transcode-video": { "video-out": "video" },
62
+ "manual-edit": { "video-out": "video" },
63
+ "social-media-format": { "media-out": "media", "text-out": "text" },
64
+ // Telegram Channel Feed: the pip was `out` until it took the platform's
65
+ // text id (`text`), which its definition and docs always named.
66
+ "telegram-channel-feed": { out: "text" },
67
+ // Telegram Trigger: the docs once named six outputs; the component renders
68
+ // one, `out`, and media rides it by kind on both engines.
69
+ "telegram-trigger": { text: "out", imageUrl: "out", videoUrl: "out", audioUrl: "out" },
70
+ }
71
+
72
+ /** Legacy TARGET handle id → canonical id, per node type. */
73
+ export const LEGACY_TARGET_HANDLE_ALIASES: Readonly<Record<string, Readonly<Record<string, string>>>> = {
74
+ // Batch 1
75
+ "text-to-speech": { in: "prompt" },
76
+ "text-to-audio": { in: "prompt" },
77
+ "generate-music": { in: "prompt" },
78
+ "audio-isolation": { in: "audio" },
79
+ "text-to-dialogue": { in: "prompt" },
80
+ "voice-changer": { in: "audio" },
81
+ dubbing: { in: "audio" },
82
+ // voice-remix / voice-design keep the legacy `audio-style` target id intact
83
+ // — that name is hard-coded in the runtime hint composers. Only `in` moves.
84
+ "voice-remix": { in: "audio" },
85
+ "voice-design": { in: "prompt" },
86
+ "forced-alignment": { in: "audio" },
87
+ // Batch 2 — Suno target id normalization
88
+ "suno-generate": { in: "prompt" },
89
+ "suno-lyrics": { in: "prompt" },
90
+ "suno-style-boost": { text: "prompt" },
91
+ // Batch 3 — Script & Text target id normalization
92
+ "generate-script": { in: "prompt" },
93
+ transcribe: { in: "audio" },
94
+ // Batch 4 — Processing target id normalization (non-ffmpeg only)
95
+ "combine-text": { in: "text" },
96
+ "split-text": { in: "text" },
97
+ "split-media": { "video-in": "video", "audio-in": "audio" },
98
+ // Phase 20 — Image-producer target id normalization.
99
+ "face-swap": { in: "video" },
100
+ // Phase 21 — Video-producer target id normalization.
101
+ "video-to-video": { in: "video" },
102
+ "video-upscale": { in: "video" },
103
+ "extend-video": { in: "video" },
104
+ "motion-transfer": { in: "video" },
105
+ "lip-sync": { videoIn: "video" },
106
+ // Phase 24c — Compositing-stragglers target id normalization.
107
+ "after-effects": { in: "video" },
108
+ "motion-graphics": { in: "video" },
109
+ "lottie-overlay": { in: "video" },
110
+ // video-composer renders ONE target pip, `in` ("Media"). An earlier table
111
+ // sent saved edges to a `video` pip the node never had; this heals those.
112
+ "video-composer": { video: "in" },
113
+ "render-video": { in: "composition" },
114
+ "speed-ramp": { in: "video" },
115
+ "fade-video": { in: "video" },
116
+ "transcode-video": { in: "video" },
117
+ // (manual-edit keeps `in` as a multi-asset target.)
118
+ "social-media-format": { "media-in": "media", "text-in": "text" },
119
+ }
120
+
121
+ /**
122
+ * Node types whose handles are created at run time — a column per list field,
123
+ * a lane per Router route, a slot per overlay layer, a sub-workflow's ports —
124
+ * so an edge into them cannot be checked against the declared handle list.
125
+ */
126
+ export const DYNAMIC_HANDLE_NODE_TYPES: ReadonlySet<string> = new Set([
127
+ "list",
128
+ "loop",
129
+ "group",
130
+ "collect",
131
+ "router",
132
+ "component",
133
+ "sub-workflow",
134
+ "sub-workflow-input",
135
+ "sub-workflow-output",
136
+ "selector",
137
+ // Payload parameters become handles.
138
+ "webhook-trigger",
139
+ // One `variant:<id>` handle per layer.
140
+ "image-overlay",
141
+ ])
142
+
143
+ /** The canonical source handle id for a legacy spelling on this node type, or the spelling itself. */
144
+ export function canonicalSourceHandle(nodeType: string | undefined, handle: string): string {
145
+ return (nodeType && LEGACY_SOURCE_HANDLE_ALIASES[nodeType]?.[handle]) || handle
146
+ }
147
+
148
+ /** The canonical target handle id for a legacy spelling on this node type, or the spelling itself. */
149
+ export function canonicalTargetHandle(nodeType: string | undefined, handle: string): string {
150
+ return (nodeType && LEGACY_TARGET_HANDLE_ALIASES[nodeType]?.[handle]) || handle
151
+ }
152
+
153
+ // ---------------------------------------------------------------------------
154
+ // The classifiers that follow the tables — a target handle decided by the
155
+ // SOURCE node's type. The editor applied these on load with five private
156
+ // sets; they live beside the tables so the server's write-time pass
157
+ // (backend/src/lib/workflow-edge-normalization.ts) makes the same decision.
158
+ // ---------------------------------------------------------------------------
159
+
160
+ /** Suno nodes whose typed shape split the legacy `in` into `audio` + `prompt`. */
161
+ const SUNO_IN_CLASSIFIER_TARGETS: ReadonlySet<string> = new Set([
162
+ "suno-cover", "suno-extend", "suno-replace-section", "suno-upload-extend",
163
+ ])
164
+ /** Suno nodes with a typed `voice` target — the resolvers that wire personaId
165
+ * (suno-upload-extend's payload takes none). */
166
+ const SUNO_VOICE_CAPABLE_TARGETS: ReadonlySet<string> = new Set(["suno-generate", "suno-cover", "suno-extend"])
167
+ /** motion-transfer's legacy `in` took an image, a video or a text; the blanket
168
+ * `in → video` rewrite loses the first and the last. The editor's own list,
169
+ * less face-swap: its one output is a video (the source table above says so),
170
+ * and an image lane for it fed the resolver a video as `imageUrl`. */
171
+ const IMAGE_SOURCE_TYPES_FOR_CLASSIFIER: ReadonlySet<string> = new Set([
172
+ "generate-image", "upload-image", "edit-image", "image-to-image",
173
+ "modify-image", "upscale-image", "remove-background", "generate-mask",
174
+ "scene",
175
+ ])
176
+ /** Identity entities route to the `assets` typed handle (mirrors generate-video's). */
177
+ const IDENTITY_TYPES_FOR_CLASSIFIER: ReadonlySet<string> = new Set([
178
+ "character", "face", "object", "creature", "location",
179
+ ])
180
+ /** The video producers — the ONE set the canvas validators and the
181
+ * orchestrator read, so a node is a video source here the day it is added.
182
+ * (A frozen copy of the editor's list missed thirteen of them — youtube-video,
183
+ * face-swap, slideshow, ai-avatar, … — and sent their legacy wires to
184
+ * `prompt` / `audio`.) A dynamic producer (list, sub-workflow, the dual-mode
185
+ * media nodes) is deliberately NOT one: its lane is unknown until run time,
186
+ * and the rules treat it as they always did. */
187
+ const VIDEO_SOURCE_TYPES_FOR_CLASSIFIER: ReadonlySet<string> = VIDEO_PRODUCER_TYPES
188
+ /** The audio producers plus youtube-video (audio-extractable on the backend). */
189
+ const AUDIO_SOURCE_TYPES_FOR_CLASSIFIER: ReadonlySet<string> = new Set([...AUDIO_PRODUCER_TYPES, "youtube-video"])
190
+ /** Dual-mode revoice nodes: `audio` in → audio out, `video` in → video out. Their
191
+ * legacy `in` was both, and the table alone would send a video to `audio`. */
192
+ const DUAL_MODE_REVOICE_TARGETS: ReadonlySet<string> = new Set(["voice-changer", "voice-changer-pro", "dubbing"])
193
+
194
+ /**
195
+ * The target handle an edge lands on AFTER the alias table, decided by the
196
+ * source node's type. `handle` is the id after the table; `sentHandle` the id
197
+ * as written, for the rule that only reinterprets a legacy `in`. Returns the
198
+ * handle unchanged when no rule applies — a no-op for every typed wire.
199
+ */
200
+ export function classifyLegacyTargetHandle(
201
+ targetType: string | undefined,
202
+ handle: string | null | undefined,
203
+ sourceType: string | undefined,
204
+ sentHandle: string | null | undefined = handle,
205
+ ): string | null | undefined {
206
+ if (!targetType) return handle
207
+ const source = sourceType ?? ""
208
+ // suno-voice → a Suno node with a typed voice handle: the persona ref, even
209
+ // when the table already sent its `in` to `prompt`.
210
+ if (
211
+ source === "suno-voice" &&
212
+ SUNO_VOICE_CAPABLE_TARGETS.has(targetType) &&
213
+ (handle === "in" || handle === "prompt" || handle == null)
214
+ ) {
215
+ return "voice"
216
+ }
217
+ // Legacy `in` on the Suno continuation nodes → `audio` for an audio source, else `prompt`.
218
+ if (SUNO_IN_CLASSIFIER_TARGETS.has(targetType) && (handle === "in" || handle == null)) {
219
+ return AUDIO_SOURCE_TYPES_FOR_CLASSIFIER.has(source) ? "audio" : "prompt"
220
+ }
221
+ // motion-transfer's `video` (the table's choice for its legacy `in`) by source.
222
+ if (targetType === "motion-transfer" && handle === "video") {
223
+ if (IDENTITY_TYPES_FOR_CLASSIFIER.has(source)) return "assets"
224
+ if (IMAGE_SOURCE_TYPES_FOR_CLASSIFIER.has(source)) return "image"
225
+ if (!VIDEO_SOURCE_TYPES_FOR_CLASSIFIER.has(source)) return "prompt"
226
+ return handle
227
+ }
228
+ // video-to-video / extend-video: the pre-migration `in` also took a prompt.
229
+ if (
230
+ (targetType === "video-to-video" || targetType === "extend-video") &&
231
+ handle === "video" &&
232
+ !VIDEO_SOURCE_TYPES_FOR_CLASSIFIER.has(source)
233
+ ) {
234
+ return "prompt"
235
+ }
236
+ // A legacy `in` (or no handle) on a dual-mode revoice node: the lane the source is.
237
+ if (DUAL_MODE_REVOICE_TARGETS.has(targetType) && (sentHandle === "in" || sentHandle == null)) {
238
+ return VIDEO_SOURCE_TYPES_FOR_CLASSIFIER.has(source) ? "video" : "audio"
239
+ }
240
+ return handle
241
+ }
242
+
243
+ /**
244
+ * Source pips a component renders that its NODE_DEFINITIONS entry does not
245
+ * declare, or declares under another name — the burn-down list of issue
246
+ * #1877, pinned to the rendered JSX by the frontend guard
247
+ * (node-output-handles-completeness.test.ts). The server treats these as the
248
+ * node's real outputs: an edge on one draws; an edge on the declared-only id
249
+ * does not, so the write-time pass moves it onto the one pip that draws. An
250
+ * entry leaves this table the day its definition is fixed.
251
+ */
252
+ export const RENDERED_OUTPUT_HANDLES: Readonly<Record<string, readonly string[]>> = {
253
+ // The ffmpeg family shipped `video-out` / `audio-out` pips through a
254
+ // different migration (single `in` retained) and was left out of the alias
255
+ // pass on purpose.
256
+ "add-captions": ["video-out"],
257
+ "adjust-volume": ["audio-out", "video-out"],
258
+ "audio-fx": ["audio-out"],
259
+ "combine-audio": ["audio-out"],
260
+ "loop-video": ["video-out"],
261
+ "merge-video-audio": ["video-out"],
262
+ "mix-audio": ["audio-out"],
263
+ "resize-video": ["video-out"],
264
+ "trim-video": ["video-out"],
265
+ // Output nodes: a pass-through `out` pip the definition does not declare.
266
+ "save-to-storage": ["out"],
267
+ "sub-workflow-output": ["out"],
268
+ "webhook-output": ["out"],
269
+ // Stem separator: one declared `audio` output, a pip per stem rendered.
270
+ "audio-separation": ["bass", "drums", "guitar", "instrumental", "other", "piano", "vocals"],
271
+ // Dual-mode revoice: the video pip is rendered but undeclared.
272
+ "voice-changer": ["audio", "video"],
273
+ }
274
+
275
+ /**
276
+ * The pip that draws for a source handle a node DECLARES but does not render
277
+ * (a `RENDERED_OUTPUT_HANDLES` node): `<handle>-out` when that is a rendered
278
+ * pip (the ffmpeg family), else the node's single rendered pip; null when the
279
+ * handle is not such a case, or several pips could be meant (never guessed).
280
+ * `declaredOutputs` is the node's definition list — `NODE_HANDLES[type].outputs`
281
+ * on the server, `NODE_DEF_MAP.get(type).outputs` in the editor. The editor
282
+ * applies it when it LOADS a graph, the server when it WRITES one: the same
283
+ * move, from one place.
284
+ */
285
+ export function renderedSourceHandle(
286
+ nodeType: string | undefined,
287
+ handle: string | null | undefined,
288
+ declaredOutputs: ReadonlyArray<string> | undefined,
289
+ ): string | null {
290
+ if (!nodeType || !handle) return null
291
+ const rendered = RENDERED_OUTPUT_HANDLES[nodeType]
292
+ if (!rendered || rendered.includes(handle) || !declaredOutputs?.includes(handle)) return null
293
+ if (rendered.includes(`${handle}-out`)) return `${handle}-out`
294
+ return rendered.length === 1 ? rendered[0]! : null
295
+ }
@@ -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" },