lynx-typescriptlisted

> **📚 Lynx 레퍼런스.** Lynx 환경의 TypeScript 설정과 타입 문제를 다룹니다. > 규칙 ��이 아니라 조회 자료라 `reactlynx-best-practices`·`vanilla-lynx`와 **함께** > 씁니다. <!-- vendored:begin --> # TypeScript @ Lynx This Skill summarizes common TypeScript issues and their solutions in Lynx development, mainly covering environment configuration, type extending, event handling, components, and ReactLynx advanced usages. ## 1. Configuration (Environment Configuration) ### 1.1 `tsconfig.json` Configuration Rspeedy reads the `tsconfig.json` in the root directory by default. Since Rspeedy uses SWC for transpilation, it is recommended to enable the `isolatedModules` option to avoid cross-file type reference errors. ```json title="tsconfig.json" { "compilerOptions": { "isolatedModules": true, "paths": { "@/*": ["./src/*"] } } } ``` ### 1.2 Type Packages Installation Ensure the correct type packages are installed. **@lynx-js/types** is the core type package for Lynx. - **ReactLynx**: Install `@lynx-js/types` and `@lynx-js/react`. ### 1.3 Type Declaration File `rspeedy-env.d.ts` To allow TypeScript to recognize Rspeedy's built-in features (such as CSS Modules, static resource imports), you need to create a `src/rspeedy-env.d.ts` file in the project: ```typescript title="src/rspeedy-env.d.ts" /// <reference types="@rspeedy/core/client" /> ``` *(Note: The actual package might depend on your Rspeedy setup, typically `@rspeedy/core` or similar for open source)* ### 1.4 ReactLynx JSX Configu