@praeko/studio-core 0.0.0-stage → 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog
+
+Segue [Keep a Changelog](https://keepachangelog.com/pt-BR/1.1.0/) e [SemVer](https://semver.org/lang/pt-BR/).
+
+## [0.1.0] - 2026-11-07
+
+Primeira versão publicada, extraída do projeto de divulgação onde nasceu. Publica `dist/` compilado (ESM + `.d.ts`); `react` e `remotion` são peers.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Marcone Santos
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/LICENSES.md

@@ -0,0 +1,38 @@
+# Licenças do Praeko Studio / Licenses
+
+Conferido em 07/11/2026 (verified on 2026-11-07). Este arquivo não é aconselhamento jurídico; vale o texto de cada fornecedor.
+
+## O código do Praeko Studio
+Os pacotes `@praeko/studio`, `@praeko/studio-core` e `@praeko/studio-kit` são **MIT** (ver `LICENSE`, Copyright (c) 2026 Marcone Santos), como `@praeko/sdk` e `@praeko/cli`. Os efeitos sonoros (`pop`, `ding`, `thump`, `whoosh`) e o `avatar.png` do modelo de projeto foram criados para o Studio (sons sintetizados por `scripts/gerar-sfx.mjs`, sem amostras de terceiros) e seguem a mesma licença MIT. O pacote não traz fontes, músicas, imagens de banco nem arte de terceiros.
+
+## Aviso que você precisa ver (Remotion NÃO é MIT)
+> **Remotion.** O Remotion é *source-available*, não open source. É **grátis** para pessoas físicas, organizações sem fins lucrativos, avaliação e empresas com **até 3 funcionários** (uso comercial incluído). Empresas com **4 ou mais pessoas** precisam da **Company License** (remotion.pro/license). Quem instala e roda o Remotion é **você**: a licença é sua, não do Praeko. O Remotion também vende planos para quem **automatiza renders por programa ou agente** (Creators, Automators); o FAQ deles não diz expressamente se um agente local que roda `remotion render` entra: **pergunte ao Remotion** antes de usar em escala. O Praeko Studio não copia nem modifica código do Remotion: usa-o como dependência (peer) instalada por você.
+>
+> **Remotion** is source-available, not open source. Free for individuals, non-profits, evaluation and companies of up to 3 employees (commercial use included); companies of 4+ need the Company License (remotion.pro/license). You install and run Remotion, so the license is yours. They also sell plans for programmatic/agent-driven rendering; their FAQ does not say whether a local agent running `remotion render` counts: ask Remotion before using at scale. Praeko Studio does not copy or modify Remotion code; it uses it as a dependency you install.
+
+Este aviso aparece no `README`, na instalação (`praeko studio init`), em `praeko studio doctor` e em `praeko studio licencas` (`--aceitar` registra a leitura em `~/.config/praeko/studio/licencas.json`).
+
+**Capas** são renderizadas com `remotion still`, mesmo com `--motor hyperframes`: hoje não existe projeto 100% livre de Remotion. Uma capa sem Remotion está no roteiro de trabalho (`docs/studio-produto.md`, item 9) e não foi prometida.
+
+**Não prometemos "grátis para sempre":** as condições do Remotion podem mudar (a própria página avisa que a licença muda no Remotion 5.0). Reveja a licença ao subir de versão.
+
+## Dependências de terceiros
+| Componente | Onde | Licença | Fonte |
+|---|---|---|---|
+| `remotion`, `@remotion/cli` (4.0.539) | instalados no **projeto** do usuário (peer de core/kit) | Remotion License (ver acima), não MIT | remotion.pro/license; github.com/remotion-dev/remotion (LICENSE.md) |
+| `react`, `react-dom` (19.2.3) | projeto do usuário (peer) | MIT | package.json de cada pacote |
+| `@praeko/studio-core`, `-kit` | projeto do usuário | MIT | LICENSE |
+| `yaml` (2.9.1) | embutido no bundle de `@praeko/studio` | ISC | package.json |
+| `@elevenlabs/elevenlabs-js` (2.x) | dependência de `@praeko/studio` | MIT | package.json |
+| `hyperframes` (0.9.13, motor opcional) | baixado por `npx` na primeira vez que você usa `--motor hyperframes` | Apache-2.0 | github.com/heygen-com/hyperframes |
+| `typescript`, `esbuild`, `@types/*` | só desenvolvimento/build | Apache-2.0 / MIT | package.json |
+| ffmpeg / ffprobe | você instala | LGPL ou GPL, conforme a compilação | ffmpeg.org/legal.html |
+| Chrome Headless Shell / Chromium | o Remotion baixa no primeiro render | licenças do Chromium/Google | remotion.dev/docs/miscellaneous/chrome-headless-shell |
+
+## Serviços e modelos (você contrata)
+- **ElevenLabs**: seus termos e seu plano (clonagem de voz só com direito sobre a voz). A chave é sua; o Studio nunca a imprime.
+- **VoiceStudio local** (opcional): o modelo OmniVoice é **CC-BY-NC (uso não comercial)**. Não é padrão em nenhuma configuração do Studio e **não deve ser usado em conteúdo monetizado**. Confira a licença de qualquer modelo local que usar.
+- **YouTube, Instagram, TikTok**: termos e regras de conteúdo sintético de cada rede (veja `praeko studio docs publicar`).
+
+## Fontes e mídia
+Nenhuma fonte é distribuída. O modelo de projeto usa fontes do sistema (`Arial Black`, `Menlo`) que o `doctor` confere; troque-as no `marca.json` por fontes abertas (OFL) se quiser que o vídeo saia igual em todos os sistemas. Música, imagens e clipes que você adicionar são responsabilidade sua (direitos e licenças).

package/README.md

@@ -1,3 +1,20 @@
-# Temporary Holding Version
+# @praeko/studio-core
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Motor do Praeko Studio (peças Remotion): episódio por voz e palavras com tempo, legendas palavra a palavra, golpes de edição, fechamento e tema da marca. Biblioteca para projetos criados com [`@praeko/studio`](https://www.npmjs.com/package/@praeko/studio) (`praeko studio init` já instala e configura).
+
+> **Licenças.** Este pacote é MIT e usa o **Remotion** como dependência (peer) que **você** instala. O Remotion **não é MIT**: grátis para pessoas, organizações sem fins lucrativos e empresas de até 3 funcionários; empresas com 4 ou mais pessoas precisam da Company License ([remotion.pro/license](https://www.remotion.pro/license)). Detalhes em [LICENSES.md](./LICENSES.md).
+>
+> **Licenses.** This package is MIT and uses **Remotion** as a peer dependency that **you** install. Remotion is **not MIT**: free for individuals, non-profits and companies of up to 3 employees; companies of 4+ need the Company License.
+
+## Instalar
+```sh
+# npm
+npm install @praeko/studio-core remotion react
+# yarn
+yarn add @praeko/studio-core remotion react
+# pnpm
+pnpm add @praeko/studio-core remotion react
+# bun
+bun add @praeko/studio-core remotion react
+```
+Peers: `remotion` ^4.0.539 (todos os pacotes `@remotion/*` na mesma versão) e `react` ^19. Node 22 ou mais novo. Uso: `praeko studio docs episodio-yaml`.

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./motor";
+export * from "./palavra";
+export * from "./tema";
+export * from "./util";
+export * from "./longo";

package/dist/index.js

@@ -0,0 +1,460 @@
+// src/motor.tsx
+import { AbsoluteFill, Audio, Img, Sequence, interpolate as interpolate2, spring, staticFile, useCurrentFrame, useVideoConfig } from "remotion";
+
+// src/tema.tsx
+import { createContext, useContext } from "react";
+import { jsx } from "react/jsx-runtime";
+var TEMA_PADRAO = {
+  fundo: "#14110f",
+  fundoCapa: "#0e0c14",
+  destaque: "#f4b942",
+  texto: "#f3ece0",
+  suave: "#a89c8a",
+  ok: "#7ee787",
+  erro: "#ff6b5e",
+  info: "#7fd7ff",
+  extra: "#a98bff",
+  caixa: "#2a2118",
+  codigo: "#1b1610",
+  fonte: "'Arial Black', 'Helvetica Neue', system-ui, sans-serif",
+  mono: "Menlo, 'Courier New', monospace",
+  handle: "@seucanal",
+  avatar: "capa/avatar.png"
+};
+var Ctx = createContext(TEMA_PADRAO);
+var TemaProvider = ({ tema, children }) => /* @__PURE__ */ jsx(Ctx.Provider, { value: tema, children });
+var useTema = () => useContext(Ctx);
+var temaDaMarca = (m) => ({
+  ...TEMA_PADRAO,
+  ...m.cores || {},
+  ...m.fontes?.titulo ? { fonte: m.fontes.titulo } : {},
+  ...m.fontes?.mono ? { mono: m.fontes.mono } : {},
+  ...m.handle ? { handle: m.handle } : {},
+  ...m.avatar ? { avatar: m.avatar } : {}
+});
+var rgba = (hex, a) => {
+  const n = parseInt(hex.slice(1), 16);
+  return `rgba(${n >> 16 & 255},${n >> 8 & 255},${n & 255},${a})`;
+};
+
+// src/util.ts
+import { Easing, interpolate } from "remotion";
+var FPS = 30;
+var clamp = { extrapolateLeft: "clamp", extrapolateRight: "clamp" };
+var EO = Easing.bezier(0.16, 1, 0.3, 1);
+var surge = (t, q, d = 0.35) => interpolate(t, [q, q + d], [0, 1], { ...clamp, easing: EO });
+var ramp = (t, a, b) => interpolate(t, [a, b], [0, 1], { ...clamp, easing: Easing.out(Easing.cubic) });
+var pop = (t, q) => interpolate(t, [q, q + 0.18, q + 0.4], [0.6, 1.14, 1], { ...clamp, easing: Easing.out(Easing.cubic) });
+var fmt = (n) => String(Math.round(n)).replace(/\B(?=(\d{3})+(?!\d))/g, ".");
+var norm = (s) => s.toLowerCase().normalize("NFD").replace(/[̀-ͯ]/g, "").replace(/[^a-z0-9]/g, "");
+var mkAt = (P, S) => {
+  const W = P.map((p) => norm(p.t));
+  return (i) => (frase, nth = 0) => {
+    const f2 = frase.split(/\s+/).map(norm).filter(Boolean);
+    let c = 0;
+    for (let k = 0; k <= W.length - f2.length; k++) {
+      if (f2.every((w, j) => W[k + j] === w)) {
+        if (c === nth) return P[k].a - S[i];
+        c++;
+      }
+    }
+    throw new Error("frase n\xE3o achada: " + frase);
+  };
+};
+
+// src/motor.tsx
+import { Fragment, jsx as jsx2, jsxs } from "react/jsx-runtime";
+var f = (s) => Math.round(s * FPS);
+var DUR_SOM = { pop: 0.16, ding: 0.9, thump: 0.4, whoosh: 0.55 };
+var VOL_SOM = { pop: 0.22, ding: 0.26, thump: 0.33, whoosh: 0.28 };
+var Rotulo = ({ texto }) => {
+  const { destaque: LAMP, fundo: BG, texto: INK, fonte: FONT, ok: OK, caixa: CAIXA } = useTema();
+  const frame = useCurrentFrame();
+  const { fps } = useVideoConfig();
+  const pop2 = spring({ frame: frame - 3, fps, config: { damping: 11, stiffness: 200 } });
+  return /* @__PURE__ */ jsx2(
+    "div",
+    {
+      style: {
+        position: "absolute",
+        top: 70,
+        left: 0,
+        right: 0,
+        display: "flex",
+        justifyContent: "center",
+        transform: `scale(${0.6 + 0.4 * pop2}) rotate(${(1 - pop2) * -4}deg)`,
+        opacity: Math.min(1, pop2 * 1.5)
+      },
+      children: /* @__PURE__ */ jsx2(
+        "div",
+        {
+          style: {
+            background: LAMP,
+            color: BG,
+            fontFamily: FONT,
+            fontSize: 62,
+            fontWeight: 900,
+            letterSpacing: 1,
+            padding: "14px 36px",
+            borderRadius: 22,
+            boxShadow: "0 10px 30px rgba(0,0,0,.55)",
+            whiteSpace: "nowrap"
+          },
+          children: texto
+        }
+      )
+    }
+  );
+};
+var Fundo = () => {
+  const { destaque: LAMP, fundo: BG, texto: INK, fonte: FONT, ok: OK, caixa: CAIXA } = useTema();
+  const frame = useCurrentFrame();
+  const pulso = 0.16 + 0.05 * Math.sin(frame / 22);
+  return /* @__PURE__ */ jsx2(
+    AbsoluteFill,
+    {
+      style: {
+        background: `radial-gradient(ellipse at 50% 20%, ${rgba(LAMP, pulso)} 0%, ${rgba(LAMP, 0)} 55%), radial-gradient(ellipse at 50% 100%, rgba(80,60,120,.22) 0%, rgba(0,0,0,0) 60%), ${BG}`
+      },
+      children: Array.from({ length: 26 }).map((_, i) => {
+        const x = i * 137 % 1080;
+        const vel = 0.35 + i % 5 * 0.18;
+        const y = (i * 251 % 1920 - frame * vel + 1920 * 4) % 1920;
+        const r = 3 + i % 4 * 2;
+        return /* @__PURE__ */ jsx2(
+          "div",
+          {
+            style: {
+              position: "absolute",
+              left: x,
+              top: y,
+              width: r,
+              height: r,
+              borderRadius: r,
+              background: LAMP,
+              opacity: 0.1 + i % 4 * 0.05
+            }
+          },
+          i
+        );
+      })
+    }
+  );
+};
+var agrupar = (ps) => {
+  const g = [];
+  let cur = [];
+  const fecha = () => {
+    if (cur.length) g.push({ palavras: cur, a: cur[0].a, b: cur[cur.length - 1].b });
+    cur = [];
+  };
+  ps.forEach((p, i) => {
+    cur.push(p);
+    const gap = i < ps.length - 1 ? ps[i + 1].a - p.b : 1;
+    const letras = cur.reduce((n, x) => n + x.t.length, 0);
+    const prox = ps[i + 1]?.t.length ?? 0;
+    if (/[.,?!:]$/.test(p.t) || cur.length >= 3 || letras + prox > 15 || gap > 0.3) fecha();
+  });
+  fecha();
+  return g;
+};
+var FundoTerminal = ({ linhas }) => {
+  const { destaque: LAMP, ok: OK } = useTema();
+  const frame = useCurrentFrame();
+  const n = Math.max(1, linhas.length);
+  const passo = 64, ciclo = 34 * passo + 0;
+  return /* @__PURE__ */ jsxs(AbsoluteFill, { style: { overflow: "hidden" }, children: [
+    /* @__PURE__ */ jsx2(Fundo, {}),
+    /* @__PURE__ */ jsx2("div", { style: { position: "absolute", inset: 0, opacity: 0.09, filter: "blur(1.2px)" }, children: Array.from({ length: 34 }).map((_, i) => {
+      const y = ((i * passo - frame * 0.8) % ciclo + ciclo) % ciclo - 160;
+      const col = (i + Math.floor(i / n)) % 2;
+      return /* @__PURE__ */ jsx2(
+        "div",
+        {
+          style: {
+            position: "absolute",
+            left: 30 + col * 420,
+            top: y,
+            fontFamily: "Menlo, 'Courier New', monospace",
+            fontSize: 28,
+            color: i % 4 === 0 ? LAMP : OK,
+            whiteSpace: "nowrap"
+          },
+          children: linhas[i % n]
+        },
+        i
+      );
+    }) })
+  ] });
+};
+var LegendaEp = ({ palavras, bottom, px = 90 }) => {
+  const { destaque: LAMP, fundo: BG, texto: INK, fonte: FONT, ok: OK, caixa: CAIXA } = useTema();
+  const frame = useCurrentFrame();
+  const t = frame / FPS;
+  const grupos2 = agrupar(palavras);
+  const idx = grupos2.findIndex((g2, i) => {
+    const prox = grupos2[i + 1]?.a ?? g2.b + 0.4;
+    return t >= g2.a - 0.05 && t < Math.max(g2.b + 0.15, Math.min(prox, g2.b + 0.5));
+  });
+  if (idx < 0) return null;
+  const g = grupos2[idx];
+  const dentro = frame - f(g.a);
+  const entra = interpolate2(dentro, [-2, 4], [0, 1], { extrapolateLeft: "clamp", extrapolateRight: "clamp" });
+  return /* @__PURE__ */ jsx2(
+    "div",
+    {
+      style: {
+        position: "absolute",
+        left: px < 90 ? 70 : 40,
+        right: px < 90 ? 70 : 40,
+        bottom,
+        display: "flex",
+        justifyContent: "center",
+        gap: px < 90 ? 64 : 44,
+        flexWrap: "wrap",
+        opacity: entra,
+        transform: `translateY(${(1 - entra) * 24}px)`
+      },
+      children: g.palavras.map((p, i) => {
+        const ativa = t >= p.a && t < p.b + 0.05;
+        const ja = t >= p.a;
+        return /* @__PURE__ */ jsx2(
+          "span",
+          {
+            style: {
+              fontFamily: FONT,
+              fontWeight: 900,
+              fontSize: px,
+              lineHeight: 1.05,
+              textTransform: "uppercase",
+              color: ativa ? LAMP : ja ? INK : rgba(INK, 0.55),
+              transform: `scale(${ativa ? 1.12 : 1})`,
+              textShadow: "0 6px 0 #000, 0 0 24px rgba(0,0,0,.85), 4px 0 0 #000, -4px 0 0 #000"
+            },
+            children: p.t
+          },
+          i
+        );
+      })
+    }
+  );
+};
+var FechamentoEp = ({ cta }) => {
+  const tema = useTema();
+  const { destaque: LAMP, fundo: BG, texto: INK, fonte: FONT, ok: OK, caixa: CAIXA } = useTema();
+  const frame = useCurrentFrame();
+  const { fps } = useVideoConfig();
+  const logo = spring({ frame, fps, config: { damping: 10, stiffness: 150 } });
+  const nome = spring({ frame: frame - 8, fps, config: { damping: 200 } });
+  const pill = spring({ frame: frame - 20, fps, config: { damping: 12, stiffness: 160 } });
+  return /* @__PURE__ */ jsxs(
+    AbsoluteFill,
+    {
+      style: {
+        background: `radial-gradient(circle at 50% 40%, ${CAIXA} 0%, ${BG} 72%)`,
+        justifyContent: "center",
+        alignItems: "center",
+        fontFamily: FONT,
+        textAlign: "center"
+      },
+      children: [
+        /* @__PURE__ */ jsx2(
+          "div",
+          {
+            style: {
+              width: 420,
+              height: 420,
+              borderRadius: 210,
+              overflow: "hidden",
+              border: `12px solid ${LAMP}`,
+              boxShadow: `0 0 80px ${rgba(LAMP, 0.45)}`,
+              transform: `scale(${0.6 + 0.4 * logo})`,
+              opacity: Math.min(1, logo * 1.5)
+            },
+            children: /* @__PURE__ */ jsx2(Img, { src: staticFile(tema.avatar), style: { width: 420, height: 420, imageRendering: "pixelated" } })
+          }
+        ),
+        /* @__PURE__ */ jsx2(
+          "div",
+          {
+            style: {
+              marginTop: 46,
+              fontSize: 92,
+              fontWeight: 900,
+              color: LAMP,
+              opacity: Math.max(0, nome),
+              transform: `translateY(${(1 - Math.max(0, nome)) * 30}px)`
+            },
+            children: tema.handle
+          }
+        ),
+        /* @__PURE__ */ jsx2(
+          "div",
+          {
+            style: {
+              marginTop: 50,
+              background: LAMP,
+              color: BG,
+              fontSize: cta.length > 18 ? 54 : 64,
+              fontWeight: 900,
+              padding: "20px 44px",
+              borderRadius: 28,
+              opacity: Math.max(0, pill),
+              transform: `scale(${0.6 + 0.4 * Math.max(0, pill)})`
+            },
+            children: cta
+          }
+        )
+      ]
+    }
+  );
+};
+var Barra = ({ durS }) => {
+  const { destaque: LAMP, fundo: BG, texto: INK, fonte: FONT, ok: OK, caixa: CAIXA } = useTema();
+  const frame = useCurrentFrame();
+  const w = Math.min(100, frame / f(durS) * 100);
+  return /* @__PURE__ */ jsx2("div", { style: { position: "absolute", top: 0, left: 0, right: 0, height: 10, background: "rgba(0,0,0,.4)" }, children: /* @__PURE__ */ jsx2("div", { style: { width: `${w}%`, height: "100%", background: LAMP } }) });
+};
+var Golpes = ({ golpes, children }) => {
+  const t = useCurrentFrame() / FPS;
+  let sx = 0, sy = 0, zoom = 1, flash = 0;
+  for (const g of golpes) {
+    const dt = t - g.at;
+    if (dt < 0 || dt > 0.45) continue;
+    const k = (1 - dt / 0.45) ** 2;
+    if (g.tipo === "shake" || g.tipo === "tudo") {
+      sx += Math.sin(dt * 95) * 16 * k;
+      sy += Math.cos(dt * 120) * 9 * k;
+    }
+    if (g.tipo === "zoom" || g.tipo === "tudo") zoom = Math.max(zoom, 1 + 0.055 * k);
+    if (g.tipo === "flash" || g.tipo === "tudo") flash = Math.max(flash, 0.33 * k);
+  }
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsx2(AbsoluteFill, { style: { transform: `translate(${sx}px, ${sy}px) scale(${zoom})` }, children }),
+    flash > 0.01 ? /* @__PURE__ */ jsx2(AbsoluteFill, { style: { background: `rgba(255,244,214,${flash})`, pointerEvents: "none" } }) : null
+  ] });
+};
+var Episodio = ({ d }) => {
+  const { fundo: BG } = useTema();
+  return /* @__PURE__ */ jsxs(AbsoluteFill, { style: { backgroundColor: BG }, children: [
+    /* @__PURE__ */ jsx2(Audio, { src: staticFile(d.voz) }),
+    /* @__PURE__ */ jsxs(Golpes, { golpes: d.golpes ?? [], children: [
+      /* @__PURE__ */ jsx2(FundoTerminal, { linhas: d.fundoLinhas ?? ["\u2713 ok"] }),
+      /* @__PURE__ */ jsx2(Sequence, { from: 0, durationInFrames: f(DUR_SOM.whoosh) + 2, children: /* @__PURE__ */ jsx2(Audio, { src: staticFile("sfx/whoosh.wav"), volume: VOL_SOM.whoosh }) }),
+      d.cenas.flatMap((c, i) => {
+        const sons = [{ at: 0, f: "pop" }, ...c.sons ?? []];
+        return sons.map((s, k) => /* @__PURE__ */ jsx2(Sequence, { from: f(c.a + s.at), durationInFrames: f(DUR_SOM[s.f]) + 2, children: /* @__PURE__ */ jsx2(Audio, { src: staticFile(`sfx/${s.f}.wav`), volume: s.v ?? VOL_SOM[s.f] }) }, `s${i}-${k}`));
+      }),
+      d.cenas.map((c, i) => /* @__PURE__ */ jsx2(Sequence, { from: f(c.a), durationInFrames: f(c.b - c.a), premountFor: 10, children: /* @__PURE__ */ jsx2(c.C, { dur: c.b - c.a }) }, "c" + i)),
+      d.cenas.map(
+        (c, i) => c.rotulo ? /* @__PURE__ */ jsx2(Sequence, { from: f(c.a), durationInFrames: f(c.b - c.a), children: /* @__PURE__ */ jsx2(Rotulo, { texto: c.rotulo }) }, "r" + i) : null
+      )
+    ] }),
+    /* @__PURE__ */ jsx2(Sequence, { from: f(d.fechamento.a), durationInFrames: f(d.durS - d.fechamento.a), children: /* @__PURE__ */ jsx2(FechamentoEp, { cta: d.fechamento.cta }) }),
+    /* @__PURE__ */ jsx2(Sequence, { from: 0, durationInFrames: f(d.durS), children: /* @__PURE__ */ jsx2(LegendaEp, { palavras: d.palavras, bottom: 190, px: d.legendaPx }) }),
+    /* @__PURE__ */ jsx2(Sequence, { from: f(d.fechamento.a), durationInFrames: 2, children: /* @__PURE__ */ jsx2(Audio, { src: staticFile("sfx/ding.wav"), volume: 0.22 }) }),
+    /* @__PURE__ */ jsx2(Barra, { durS: d.durS })
+  ] });
+};
+
+// src/longo.tsx
+import { AbsoluteFill as AbsoluteFill2, Audio as Audio2, Img as Img2, interpolate as interpolate3, spring as spring2, staticFile as staticFile2, useCurrentFrame as useCurrentFrame2, useVideoConfig as useVideoConfig2 } from "remotion";
+import { jsx as jsx3, jsxs as jsxs2 } from "react/jsx-runtime";
+var clamp2 = { extrapolateLeft: "clamp", extrapolateRight: "clamp" };
+var janela = (t, a, b, d = 0.4) => interpolate3(t, [a, a + d, b - d, b], [0, 1, 1, 0], clamp2);
+var mkAtG = (P) => {
+  const W = P.map((p) => norm(p.t));
+  return (frase, nth = 0, from = 0) => {
+    const f2 = frase.split(/\s+/).map(norm).filter(Boolean);
+    let c = 0;
+    for (let i = 0; i <= W.length - f2.length; i++) {
+      if (P[i].a < from) continue;
+      if (f2.every((w, k) => W[i + k] === w)) {
+        if (c === nth) return P[i].a;
+        c++;
+      }
+    }
+    throw new Error("frase n\xE3o achada: " + frase);
+  };
+};
+var Cena = ({ t, a, b, n, titulo, children }) => {
+  const T = useTema();
+  if (t < a - 0.1 || t > b + 0.1) return null;
+  return /* @__PURE__ */ jsxs2(AbsoluteFill2, { style: { opacity: janela(t, a, b) }, children: [
+    /* @__PURE__ */ jsxs2("div", { style: { position: "absolute", left: 100, top: 46, display: "flex", alignItems: "center", gap: 18, fontFamily: T.fonte, fontSize: 30, letterSpacing: 4, color: T.destaque, whiteSpace: "nowrap" }, children: [
+      /* @__PURE__ */ jsx3("span", { style: { background: T.destaque, color: T.fundo, borderRadius: 12, padding: "4px 16px" }, children: n }),
+      titulo
+    ] }),
+    children
+  ] });
+};
+var grupos = (P) => {
+  const g = [];
+  let cur = [];
+  P.forEach((p) => {
+    cur.push(p);
+    if (/[.!?:]$/.test(p.t) || cur.length >= 8 || /[,;]$/.test(p.t) && cur.length >= 5) {
+      g.push(cur);
+      cur = [];
+    }
+  });
+  if (cur.length) g.push(cur);
+  return g;
+};
+var Legenda = ({ t, G }) => {
+  const T = useTema();
+  let grupo = null;
+  for (const g of G) if (t >= g[0].a - 0.05 && t <= g[g.length - 1].b + 0.4) grupo = g;
+  if (!grupo) return null;
+  return /* @__PURE__ */ jsx3("div", { style: { position: "absolute", left: 160, right: 160, bottom: 56, textAlign: "center", fontFamily: T.fonte, fontSize: 46, lineHeight: 1.2, textShadow: "0 3px 12px rgba(0,0,0,.9)" }, children: grupo.map((p, i) => /* @__PURE__ */ jsxs2("span", { style: { color: t >= p.a && t < p.b + 0.05 ? T.destaque : T.texto }, children: [
+    p.t,
+    i < grupo.length - 1 ? " " : ""
+  ] }, i)) });
+};
+var FechoTela = ({ f: f2, t }) => {
+  const T = useTema();
+  const { fps } = useVideoConfig2();
+  const k = (atraso) => spring2({ frame: (t - f2.a - atraso) * fps, fps, config: { damping: 14, stiffness: 140 } });
+  const op = interpolate3(t, [f2.a, f2.a + 0.5], [0, 1], clamp2);
+  return /* @__PURE__ */ jsxs2(AbsoluteFill2, { style: { opacity: op, background: `radial-gradient(circle at 50% 40%, ${T.caixa} 0%, ${T.fundo} 75%)`, alignItems: "center", justifyContent: "center", fontFamily: T.fonte, textAlign: "center", paddingBottom: 90 }, children: [
+    /* @__PURE__ */ jsx3("div", { style: { width: 230, height: 230, borderRadius: 44, overflow: "hidden", border: `8px solid ${f2.imagem ? "#3a3566" : T.destaque}`, background: f2.imagem ? "#1c1a33" : void 0, boxShadow: `0 0 70px ${rgba(T.destaque, 0.3)}`, transform: `scale(${0.6 + 0.4 * k(0)})`, opacity: Math.min(1, k(0) * 1.5) }, children: /* @__PURE__ */ jsx3(Img2, { src: staticFile2(f2.imagem ?? T.avatar), style: { width: 230, height: 230, imageRendering: "pixelated", objectFit: "contain" } }) }),
+    f2.texto ? /* @__PURE__ */ jsx3("div", { style: { marginTop: 44, fontSize: 104, fontWeight: 900, color: T.destaque, opacity: Math.max(0, k(0.15)), transform: `translateY(${(1 - Math.max(0, k(0.15))) * 24}px)` }, children: f2.texto }) : null,
+    /* @__PURE__ */ jsx3("div", { style: { marginTop: 28, fontSize: 54, fontWeight: 900, color: T.texto, opacity: Math.max(0, k(0.3)) }, children: T.handle }),
+    f2.link ? /* @__PURE__ */ jsx3("div", { style: { marginTop: 18, fontSize: 38, fontFamily: T.mono, color: T.suave, opacity: Math.max(0, k(0.45)) }, children: f2.link }) : null
+  ] });
+};
+var Longo = ({ d }) => {
+  const T = useTema();
+  const t = useCurrentFrame2() / FPS;
+  const G = grupos(d.palavras);
+  return /* @__PURE__ */ jsxs2(AbsoluteFill2, { style: { background: T.fundo, color: T.texto, fontFamily: T.fonte }, children: [
+    /* @__PURE__ */ jsx3(AbsoluteFill2, { style: { background: `radial-gradient(1200px 700px at 70% 20%, ${rgba(T.destaque, 0.07)}, transparent 70%)` } }),
+    /* @__PURE__ */ jsx3(Audio2, { src: staticFile2(d.voz) }),
+    d.cenas.map((c) => /* @__PURE__ */ jsx3(Cena, { t, a: c.a, b: c.b, n: c.n, titulo: c.titulo, children: /* @__PURE__ */ jsx3(c.C, { t }) }, c.n)),
+    d.fecho && t >= d.fecho.a ? /* @__PURE__ */ jsx3(FechoTela, { f: d.fecho, t }) : null,
+    /* @__PURE__ */ jsx3(Legenda, { t, G }),
+    /* @__PURE__ */ jsx3("div", { style: { position: "absolute", left: 0, top: 0, height: 8, width: `${t / d.durS * 100}%`, background: T.destaque } })
+  ] });
+};
+export {
+  Episodio,
+  FPS,
+  Fundo,
+  Longo,
+  Rotulo,
+  TEMA_PADRAO,
+  TemaProvider,
+  agrupar,
+  clamp,
+  fmt,
+  janela,
+  mkAt,
+  mkAtG,
+  norm,
+  pop,
+  ramp,
+  rgba,
+  surge,
+  temaDaMarca,
+  useTema
+};

package/dist/longo.d.ts

@@ -0,0 +1,39 @@
+import { Palavra } from "./palavra";
+/**
+ * MOTOR DE LONGO (16:9, vários minutos). Um longo é uma lista de cenas em tempo GLOBAL: cada cena recebe `t` (s desde o início do vídeo)
+ * e se liga à voz com `mkAtG(PALAVRAS)(frase, nth, from)`. O motor cuida do fundo, da voz, do cabeçalho da cena (número + título),
+ * da legenda por grupos e da barra de progresso. As cenas são TSX do projeto, montadas com as peças de `@praeko/studio-kit/longo`.
+ */
+export type CenaLongo = {
+    n: string;
+    titulo: string;
+    a: number;
+    b: number;
+    C: React.FC<{
+        t: number;
+    }>;
+};
+/** Tela final opcional: avatar, texto (ex.: a assinatura), handle da marca e link. Entra em `a` (s) e fica até o fim. */
+export type FechoLongo = {
+    a: number;
+    texto?: string;
+    link?: string;
+    imagem?: string;
+};
+export type LongoData = {
+    id: string;
+    durS: number;
+    voz: string;
+    palavras: Palavra[];
+    cenas: CenaLongo[];
+    largura?: number;
+    altura?: number;
+    fecho?: FechoLongo;
+};
+/** Entra e sai com fade de `d` s nas pontas da janela [a, b]. */
+export declare const janela: (t: number, a: number, b: number, d?: number) => number;
+/** Âncora global: `at("frase", nth, from)` = instante (s) em que a frase começa; `from` ignora ocorrências antes de `from` s. Falha alto se não achar. */
+export declare const mkAtG: (P: Palavra[]) => (frase: string, nth?: number, from?: number) => number;
+export declare const Longo: React.FC<{
+    d: LongoData;
+}>;

package/dist/motor.d.ts

@@ -0,0 +1,56 @@
+import { Palavra } from "./palavra";
+/**
+ * NÚCLEO DO PRAEKO STUDIO.
+ * Um episódio é só dados (EpData): voz, palavras com tempo, cenas (cartão + rótulo + sons) e fechamento.
+ * O resto (fundo, legenda, barra de progresso, fechamento, efeitos) é compartilhado e usa o tema da marca.
+ */
+export type Som = {
+    at: number;
+    f: "pop" | "ding" | "thump" | "whoosh";
+    v?: number;
+};
+export type Golpe = {
+    at: number;
+    tipo: "shake" | "zoom" | "flash" | "tudo";
+};
+export type EpCena = {
+    a: number;
+    b: number;
+    C: React.FC<{
+        dur: number;
+    }>;
+    rotulo?: string;
+    /** sons relativos ao início da cena (s) */
+    sons?: Som[];
+};
+export type EpData = {
+    id: string;
+    durS: number;
+    voz: string;
+    palavras: Palavra[];
+    cenas: EpCena[];
+    fechamento: {
+        a: number;
+        cta: string;
+    };
+    /** linhas de "terminal" desfocadas no fundo */
+    fundoLinhas?: string[];
+    /** tamanho da legenda (padrão 90) */
+    legendaPx?: number;
+    /** golpes de edição: tremor, clarão e zoom rápidos em instantes (s) da narração */
+    golpes?: Golpe[];
+};
+export declare const Rotulo: React.FC<{
+    texto: string;
+}>;
+/** Fundo limpo: escuro, brilho âmbar que pulsa e pontinhos que sobem devagar. */
+export declare const Fundo: React.FC;
+export type Grupo = {
+    palavras: Palavra[];
+    a: number;
+    b: number;
+};
+export declare const agrupar: (ps: Palavra[]) => Grupo[];
+export declare const Episodio: React.FC<{
+    d: EpData;
+}>;

package/dist/palavra.d.ts

@@ -0,0 +1,5 @@
+export type Palavra = {
+    t: string;
+    a: number;
+    b: number;
+};

package/dist/tema.d.ts

@@ -0,0 +1,37 @@
+/** Tokens de marca. Tudo que é cor, fonte, nome e avatar vem daqui; o motor e o kit não conhecem nenhuma marca. */
+export type Tema = {
+    fundo: string;
+    fundoCapa: string;
+    destaque: string;
+    texto: string;
+    suave: string;
+    ok: string;
+    erro: string;
+    info: string;
+    extra: string;
+    caixa: string;
+    caixaLongo?: string;
+    codigo: string;
+    fonte: string;
+    mono: string;
+    handle: string;
+    avatar: string;
+};
+export declare const TEMA_PADRAO: Tema;
+export declare const TemaProvider: React.FC<{
+    tema: Tema;
+    children: React.ReactNode;
+}>;
+export declare const useTema: () => Tema;
+/** Lê o `marca.json` de um projeto (campos que faltarem usam o tema padrão). */
+export declare const temaDaMarca: (m: {
+    cores?: Partial<Tema>;
+    fontes?: {
+        titulo?: string;
+        mono?: string;
+    };
+    handle?: string;
+    avatar?: string;
+}) => Tema;
+/** "#f4b942" + 0.16 → "rgba(244,185,66,0.16)". */
+export declare const rgba: (hex: string, a: number) => string;

package/dist/util.d.ts

@@ -0,0 +1,17 @@
+import { Palavra } from "./palavra";
+export declare const FPS = 30;
+export declare const clamp: {
+    readonly extrapolateLeft: "clamp";
+    readonly extrapolateRight: "clamp";
+};
+/** 0 → 1 a partir do instante `q` (s), com saída suave. */
+export declare const surge: (t: number, q: number, d?: number) => number;
+export declare const ramp: (t: number, a: number, b: number) => number;
+export declare const pop: (t: number, q: number) => number;
+export declare const fmt: (n: number) => string;
+export declare const norm: (s: string) => string;
+/**
+ * Âncoras por frase: `mkAt(palavras, inicios)(i)(frase, n)` devolve o instante LOCAL (s, desde o início da cena i) em que
+ * a frase começa na voz. Falha alto se a frase não existe (o Scribe às vezes escreve número em dígitos).
+ */
+export declare const mkAt: (P: Palavra[], S: number[]) => (i: number) => (frase: string, nth?: number) => number;

package/package.json

@@ -1,6 +1,62 @@
 {
   "name": "@praeko/studio-core",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Motor do Praeko Studio: episódio por voz e palavras com tempo, legendas palavra a palavra, golpes de edição, fechamento e tema da marca (peças Remotion). Biblioteca para projetos criados com `praeko studio init`.",
+  "license": "MIT",
+  "keywords": [
+    "praeko",
+    "video",
+    "shorts",
+    "remotion",
+    "captions",
+    "engine"
+  ],
+  "homepage": "https://praeko.app/docs",
+  "bugs": {
+    "url": "https://praeko.app/docs"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Praeko/praeko-js.git",
+    "directory": "studio/packages/core"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE",
+    "LICENSES.md"
+  ],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "node ../../../scripts/build-studio.mjs core",
+    "prepack": "npm run build",
+    "typecheck": "tsc --noEmit -p tsconfig.json"
+  },
+  "peerDependencies": {
+    "react": "^19.0.0",
+    "remotion": "^4.0.539"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "devDependencies": {
+    "@types/react": "19.2.7",
+    "react": "19.2.3",
+    "react-dom": "19.2.3",
+    "remotion": "4.0.539"
+  }
+}