czh-api 1.0.4 → 1.0.6

package/CHANGELOG.md

@@ -2,6 +2,28 @@
 
 所有重要的版本更新都会记录在此文件中。
 
+## [1.0.6] - 2026-04-14
+
+### 修复
+- 修复部分模块在 schema 编译阶段因嵌套字段 `title` 含中文标点、空值或数字开头而生成非法类型别名的问题（如 `export type = ...`、`export type 12 = ...`）。
+- 修复 `expert/groups`、`expert/customers` 等模块在同步解析时出现 `Declaration or statement expected` / `'{` expected` 报错的问题。
+
+### 改进
+- 在类型编译前新增 schema 预处理：递归移除嵌套 schema 的 `title`，仅保留顶层 schema 名称作为类型名来源，避免无效标识符影响 `json-schema-to-typescript` 生成结果。
+
+## [1.0.5] - 2026-03-19
+
+### 修复
+- 修复 FastAPI 场景下返回类型字段被错误降级为 `any` 的问题（如 `items.$ref`、`anyOf`、`oneOf`、`allOf` 组合场景）。
+- 修复数组响应与嵌套对象类型在 fallback 生成流程中丢失字段的问题，避免出现仅有 `{ [key: string]: any }` 的空壳接口。
+- 修复 `group_ids` 等多层结构类型解析不完整的问题，支持递归解析到更深层级（如 `number[] | null`）。
+- 修复类型增强阶段对复杂类型名（数组、联合类型）处理不稳定导致的类型声明异常问题。
+
+### 改进
+- 增强 fallback 类型生成策略：优先基于 `module.schemas` 还原字段结构，再回退到 `any`，生成结果更可用。
+- 增强类型依赖收集能力：从字段类型表达式中提取嵌套引用类型并自动补齐声明。
+- 完善 README 模板示例并与当前默认模板保持一致（`api.hbs`、`index.hbs`、`types.hbs`）。
+
 ## [1.0.4] - 2026-03-19
 
 ### 修复

package/README.md

@@ -190,12 +190,7 @@ export const {{functionName}} = ({{#if hasParams}}params: {{requestParamsTypeNam
   return http.request<{{responseTypeName}}>({
     url: `{{path}}`,
     method: '{{method}}',
-    {{#if hasParams}}
-    params,
-    {{/if}}
-    {{#if hasData}}
-    data,
-    {{/if}}
+    {{#if hasParams}}{{#unless (eq method 'put')}}{{#unless (eq method 'post')}}params,{{/unless}}{{/unless}}{{/if}}{{#if hasData}}data,{{/if}}
     {{#if contentType}}
     headers: { 'Content-Type': '{{contentType}}' },
     {{/if}}
@@ -209,11 +204,9 @@ export const {{functionName}} = ({{#if hasParams}}params: {{requestParamsTypeNam
 export const {{functionName}} = ({{#if hasParams}}params: {{requestParamsTypeName}}{{/if}}{{#if hasData}}{{#if hasParams}}, {{/if}}data: {{requestBodyTypeName}}{{/if}}) => {
   return request.{{#if (eq method "delete")}}del{{else}}{{method}}{{/if}}<{{responseTypeName}}>({
     url: `{{path}}`,
-    {{#if hasParams}}
-    params,
-    {{/if}}
-    {{#if hasData}}
-    data,
+    {{#if hasParams}}{{#unless (eq method 'put')}}{{#unless (eq method 'post')}}params,{{/unless}}{{/unless}}{{/if}}{{#if hasData}}data,{{/if}}
+    {{#if contentType}}
+    headers: { 'Content-Type': '{{contentType}}' },
     {{/if}}
   });
 };