SuperAPI AI 工具集

typescript-style

编程与开发

查看项目

更新于 10-15 20:28

技能介绍

用途:在新增或修改 .ts / .tsx 文件、决定使用服务端还是客户端组件、处理公开环境变量,以及对齐本项目 ESLint 规则时使用。

编译器约定:tsconfig.json 启用 strict、noEmit、jsx: "react-jsx"、moduleResolution: "bundler",并启用 Next.js TypeScript 插件。路径别名 @/* 映射到仓库根目录,例如 @/lib/contentstack、@/components/ContentstackLivePreview。

React / Next.js 边界:默认使用服务端组件;仅当需要 hooks、浏览器 API 或仅客户端 SDK 初始化时才添加 "use client" 指令,可参考 components/ContentstackLivePreview.tsx。异步服务端组件用于 app/page.tsx,其中 searchParams 按 Next.js 16 模式作为 Promise 处理。

ESLint:.eslintrc.json 继承 next/core-web-vitals 与 next/typescript。@typescript-eslint/no-explicit-any 处于关闭状态,但在可行时优先使用 SDK 或 lib/types.ts 中的正式类型。

环境变量类型:仅使用 NEXT_PUBLIC_* 暴露浏览器端配置;除非显式添加并记录,否则不要假定存在仅服务端的密钥环境变量。

限制:资料未提供安装命令、版本要求、示例代码或更多配置细节,暂未提供。