Ezi d Z ddlmZ ddlZddlZddlZddlmZ ddlm Z ed Z
e
dz Z dZ dd Z
d
d d d
ddd ddZddZddZddZddZd dZy) u Satori 텍스트 오버레이 호출 공통 헬퍼.
이 모듈은 한글 텍스트를 100% 정확하게 렌더링하기 위해 Satori (Node.js)를
서브프로세스로 호출하는 통합 진입점을 제공한다. 외부 API 직접 호출은 절대
허용되지 않는다 — Satori는 로컬 Node.js 프로세스를 통해서만 invoke된다.
한글 폰트 fallback 차단:
- font-family는 'Pretendard', 'Noto Sans KR'만 허용
- system fallback (Arial, Helvetica, sans-serif)은 한글 깨짐을 유발하므로 금지
- font-family는 빌드된 HTML/CSS에서만 사용 (PNG 렌더 자체는 Satori가 임베드한 폰트 사용)
IDS Phase 1 §3.2.1 / §0.2 Hybrid Pattern Standard 준수.
) annotationsN)Path)Anyz2/home/jay/workspace/tools/ai-image-gen/satori-testz
satori_cli.jsz 'Pretendard', 'Noto Sans KR'c t | t r|S t | t r| S t | t t f r t | S |S # t
t f$ r |cY S w xY w)uH design_tokens dict에서 안전하게 정수를 추출 (pyright 호환).)
isinstanceboolintfloatstr TypeError
ValueError)valuedefaults ;/home/jay/workspace/skills/hybrid-image/patterns/_satori.pyas_intr s_ % % %% & u: N :& N s
A A A z#ffffffz#e5e5e5zrgba(10, 10, 10, 0.55)@ $ )background_layer title_color
body_color
overlay_bg
title_size body_sizec v d| d| dt d| d| d| d| dt | d | d
| d t | d S )
u5 Satori가 소비할 HTML 문자열을 생성한다.
Args:
title: 한글 헤드라인.
body: 한글 본문.
width: 출력 폭(px).
height: 출력 높이(px).
background_layer: 배경 div HTML (Gemini/Codex 결과 또는 Satori gradient).
title_color: 헤드라인 색상.
body_color: 본문 색상.
overlay_bg: 가독성용 오버레이 박스 배경.
title_size: 헤드라인 폰트 크기.
body_size: 본문 폰트 크기.
Returns:
Satori-호환 HTML 문자열.
z3)KOREAN_FONT_STACK_esc)
titlebodywidthheightr r r r r r s
r build_text_overlay_htmlr" . s @ >eW E)*;)< ==
$$.< 0!!+ -
GU } U!!* , 0d =
c
t | }|j j dd t j d }|t
j
ro| ||t | d} t j |t t
gt j | dddt t d |j
r|S t! | ||| S # t j t j t f$ r Y 9w xY w)u HTML을 Satori (Node.js)로 PNG 렌더링한다.
Satori 스크립트가 부재하면 Pillow 기반 minimal fallback (텍스트만 렌더).
어떤 경우에도 한글은 100% 정확하게 보존된다 — 외부 API 호출 없음.
Args:
html: Satori-호환 HTML.
output_path: 출력 PNG 경로.
width: 폭.
height: 높이.
Returns:
실제 저장된 PNG 경로.
T)parentsexist_oknode)htmlr r! outputx )inputtextcheckcapture_outputcwdtimeout)r r! )r parentmkdirshutilwhichSATORI_RENDER_SCRIPTexistsr
subprocessrunjsondumpsSATORI_SCRIPT_DIRCalledProcessErrorTimeoutExpiredFileNotFoundError_pillow_fallback)r( output_pathr r! node_binpayloads r render_html_to_pngrC ] s {#K TD 9||F#H 4 ; ; = +& #
NN3 345jj) #)*
!!#"" $ D+U6 JJ --z/H/HJ[\ s %A C (C=<C=c ddl m}m} |j d||fd }|j
| }t | }|j d|dd d
|j |d |S # t $ r t ||| |cY S w xY w)
u Satori 부재 시 Pillow로 placeholder PNG 생성 (한글 텍스트 보존).
IDS 표준: 외부 API 호출 0건. 환경 의존 도구 부재 시 graceful degrade.
r )Image ImageDrawRGB) rH )color)( rK Ni ) rL rL )fillPNG)format)
PILrE rF ImportError_write_blank_pngnewDraw _strip_tagsr, save) r( r@ r r! rE rF imgdrawr, s r r? r? s
( ))EE6?,)
?C >># D t DIIhTc
I9HH[H' eV4s A( (BBc
" ddl ddl dj fdt | D } j | }d
fd }d}j d|dd ddd }| j
| |d
| z |d | z |d d z y)uh Pillow 미설치 시 최소 PNG (단색) 작성.
PNG 헤더만 직접 작성. 외부 의존 0.
r Nr# c 3 . K | ] }d dz z yw) s N ).0_r s r z#_write_blank_png.. s L7_u 44Ls c j | |z dz }j dt | | z |z j d| z S )Nl z>I)crc32packlen)tagdatacrcstructzlibs r chunkz _write_blank_png..chunk sI jjt$z1{{4T+c1D86;;tS;QQQr# s PNG
z>IIBBBBB s IHDRs IDATs IEND)rd bytesre rl returnrl )rg rh joinrangecompressrb write_bytes)
r@ r r! raw
compressedri sigihdrrg rh s
` @@r rR rR s
((LeFmL
LC s#JR C ;;z5&!Q1a @D eGT""U7J%??%QTBUUr# c | j dd j dd j dd j dd S ) u% HTML 이스케이프 (한글 보존).&z&z>"z")replace)r, s r r r s;
S'" f f h r# c v ddl }|j dd| }|j dd| }|j S )u( HTML 태그 제거 (Pillow fallback용).r Nz<[^>]+> z\s+)resubstrip)r( r~ r, s r rU rU s5
66*c4 (D
66&#t $D ::<r# )r objectr r rm r )r r r r r r r! r r r r r r r r r r r r r rm r )
r( r r@ r r r r! r rm r )r@ r r r r! r rm None)r, r rm r )r( r rm r )__doc__
__future__r r9 r3 r7 pathlibr typingr r; r5 r r r" rC r? rR r rU r\ r# r r s #
MN (?: 3 ( ., ,
, ,
,
, , , , , , ,^*KZ*,r#