kasaframe 0.0.0-stage → 0.1.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 2rami
+
+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/NOTICE

@@ -0,0 +1,148 @@
+kasaframe — 빌려 온 코드의 출처와 라이선스
+
+packages/motion/src/transitions2d/ 는 geono-hub(src/transitions, 커밋 a884b15)가 각 출처의 원본에서 옮긴
+판을 그대로 들였다. 받은 원본의 커밋·경로는 geono-hub vendor/transitions/README.md 에 있다. 폴더마다 원본
+LICENSE 를 함께 둔다. React Bits·Animate UI(MIT + Commons Clause)와 Aceternity UI(원본 재배포 금지)는 들이지 않는다.
+
+----------------------------------------------------------------------
+gl-transitions — packages/motion/src/transitions2d/gl-transitions/
+https://github.com/gl-transitions/gl-transitions (커밋 902218a1)
+MIT — Copyright (c) 2017-present gl-transitions contributors (LICENSE 원문은 그 폴더)
+셰이더마다 머리에 저작자·라이선스가 있다. 둘은 BSD 다 — 아래 원문을 지킨다.
+getFromColor·getToColor 를 감싸는 머리(packages/motion/src/transition3d/gl.ts)는 gl-transition(MIT, gre)의 래퍼와 같은 꼴이다.
+
+InvertedPageCurl — BSD 3 Clause
+  Copyright (c) 2010 Hewlett-Packard Development Company, L.P. All rights reserved.
+  Adapted by Sergey Kosarevsky.
+
+  Redistribution and use in source and binary forms, with or without
+  modification, are permitted provided that the following conditions are
+  met:
+
+     * Redistributions of source code must retain the above copyright
+       notice, this list of conditions and the following disclaimer.
+     * Redistributions in binary form must reproduce the above
+       copyright notice, this list of conditions and the following disclaimer
+       in the documentation and/or other materials provided with the
+       distribution.
+     * Neither the name of Hewlett-Packard nor the names of its
+       contributors may be used to endorse or promote products derived from
+       this software without specific prior written permission.
+
+  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+  "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+  LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+  A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+  OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+  SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+  LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+  DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+  THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+  (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+  OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+StereoViewer — BSD 2 Clause
+  Copyright (c) 2016, Theodore K Schundler
+  All rights reserved.
+
+  Redistribution and use in source and binary forms, with or without modification,
+  are permitted provided that the following conditions are met:
+
+  1. Redistributions of source code must retain the above copyright notice, this
+     list of conditions and the following disclaimer.
+
+  2. Redistributions in binary form must reproduce the above copyright notice,
+     this list of conditions and the following disclaimer in the documentation
+     and/or other materials provided with the distribution.
+
+  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+  ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+  WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+  DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
+  ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+  (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+  LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+  ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+  (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+  SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+----------------------------------------------------------------------
+MIT 웹 부품 — 원본 LICENSE 는 각 폴더
+
+SmoothUI      https://github.com/educlopez/smoothui      Copyright (c) 2024 Eduardo Calvo     smoothui/
+Magic UI      https://github.com/magicuidesign/magicui   Copyright (c) Magic UI               magicui/
+Cult UI       https://github.com/nolly-studio/cult-ui    Copyright (c) 2023 Jordan-Gilliam    cult-ui/
+KokonutUI     https://github.com/kokonut-labs/kokonutui  Copyright (c) 2025 kokonutUI         kokonutui/
+unlumen UI    https://github.com/leovvx/unlumen-ui-docs  Copyright (c) 2026 Léo Wicki         unlumen/
+Vengeance UI  https://github.com/Ashutoshx7/VengeanceUI  Copyright (c) 2025-2026 Ashutoshx7   vengeance-ui/
+
+SmoothUI 셰이더 덮개(smooth:reveal-*·smooth:sdf-*)의 조각 셰이더는 원본 그대로이고, 진행 박자만 영상용으로 바꿨다
+(packages/motion/src/transition3d/gl.ts).
+
+----------------------------------------------------------------------
+Skiper UI 무료판 — skiper-ui/
+https://skiper-ui.com — 무료판은 출처 표기가 조건이다.
+Clip Div 는 Skiper UI skiper66(https://skiper-ui.com/v1/skiper66)을 옮긴 판이다. 원작자 표기는 파일 머리에 있다.
+
+----------------------------------------------------------------------
+vocaloid-style-mv-pipeline — tools/blender/kfb.py
+https://github.com/EGSECDA/vocaloid-style-mv-pipeline (로컬 클론 커밋 13b380d)
+MIT — Copyright (c) 2026 NikusonP
+툰 재질(Diffuse → Shader to RGB → 계단 ColorRamp → 방출, 해 세기 π 기준·각도 0), 카메라 광선만 하늘색을 보는 하늘,
+Grease Pencil Line Art 설정, sRGB→선형 변환은 그 레포 template/tools/blender_common.py 와 template/blender/shots/_shared.py
+를 줄여 옮겼다. tools/blender/ 는 bpy 를 써서 GPL-3.0-or-later 로 따로 둔다(그 폴더 README.md·LICENSE) — MIT 코드를
+GPL 파일에 들이는 것은 허용되고, 아래 MIT 고지를 지킨다.
+
+  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.
+
+----------------------------------------------------------------------
+JIZURA 字面 — packages/jizura/vendor/jizura_engine.js (실려 있다)
+https://github.com/852wa/JIZURA (고정 커밋 fc16bfe43ea4a6c25a21f1caf04d17326de14f00, v0.10.1)
+MIT — Copyright (c) 2026 hakoniwa
+고정 커밋의 src/*.js(편집기 UI 12_ui.js 빼고)를 업스트림 build.py 와 같은 순서로 한 파일로 이었다. 업스트림 파일은
+고치지 않았다. 원본 LICENSE 는 옆 JIZURA_LICENSE.txt, 출처·고정 커밋·MIT 원문은 packages/jizura/vendor/NOTICE.
+다시 만들기: node packages/jizura/src/vendor.ts. 가사 층으로 낸 영상에는 "JIZURA 字面 (c) 2026 hakoniwa (github.com/852wa), MIT" 를 적는다.
+글꼴 — google/fonts 고정 커밋 51303ca 의 SIL Open Font License 1.1 글꼴. 자주 쓰는 Noto Sans KR·Noto Serif KR·Black Han Sans·
+Gowun Batang·DotGothic16 은 한글·영숫자·문장부호만 남긴 서브셋으로, IBM Plex Mono 는 원본 그대로 packages/jizura/vendor/fonts 에
+OFL-<폴더>.txt 원문과 함께 실려 있다. 그 밖의 얼굴은 처음 쓸 때 같은 커밋의 원본을 ~/.cache/kasaframe/jizura/fonts 로 받는다.
+
+vocaloid-style-mv-pipeline — packages/jizura/src/layer.ts·deny.ts·vendor.ts, tools/lyrics/align.py
+https://github.com/EGSECDA/vocaloid-style-mv-pipeline (로컬 클론 커밋 13b380d)
+MIT — Copyright (c) 2026 NikusonP
+엔진 묶기 순서(template/tools/build_jizura_bundle.mjs), 플랜 만들기와 색 구성 고르기 schemes 'dark'·'light'
+(template/jizura/app/jizura_adapter.js), 부품 거부 목록(references/06-jizura.md §5 와 그 틀로 만든 뮤비의 timeline.js)을
+옮겼다. 가사 정렬은 MMS 강제 정렬(가중치 CC-BY-NC)을 쓰지 않고 demucs + stable-ts align 길로 새로 짰다.
+
+  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/README.md

@@ -1,3 +1,93 @@
-# Temporary Holding Version
+# kasaframe
 
-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.
+말로 시키는 코드 영상 엔진. 장면을 「시각 t 에서 화면이 어떻게 생겼나」를 그리는 웹 코드(TypeScript)로 짜면, kasaframe 이 헤드리스 크롬으로 1/60초마다 찍어 MP4 로 굽고, 멈춤·빈 화면·글 깨짐·화면 밖 글·대비·섬광을 검사한다. 곡이 있으면 박·마디·드롭을 재서 장면 경계를 거기에 붙인다.
+
+쇼츠·홍보·설명·공개·시연·광고·피드·뮤직비디오 — 용도마다 틀(`templates/`)이 있고, Claude Code 같은 코딩 에이전트에게 「영상 만들어」 한 줄로 맡길 수 있게 장면 지시서까지 낸다.
+
+## 설치
+
+```sh
+npm i -g kasaframe
+kf setup     # Playwright 크롬 + librosa(곡 분석) 받기
+kf doctor    # ffmpeg·크롬·librosa·OG 키 점검 — 없는 것은 까는 명령을 알려 준다
+```
+
+## 요구 사항
+
+| 무엇 | 왜 | 깔기 |
+|---|---|---|
+| Node 22.18 이상 | `kf` 자체 | https://nodejs.org |
+| ffmpeg·ffprobe | MP4 굽기·검사 | macOS `brew install ffmpeg` · 데비안/우분투 `sudo apt-get install -y ffmpeg` |
+| 크롬(Playwright chromium) | 장면 찍기 | `kf setup chrome` — 리눅스는 시스템 라이브러리도: `kf setup` 이 알려 주는 `install-deps` 명령 |
+| python3 + librosa | 곡에 박을 맞출 때만(`--music`·`kf beats`) | `kf setup beats` — `~/.cache/kasaframe/py/beats` venv 에 깐다(`KF_PYTHON` 으로 바꿀 수 있다) |
+| OG 키 | 그림 생성·`kf make` OG 모드만 | 아래 「OG 모드」 |
+
+리눅스 상자에서 글꼴 CDN 이 막혀 있으면 한글이 두부로 나온다 — `sudo apt-get install -y fonts-noto-cjk`. macOS 에서는 검사가 화면 글을 읽는 데 `swiftc`(Xcode 명령줄 도구)를 쓰고, 없으면 그 검사만 건너뛴다.
+
+## 빨리 해 보기
+
+```sh
+kf new hello --template shorts     # 용도: promo · shorts · explainer · launch · demo · ad · square · mv
+kf preview hello                   # 미리보기 주소 — 저장하면 바로 반영
+kf render hello --tabs 2           # → hello/out/render.mp4
+kf check hello                     # 검사 보고(종료 코드 0 통과 · 1 오류)
+```
+
+`kf new` 는 `kf.json`(장면 시간표)과 `scenes/*.ts`(장면 뼈대)를 만든다. 장면을 채우는 법·규칙은 패키지의 `docs/AGENTS.md` 에 있다. 곡이 있으면 `--music 곡.mp3` — 박을 재서 장면 경계를 드롭·마디에 붙인다(곡은 패키지에 없다. 곡 모음 폴더는 `KF_MUSIC_DIR`).
+
+## 말로 시키기
+
+```sh
+kf skill install                   # ~/.claude/skills/kasaframe 에 스킬 링크
+```
+
+새 Claude Code 세션에서 「OG 소개 쇼츠 30초, 리소 느낌으로」처럼 말하면 스킬이 `kf make` 로 간다. Claude Code 안에서 `kf make` 는 용도·테마·곡을 고르고 뼈대와 장면 지시서(`MAKE.md`)까지 만든 뒤 멈춘다 — 세션이 장면을 채우고 `kf look`(장면 모음을 직접 보기) → `kf make --finish` 로 렌더·검사·표지까지 간다. 다른 모델을 부르지 않고, 돈이 드는 그림 생성도 묻지 않고 하지 않는다.
+
+## OG 모드
+
+[OpenGateway](https://opengateway.ai) 키가 있으면 쓸 수 있는 것:
+
+- `kf make "<요청>"`(Claude Code 밖) — OG 모델이 장면까지 쓰고 렌더·검사·고치기를 끝까지 돈다(`--model` 로 모델을 고른다)
+- `kf gen img` — gpt-image 로 장면에 쓸 그림 생성(캐시·예산 상한)
+- `kf look --vision-model <모델>` — 그림을 못 보는 세션 대신 그림 보는 모델이 장면마다 글로 보고
+
+키는 환경 변수 `OPENGATEWAY_API_KEY` 또는 파일 `~/.config/opengateway.key`(한 줄). 없으면 이 셋만 빠지고 — 생성 대신 키를 둘 자리를 알려 준다 — 장면·렌더·검사는 그대로 돈다.
+
+## 목소리·곡
+
+쇼츠·설명은 차분한 TTS 내레이션과 깊은 앰비언트 곡(`deep`)이 기본이다. 목소리가 장면 길이를 정하고, 렌더가 곡을 말 아래로 덕킹해 -14 LUFS 로 섞는다. 곡은 틀이 박은 분위기(`deep`)대로 매번 같고, 목소리는 만들기 전에 묻는다(로컬 Qwen3·ElevenLabs·자막만·그 밖 차례). 엔진·곡이 없으면 다른 것으로 넘어가지 않고 키 넣기·다른 엔진·빼기를 묻는다.
+
+| 쓰는 것 | 키 | 상태 |
+|---|---|---|
+| Gemini TTS(`gemini-3.8-flash-tts`) · Lyria 3.5 음악 | `GEMINI_API_KEY` 또는 `~/.config/gemini.key` | 실호출로 확인 |
+| ElevenLabs TTS(with-timestamps — 낱말 시각까지) · Eleven Music | `ELEVENLABS_API_KEY` | 문서대로 짰고 **실호출 안 함** |
+| Qwen TTS(DashScope `qwen3-tts-flash`) | `DASHSCOPE_API_KEY` | 문서대로 짰고 **실호출 안 함** |
+| 로컬 Qwen3-TTS(`tools/tts/qwen3_tts_server.py`) | `KF_QWEN3_TTS_URL` | 서버 주소가 있을 때만 — **실호출 안 함** |
+
+키가 하나도 없으면 목소리 없이 자막 트랙만 간다. 단가·라이선스: `packages/gen/PROVIDERS.md`.
+
+## 명령
+
+| 명령 | 하는 일 |
+|---|---|
+| `kf new` | 용도 틀에서 프로젝트 뼈대 — 곡 분석·박에 맞춘 장면 시간표·장면 파일 |
+| `kf make` | 요청 한 줄로 끝까지 — 용도 판별·계획·장면·렌더·검사 |
+| `kf preview` | 미리보기 — 곡이 기준 시계, 타임라인·박·드롭·프레임 이동 |
+| `kf render` | MP4(또는 ProRes·PNG 묶음)로 굽기 — 탭 병렬, 곡 얹기, 자막 |
+| `kf check` | 검사 — 멈춤·빈 화면·글 깨짐·화면 밖 글·대비·섬광·박 경계·움직임 규칙 |
+| `kf still` · `kf sheet` · `kf look` | 한 장 · 장면 모음 · 장면별 확인표 |
+| `kf beats` | 곡을 재서 `beats.json` — 박·마디·프레이즈·구간·드롭·대역 에너지 |
+| `kf gen` | 그림·영상 생성(OG · fal · MiniMax · Veo · LTX) |
+| `kf narrate` | 내레이션 먼저 — 장면별 문장을 TTS 로 읽혀 장면 길이를 목소리에 맞추고(곡이 있으면 박에), 자막을 목소리 시각으로 |
+| `kf music` | 곡 모음(분위기 태그) 보기·넣기, 음악 생성(Lyria · Eleven Music) |
+| `kf transitions` | 전환 목록 — 이름·출처·라이선스 |
+| `kf theme list` · `kf theme sheet` | 테마 — `riso-zine` · `debug-hud` · `og-measure`, 같은 문장 한 장면을 테마마다 찍은 견본 격자 |
+| `kf app` | 작업실 — 요청 칸·실시간 미리보기·렌더·검사 보고를 브라우저로(:5150) |
+| `kf doctor` · `kf setup` | 바깥 도구 점검 · 깔기 |
+| `kf skill` | Claude Code 스킬 링크 |
+
+`kf <명령> --help` 로 인자를 본다. 렌더·검사는 한 기계에서 하나씩 돈다(잠금 — 다른 렌더가 쥐고 있으면 기다린다).
+
+## 라이선스
+
+MIT © 2rami — `LICENSE`. 들여온 전환·셰이더의 출처와 라이선스(MIT·BSD 등)는 `NOTICE`.

package/app/package.json

@@ -0,0 +1,12 @@
+{
+  "name": "@kasaframe/app",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "node server/main.ts"
+  },
+  "exports": {
+    ".": "./server/engine.ts"
+  }
+}