bi6UdZddlmZddlZddlZddlmZmZddlm Z ddl m Z ddl Z ddlmZdZd ed < d Zd ed <dZded<dZded<dZd ed<dZd ed<dZd ed<dZd ed<dZded<dZded<dZded <dZded!<dZded"<d#Zd ed$<d%Zded&<d'Z ded(<d)Z!ded*<d+Z"d ed,<d-Z#d ed.<d/Z$d ed0<d1Z%d ed2<e&d3d4hZ'd5ed6<gd7gd8d9Z(d:ed;<e&hd<Z)d5ed=<e&hd>Z*d?ed@<dAZ+d edB<GdCdDe,Z-GdEdFe,Z.eGdGdHZ/eGdIdJZ0e e1jddKz dLz Z3d`dMZ4dadNZ5dadOZ6dbdPZ7dcdQZ8 dddRZ9dedSZ: dfdTZ;dgdUZ djdXZ?dkdYZ@dkdZZAdldmd[ZB dn dod\ZC djd]ZDdkd^ZEdpd_ZFy)qu.IDS Phase 0.5 — Lite Evaluator (5항목, OCR 비의존, 정적 분석). 목적: Phase 0 SSOT(mapping-tables.md #5-A + target-audience.md §7)를 LayoutMeta(JSON Schema 강제)로 받아 5항목을 즉시 PASS/WARN/FAIL 평가. mapping #4(scripts/quality_evaluator.py: PIL 회귀 게이트)와 책임 분리: - mapping #4 = 27 PNG 렌더 결과의 정량 회귀(silent corruption 차단). - mapping #5(본 모듈) = LayoutMeta + PIL Image 정적 분석으로 디자인 품질 게이트. 5항목 (외부 명명 = task-2446 task.md / 내부 알고리즘 = mapping-tables 5-A): L1 Contrast — 글리프 픽셀 contrast 분포 5th/95th percentile (mapping 5-A L1) L2 Margin — safe-area(SSOT 6.7%=72px) 침범 검사 (mapping 5-A L2) L3 Hierarchy — 헤딩/서브헤드/본문 비율 + dq-rules absolute_min(40) (mapping 5-A L3 + dq-rules font_sizes) L4 Color Token — palette 4색 이내 + AI 퍼플 검출 (mapping 5-A L5 + dq-rules color) L5 Typography — Pretendard / Noto Sans KR + weight 600+ + 자간/행간 (dq-rules font_pairing) 참조: - SSOT: memory/plans/ids-phase4-design-system/mapping-tables.md (lines 430~620) - SSOT: memory/plans/ids-phase4-design-system/target-audience.md §7 (lines 238~337) - dq-rules: memory/specs/dq-rules.json ) annotationsN) dataclassfield)Path)Any)Imagezv1.0strSSOT_MAPPING_VERSIONgx&?floatSAFE_AREA_RATIOint GRID_BASELINE)iconztuple[str, ...]GRID_SUBGRID_WHITELIST_ROLESg@CONTRAST_BODY_MIN_AAg@CONTRAST_BODY_RECOMMENDED@CONTRAST_LARGE_MIN_AACTA_CONTRAST_MIN_AA(DQ_FONT_ABSOLUTE_MINTDQ_FONT_HEADLINE_MIN@DQ_FONT_SUBHEAD_MINDQ_FONT_CTA_MINDQ_FONT_DISCLAIMER_MINg?DQ_HEAD_SUB_MIN_RATIODQ_COLOR_MAX_PALETTEDQ_FONT_MIN_FAMILIESDQ_FONT_MAX_FAMILIESgp@AI_PURPLE_HUE_MINgr@AI_PURPLE_HUE_MAX?AI_PURPLE_SAT_MINg?AI_PURPLE_RATIO_FAIL Pretendardz Noto Sans KRzfrozenset[str]PRIMARY_KOREAN_FAMILIES)z#FF6E2Bz#0B1E3Fz#F8F4EEz#1F1F1F#FFFFFF)z#0071E3z#1D1D1Fz#F5F5F7r-z#86868B)ztheme-fa-fintechztheme-consumer-warmzdict[str, list[str]]PRESET_PALETTE_TOKENS>굴림궁서바탕 굴림체 궁서체 바탕체DQ_BANNED_FONTS>,dzfrozenset[int]DQ_BANNED_WEIGHTSg>@GLYPH_COLOR_DELTAceZdZdZy)SchemaValidationErroru$LayoutMeta가 JSON Schema를 위반.N__name__ __module__ __qualname____doc__M/home/jay/workspace/.worktrees/task-2446-design/scripts/ids/lite_evaluator.pyr<r<ks.rCr<ceZdZdZy)SSotMismatchErroruLmappingVersion이 SSOT(SSOT_MAPPING_VERSION)와 불일치 → 진입 차단.Nr=rBrCrDrFrFosVrCrFcdeZdZUdZded<ded<ded<ded<dZd ed <ee Zd ed <y) ItemResultu5항목 각 평가 결과.r codenameverdictrscoreNz str | Nonereasondefault_factorydict[str, Any]details) r>r?r@rA__annotations__rMrdictrQrBrCrDrHrHxs2$ I I L JFJ#D9G^9rCrHcheZdZUdZded<ded<ded<eeZd ed <eeZ d ed <y ) EvalResultuLite Evaluator 종합 결과.r overallrrLzlist[ItemResult]itemsrNz list[str] fail_reasonsrPlayout_meta_summaryN) r>r?r@rArRrlistrXrSrYrBrCrDrUrUs4' L J #D9L)9*/*EErCrUschemasz lite_evaluator_input.schema.jsonctjdd5}tj|cdddS#1swYyxYw)u1LayoutMeta JSON Schema(Draft-07)를 로드한다.rzutf-8)encodingN) _SCHEMA_PATHopenjsonload)fs rD load_schemards9   3  1Qyy|s 7Ac ddlm}t }||}t |j |d}|rmg}|D]I}djd|jDxsd }|jd |d |jKtd d j|zy#t$r}td|d}~wwxYw)ujsonschema Draft7Validator로 입력 계약 강제 검증. 실패 시 SchemaValidationError. 외부 의존성(jsonschema)은 lazy import. r)Draft7ValidatorzElite_evaluator requires 'jsonschema'. Install: pip install jsonschemaNc|jSN)path)es rDz"_validate_schema..s affrCkey/c32K|]}t|ywrh)r ).0ps rD z#_validate_schema..s.chans. ILq5yJE U/Bs.JJrCgz6?g,C?g]m{?)rrreturnr rB)rgbrr]gbs rD_relative_luminancers@KGAq! DG ftAw. .$q'1A AArCcdt|}t|}||kDr||fn||f\}}|dz|dzz S)z(WCAG contrast ratio (L1+0.05)/(L2+0.05).g?)r)fgbgl1l2lightdarks rD_contrast_ratiorsD R B R B 2g2r(B8KE4 DLTD[ ))rCcd|D\}}}t|||t|||}}||zdz }||k(rdd|fS||z }|dkDr |d|z |z z n|||zz }||k(r ||z |z dz} n||k(r ||z |z dz} n ||z |z dz} | dz||fS) u'RGB(0~255) → HSL(h: 0~360, s/l: 0~1).c3&K|] }|dz  yw)rNrB)rprs rDrrz_rgb_to_hsl..s&Qq5y&sg@r(rr"r gN@)maxmin) rr]rrmxmnrdeltasathues rD _rgb_to_hslrs'#&GAq! Aq\3q!Q<B "WOE RxC GE%*S[%38b= !erBw6GC QwA!# q1uo!1uo! :sE !!rCc `tjtdt||DS)zsRGB Euclidean distance.c32K|]\}}||z dzyw)r"NrB)rpxys rDrrz"_color_distance..s<$!Q!a%A._window_meanOsp BK  BK  QV $ QV $B$$&GBFO$ 6 WR!VRZ( (E Sa,- -E 6 WRaZ( (E SR!V,- -E 6b1f WR!VR!V^, ,E Saa01 1E A:E!Hu$%s58e+;'STTrCi)rrrrrztuple[int, int, int] | None)rrsizerastyperint32reshapearrayrrr:anymeanrrmedianrrcumsumwhererlinspacerr})#img_arr componentfill_rgbregionrflatdiff dist_flatglyph_mask_flat bg_mask_flatmean_bgratio glyph_maskbg_mask bg_pixelsbg_median_global global_bgbg_onlybg_countr contrastsglyph_ysglyph_xs max_samplesidxrrlocal_bgrrrrrrrs# @@@@@rD_glyph_pixel_contrastsr s$ 9V,-H 6!2 3F {{a << DAq bqb/  *C ;;r1 D "((82884 4D))q)12I"33O##L    (8(8(:3799$)))#**3/"((?B[ s71:GAJWQZI w ((A.J""1a(GG Iyy3::3?%a()3/?/B+CSIYZ[I\E]^IC1IO $FGI&&G~~bhh'Hii '2;Gii (3!ctabodycaptionsubheadheadline disclaimerL1ContrastWARNFu,text component 0건 — 평가 대상 없음component_countrrIrJrKrLrMrQF_r>rr fontWeightiXzL1 rJz contrast p5=.2f < z.1fu (절대 하한)r$FAILPASS)rJr p5p95 min_requiredis_ctarKrKr7; N per_component) rrHr rrrrrr}roundr{)rrrtext_componentsr( overall_fail overall_warnrXrr"r#r%r$is_large comp_fail comp_warnrKrLs rDevaluate_l1_contrastr0ts\* 554 QvY2q%q O A&*   +-MLL L " *7A6   A &)R(6e#.4*:N V9 77[AEE,PSrlogo decorationrrJ)r6r8r9r7)rJr r violationsr gridbaseliner usafe-area 침범 건u!safe-area SSOT 불일치: 기대 z.0fupx ±4 / 실제 top=z , bottom=z, left=z, right=zgrid baseline=u: ≠ SSOT 8 (4px는 sub-grid 화이트리스트만 허용)r r< r'rr&r!r7NL2Marginr) safe_areassot_expected_px ssot_aligned grid_baselinegrid_baseline_alignedr<violation_countr) rr}rr absrrrr{rHr))rr2saferrr6r7r8r9r<rr*rrrrv_topv_leftv_rightv_bottomexpectedrrFr=r>grid_violationrX warn_reasonsrKrLrMs rDevaluate_l2_marginrSs "F z "D '?F8,qAu+tH~Cv,W %D')J\* 554 QvY6T%T O vY 1aCTq5QY'Ea&j) Fg   fIfI1aL$ &!("* #  ,1ay?*H  C(N FX  D8O EH   E A:L ??62 &D488J*+H.N L L/J/@DE /~=QRUQVWXWTF(5' ; XJ&` a ArC Ob001<,67 <(    %h 2(%)7%7$":  Ks"Hc i}g}|dD]<}|jdds|j|dgj|d>g}|dD]@}|jdds|dtks#|j|d|d|ddB|r%|jdtd t |d t t ttd }g}|jD]7\}}|j|gD]} | |ks |j|| |d 9|r|jd t |d d} d} |jdr\|jdrKt|d} t|d} | dkDr*| | z } | tkr|jd| ddt|rd}d}n | rd}d}nd}d}tdd|||rdj|nd|||| d S)!usL3: dq-rules font_sizes(absolute_min=40, headline/subhead/cta) + font_ratio.min_head_sub_ratio=1.3 검증. r r Tr fontSizerJ)rJr rUz absolute_min=u px 위반 r?)rrrr)r rUrurole 최소값 위반 FNrrrzhead/sub ratio=rrr rr&r!r7L3 Hierarchyr') by_role_sizesabs_min_violatorsrole_violationshead_sub_ratior)r setdefaultr}rrrrrrrWrrrHr{)rby_rolerXrrZrole_minr[r min_sizefs ratio_warnr\head_maxsub_maxrKrLs rDevaluate_l3_hierarchyre(sU')G L  &@uuXt$ 1V9b)00:?@ /1  &uuXt$  Z=/ /  $ $6AfI1Z=Q  01C@Q.s ArCrlr)rrrrrrrrrint64rrrryrWr})rrrrrstep_ystep_xsamplebinsizebinskeyscountssumsrmpxtotalpaletteravgs rD_cluster_paletterv|s  xx1} c2A2g,C 99Ra=DAq AG_F AG_F 68V8# $ , ,R 3 : :3 ?FG g  % %c *D 1: d1a4j2o -QT :DF"$DtV$Rjja(1,s d? "((+002DI IOI    EG->?C QCyA~%%c*SVc#a&k3s1v;7"E     NrCc g}|D]h\}}t|\}}}d}|D]3} t|| dz } | dkDrd| z } | |ks$| dxx|z cc<d}n|rR|j|||||dj|S)uLΔhue<15° 클러스터 통합 (그라데이션 카운트 부풀림 방지).FrihweightT)rrlryr)rrJr}) rt hue_tolerancegroupsrryrrrmergedrdhs rD _unify_huesrs $&F Z V%c*S% AS1S6\"BCx2XM!( v%   MM#EVTWX Y Z MrCct|d}t|}|Dcgc] }|ddkDs |}}t|}|dddfjt}|j dd\}} t d t || d z} |dd| dd| fjd d} d } | D]^} tt | d t | d t | df\}}}t|cxkr tksMnP|tkDsZ| d z } `t| r| t| z nd }tj|jddg}|Dcgc] }t|}}|dDchc]'}|jddr|dj)}}g}|D]6}t||st!fd|Dr&|j#|8g}|t$kDr|j#d|d|t&kDr|j#d|ddg}|r3|j#dt|d|d|jdd|rd}d}d j)|}n|rd!}d"}d j)|}nd#}d$}d}t+d%d&||||t-|d'||Dcgc]%}|d(t-|d)d t-|dd'd*'c}d+,Scc}wcc}wcc}wcc}w)-uPL4: palette 4색 이내 + AI 퍼플(hue 270~300, sat>0.5) 캔버스 10%+ 검출.r)rryg{Gz?.Nr$r"rrrr themePresetr r Trc3<K|]}t|dkyw)rVN)r)rptrs rDrrz*evaluate_l4_color_token..s"# 23OHa (2 -# szpalette u색 > 4 (brand 2~3 + accent 1)uAI 퍼플 그라디언트 z.1%z! > 10% (LR_NO_AI_PURPLE_GRADIENT)zoff-token fill u건: z (themePreset='u' palette 외)r rVr'rr&r!r7L4z Color Tokenr rr)rrry) color_countai_purple_ratiooff_token_fillsrtr)rvrrrrrrrrr&r'r)r.rrupperrr}r!r*r{rHr))rrrtunifiedr significantrrrrsteprl purple_countrrrr_ purple_ratio preset_tokens preset_rgbsr text_fills off_tokenrrXrRrKrLrMrs @rDevaluate_l4_color_tokenrsK w!,G'"G%<8t);19K9\* 554  & J I#t$ s# 7B#     T " #!L)){m#A B **(c(:;) * !Lc)n-U9+>(__];rrrz (z ) fontWeight=u < 600 (SemiBold 이상 권장) weak_emphasis letterSpacingir7z letterSpacing=u 극단값 lineHeightrg?rz lineHeight=u 권장 범위 0.8~3.0 벗어남z families=ruN (min_families 미달 — 동일 패밀리 내 weight 대비로 충족 가능)z > u (max_families 초과)r rVr'rr&r!L5 Typography) families_seen family_countfamily_violationsweight_violationsr) setrr}addr5r,r9rr#r%r{rHry)rrXrRrrrrrrylslhrrKrLrMs rDevaluate_l5_typographyrsj!L L!eM.0.0  &3`uuXt$ |$   1V9+-c d e  $ $ai4QZ%[ \ &! _ $   V9+]6(2RS   $ $ai6S[%\ ] 2 2   V9+]6(3KL   $ $6fmL  |$ & &   V9+\&1GH   $ $ai6S[%\ ] V9+ +0BvPS|   V9+R& {-x@+,   $ $6foN  UU? # >rDyBH   1V9+_RD K LUU<  >b1f"s(b3h   1V9+\"=] ^ _g3`l}%L** ~S)=(>?\ ]  , , ~S)=(>?$ % <( <(   #M2(!2!2   rCc t|t|t|d}|jst d|t j |jd}tj|}t||t|t|t||t|g}|Dcgc]E}|jdk(r4|j r(|j"d|j$d|j G}}t'd|Drd}nt'd|Drd }nd }t)t+t-d |Dt/|z }t1|||||d |d |dt/|ddScc}w)u_Lite Evaluator 메인 진입점. Steps: 1. JSON Schema 강제 검증 (실패 → SchemaValidationError) 2. mappingVersion 검증 (실패 → SSotMismatchError) 3. PNG 로드 (PIL) → numpy 4. L1~L5 각 평가 5. EvalResult 종합 Returns: EvalResult — overall verdict + 5항목 details image_pathzimage_path not found: RGBr  rtc3:K|]}|jdk(yw)r NrKrpits rDrrzevaluate..s 0B2::  0c3:K|]}|jdk(yw)rNrrs rDrrzevaluate..s 2bRZZ6 ! 2rrr!c34K|]}|jywrh)rLrs rDrrzevaluate..s3r"((3sr targetPersonarr )rrrr)rVrLrWrXrY)rrrexistsFileNotFoundErrorrr`convertrasarrayr0rSrerrrKrMrIrJrrr)rrrU) rimg_pathimgrrWrrXrVrLs rDevaluaters[!;'K -.H ?? "8 CDD **X  & &u -CjjoG Wk2;'k*5{+  E  :: BII 77)1RWWIR {+L  0% 00 2E 2 2 c3U33c%j@A BE !&}5(9)*:;";|#<=   s6A F)rrP)rrPrNone)rr rtuple[int, int, int])rrrr )rrrrrr )rrrztuple[float, float, float])rrrrrr )r list[float]rqr rr )r np.ndarrayrrrr)rrrrPrr)rrrrPrrH)rrPrrH)r)rrrrr(list[tuple[tuple[int, int, int], float]])g.@)rtrr{r rzlist[dict[str, Any]])rrPrrU)GrA __future__rrar dataclassesrrpathlibrtypingrnumpyrPILrr rRr rrrrrrrrrrrrr!r#r%r&r'r)r* frozensetr,r.r5r9r: Exceptionr<rFrHrU__file__parentr_rdrrrrrrrrrr r0rSrervrrrrrBrCrDrs.# (#c"X s09o9"e!#&5&"u" U ccS  "u"ccc!5  5 5"e"+4\>4R*SS /+ #,I#%.o$>>> 5/I/W W :: : FF FH~$$y03UU  4 = B**"6* *"&>> 4> > .T TTTnF F&4FF\^LLh$R  5.W W&4WW~cV5rC