transform 은 CSS 를 네 단계로 TypeScript 모듈로 바꾼다. 먼저 파싱하고, 문법 오류가 있으면 진단을 남긴 뒤 관대한 파서로 다시 읽는다. 다음으로 내보낼 이름(클래스, id, keyframes, @value, :export 키)을 모으면서 CSS 에 적힌 위치를 같이 적는다. 그다음 이름을 설정에 따라 camelCase 같은 키로 바꾼다. 마지막으로 TypeScript 를 써 내려가면서, 키를 하나 쓸 때마다 그 자리를 원본 CSS 의 이름 자리에 잇는 대응 한 칸을 남긴다. 키와 원본 이름의 글자가 달라도 hover 와 정의로 가기는 CSS 의 그 이름으로 간다.

-- TS 7 content mapper 가 transform 요청을 받으면: CSS 모듈 → TS 모듈 + 대응표 + 진단
transform :: Options -> Content -> Result
transform opts = stripBom >>> parse >>> collectLocals >>> exportsOf (localsConvention opts)
             >>> render opts >>> shiftBom
  -- BOM: postcss 가 떼므로 그만큼 원본 위치·진단 위치를 다시 민다

-- ① 오타 하나가 이 파일을 import 하는 모든 곳을 깨지 않게
parse :: CSS -> (Root, [Diagnostic])
parse css = case postcss css of
  Right root -> (root, [])
  Left err   -> (safeParse css, [syntaxError err])   -- 진단을 남기고 살릴 수 있는 만큼 살린다

-- ② 내보낼 이름과, CSS 에 적힌 그 이름의 위치 (escape 포함) — 이 위치가 ④의 대응 끝점이다
locals :: Node -> [Local]
locals (Rule ":export" decls)       = map prop decls          -- ICSS: 키 그대로
locals (Rule sel) | inKeyframes     = []                      -- from·to·50% 는 이름이 아니다
                  | otherwise       = classesAndIds sel       -- :global(…) 안은 빼고, 인자 없는 :global 은 뒤쪽 전부를 뺀다
locals (AtRule "keyframes" name)    = [name]                  -- :global 이면 없음
locals (AtRule "value" params)      = valueNames params       -- @value a: …  /  @value a, b as c from "…"
locals (AtRule "scope" params)      = parenthesized params >>= classesAndIds   -- @scope (.card) to (.content)
locals (Decl "composes" v)          = []                      -- 대신 검사: 이 파일에 없는 클래스면 진단, from 이 붙으면 건너뜀
  -- 같은 이름은 처음 것만. hover 문서 = 앞의 /** */ 주석 + 선언 CSS (12줄까지)

-- ③ 이름 → 키. Vite 의 css.modules.localsConvention 과 같은 값
keys :: Convention -> Name -> [Key]
keys CamelCase     n = [n, camelCase n]          -- camelCase = lodash.camelcase (postcss-modules 와 같게)
keys CamelCaseOnly n = [camelCase n]
keys Dashes        n = [n, dashesCamelCase n]    -- 대시 뒤 글자만 대문자로
keys DashesOnly    n = [dashesCamelCase n]
keys _             n = [n]

-- ④ TS 를 써 내려가다 키를 쓰는 순간, 그 자리를 원본 이름 자리에 잇는다
emitKey :: Key -> Local -> Writer (Text, [SpanMapping]) ()
emitKey key local = do
  here <- length <$> text
  tell ( key
       , [(here, length key, start local, length local, Alias, Hover .|. Definition .|. References .|. DocumentHighlights)] )
  -- Alias: 키(btnPrimary)와 원본(btn-primary)이 달라도 에러·정의로 가기는 원본 이름에 붙는다

render :: Options -> [(Key, Local)] -> (Text, [SpanMapping])
render opts exports =
     [ "declare const styles: { readonly " <> emitKey k l <> ": string; … }; export default styles;" | defaultExport opts ]
                                                     -- 식별자가 아닌 키는 "btn-primary" 문자열 키로
                                                     -- styles 라는 키가 있으면 바인딩을 _styles 로
  <> [ "export declare const " <> emitKey k l <> ": string;" | namedExports opts, isBindingName k ]
                                                     -- 식별자이고 예약어가 아닐 때만
  `orElse` "export {};"                              -- 내보낼 게 없어도 모듈이어야 한다
#603