Merge pull request #114 from long-woo/dev

- 插件示例完善，增加 ga4
- 单个 API 支持 errorIgnore 配置

Author: long-woo

.vscode/settings.json

@@ -12,9 +12,6 @@
   "[javascript]": {
     "editor.defaultFormatter": "denoland.vscode-deno"
   },
-  "[typescript]": {
-    "editor.defaultFormatter": "denoland.vscode-deno" 
-  },
   "[json]": {
     "editor.defaultFormatter": "denoland.vscode-deno" 
   },

README.md

@@ -153,8 +153,8 @@ Create a `myPlugin.ts` file:
 
 ```ts
 // 引用模块
-// import { start } from 'https://deno.land/x/stc@2.13.1/mod.ts'
-import { start } from 'jsr:@lonu/stc@^2.13.1'
+// import { start } from 'https://deno.land/x/stc@2.14.0/mod.ts'
+import { start } from 'jsr:@lonu/stc@^2.14.0'
 
 // Defining plugins
 const myPlugin: IPlugin = {

deno.json

@@ -1,12 +1,12 @@
 {
   "name": "@lonu/stc",
-  "version": "2.13.1",
+  "version": "2.14.0",
   "exports": "./mod.ts",
   "tasks": {
     "pack": "deno run -A src/pack.ts",
     "dev": "deno task pack && deno run -A --watch=src src/main.ts --url='https://petstore3.swagger.io/api/v3/openapi.json'",
     "serve": "deno run -A --watch=src src/service.ts",
-    "version": "echo '2.13.1' > release/version",
+    "version": "echo '2.14.0' > release/version",
     "build:npm": "deno run -A src/npm/build.ts",
     "build:mac": "deno compile -A --target x86_64-apple-darwin --output release/stc src/main.ts",
     "build:mac-m": "deno compile -A --target aarch64-apple-darwin --output release/stc-m src/main.ts",
@@ -61,6 +61,11 @@
     "@std/datetime": "jsr:@std/datetime@^0.225.1",
     "@std/fmt": "jsr:@std/fmt@^1.0.1",
     "@std/fs": "jsr:@std/fs@^1.0.2",
-    "diff": "npm:diff@^7.0.0"
+    "diff": "npm:diff@^7.0.0",
+    "analytics": "npm:analytics@0.8.16",
+    "@analytics/google-analytics": "npm:@analytics/google-analytics@1.1.0",
+    "micromatch": "npm:micromatch@4.0.8",
+    "i18next":"npm:i18next@^23.14.0",
+    "oxc-transform": "npm:oxc-transform@^0.63.0"
   }
 }

examples/my-plugin/index.mjs

@@ -1,5 +1,8 @@
 import { start } from "@lonu/stc";
 
+// 导入解析 eta 文件
+import { buildEta } from "@lonu/stc/plugin/common";
+
 // 导入解析方法
 // import { parserDefinition } from "@lonu/stc/plugin/definition";
 // import { parserActions } from '@lonu/stc/plugin/action'
@@ -8,10 +11,33 @@ import { start } from "@lonu/stc";
 const myPlugin = {
   name: "stc:myPlugin",
   lang: "cs",
-  setup(context) {
+  async setup(context) {
+    // template 的文件是伪代码。
+    const template = await buildEta("./template");
+
     console.log(context);
+
     // 类型映射
-    return {};
+    return {
+      unknownType: "",
+      typeMap(func, type) {
+        const _newType =
+          type && func(type, undefined, undefined, pluginSetup) ||
+          pluginSetup.unknownType;
+
+        return {
+          string: "string",
+          integer: "int",
+          boolean: "boolean",
+          array: `List<${_newType}>`,
+          object: "object",
+          file: "File",
+          null: "null",
+          bool: "boolean",
+        };
+      },
+      template,
+    };
   },
 };
 

examples/my-plugin/template/actionImport.eta

@@ -0,0 +1,5 @@
+// using ...
+
+<% if (it.imports.length) { %>
+import '<%= it.importPath %><%= it.typeFileName %>.dart';
+<% } %>

examples/my-plugin/template/actionMethod.eta

@@ -0,0 +1,30 @@
+/// <%= it.description %>
+<% if (it.deprecated) { %>
+@available(*, deprecated, message: "This API is deprecated")
+<% } %>
+public func <%= it.name %>(
+    <% it.parameters.forEach(function(param, index) { %>
+    <%= param.name %>: <%= param.type %><% if (param.optional) { %>?<% } %><% if (index < it.parameters.length - 1) { %>,<% } %>
+    <% }) %>
+) async throws -> <%= it.responseType %> {
+    <% if (it.pathParams && it.pathParams.length > 0) { %>
+    let pathParams: [String: String] = [
+        <% it.pathParams.forEach(function(param, index) { %>
+        "<%= param.name %>": String(<%= param.value %>)<% if (index < it.pathParams.length - 1) { %>,<% } %>
+        <% }) %>
+    ]
+    let parsedUrl = "<%= it.url %>".parsePathParams(pathParams)
+    <% } %>
+    
+    <% if (it.requestBody) { %>
+    let params: [String: Any] = <%= it.requestBody %>
+    <% } %>
+    
+    let config = APIClientConfig(
+        url: <% if (it.pathParams && it.pathParams.length > 0) { %>parsedUrl<% } else { %>"<%= it.url %>"<% } %>,
+        method: "<%= it.method %>"<% if (it.requestBody) { %>,
+        params: params<% } %>
+    )
+    
+    return try await APIClient.shared.request(config, type: <%= it.responseType %>.self)
+}

examples/my-plugin/template/definitionBody.eta

@@ -0,0 +1,7 @@
+/// <%= it.description %>
+public struct <%= it.name %>: Codable {
+    <% it.properties.forEach(function(item) { %>
+    /// <%= item.description %>
+    public let <%= item.name %>: <%= item.type %><% if (item.optional) { %>?<% } %>
+    <% }) %>
+}

examples/my-plugin/template/definitionFooter.eta

@@ -0,0 +1 @@
+// MARK: - End of Models

examples/my-plugin/template/definitionHeader.eta

@@ -0,0 +1 @@
+class <%= it.defName %> {

examples/my-plugin/template/enum.eta

@@ -0,0 +1,4 @@
+/// <%= it.description %>
+enum <%= it.name %> {
+    <%= it.data.map(it.convertValue).join(",\n\t")%>
+}