feat: update pnpm lock and workspace configurations; rename operatePipelineGenerator to generate in CLI and generator modules; enhance JSON source reading in pipeline

Author: hairyf

docs/.config/docs.yaml

@@ -8,7 +8,6 @@ url: 'https://genapi.hairyf.com'
 lang: en
 themeColor: yellow
 landing:
-  heroCode: npx genapi init
   contributors: true
   features:
     - title: Multiple HTTP Clients

docs/.docs/.data/content/contents.sqlite

@@ -2,7 +2,7 @@
    <div
       v-if="highlighted"
       ref="highlightRef"
-      class="p-4 font-mono text-sm leading-relaxed pointer-events-none [&_pre]:!p-3 [&_pre]:!m-0 [&_pre]:!rounded [&_pre]:!bg-transparent [&_pre]:!leading-3"
+      class="p-4 font-mono text-sm leading-relaxed pointer-events-none [&_pre]:!p-3 [&_pre]:!m-0 [&_pre]:!rounded [&_pre]:!bg-transparent [&_pre]:!leading-3 [&_pre]:!whitespace-pre-wrap [&_pre]:break-words"
       v-html="highlighted"
     />
     <div

docs/.docs/components/CodeHighlighter.vue

@@ -25,7 +25,7 @@ Create `genapi.config.ts` or `genapi.config.js` in your project root, then run t
 
 ## Core
 
-### `operatePipelineGenerator(config)`
+### `generate(config)`
 
 Runs the GenAPI pipeline for one or more configs. Resolves pipeline by name (e.g. `swag-axios-ts`), then runs config → original → parser → compiler → generate → dest.
 

packages/core/README.md

@@ -3,7 +3,7 @@ import process from 'node:process'
 import { merge } from '@hairy/utils'
 import { loadConfig } from 'c12'
 import { defineCommand, runMain } from 'citty'
-import { operatePipelineGenerator } from '../generator'
+import { generate } from '../generator'
 import { initCommand } from './init'
 import * as parser from './parser'
 
@@ -19,7 +19,7 @@ const main = defineCommand({
       description: 'The compilation preset used supports npm package (add the prefix genapi -) | local path',
     },
     input: {
-      type: 'string',
+      type: 'positional',
       description: 'The incoming string resolves to a uri or json path.',
     },
     outfile: {
@@ -42,6 +42,7 @@ const main = defineCommand({
     if (isInitCommand) {
       return
     }
+
     const options = {
       preset: args.preset,
       input: args.input,
@@ -65,7 +66,7 @@ const main = defineCommand({
     }
 
     const servers = parser.servers(config)
-    await operatePipelineGenerator(servers)
+    await generate(servers)
   },
 })
 

packages/core/src/cli/index.ts

@@ -6,11 +6,11 @@ import { inPipeline } from '../internal'
 /**
  * Runs the GenAPI pipeline for one or more configs.
  * Resolves pipeline by name (e.g. `swag-axios-ts`), then runs config → original → parser → compiler → generate → dest.
- *
+ *·
  * @param config - Single config or array of configs (e.g. from `servers`)
  * @group Core
  */
-export async function operatePipelineGenerator(config: ApiPipeline.Config | ApiPipeline.Config[]) {
+export async function generate(config: ApiPipeline.Config | ApiPipeline.Config[]) {
   const configs: ApiPipeline.Config[] = Array.isArray(config) ? config : [config]
   const s = spinner()
   s.start('Generate API File...')

packages/core/src/generator/index.ts

@@ -66,11 +66,14 @@ export async function original(configRead: ApiPipeline.ConfigRead) {
   return configRead
 }
 
-function readJsonSource(json: string | Record<string, any>) {
+function readJsonSource(json: string | Record<string, any>): Promise<Record<string, any> | undefined> {
   if (!json)
-    return
+    return Promise.resolve(undefined)
   if (typeof json === 'object')
-    return json
-  else
-    return import(json).then(mod => mod.default)
+    return Promise.resolve(json)
+  const trimmed = String(json).trim()
+  // 内联 JSON 字符串（例如 API 传入的 spec 内容）与文件路径区分：以 { 或 [ 开头则解析为 JSON
+  if (trimmed.startsWith('{') || trimmed.startsWith('['))
+    return Promise.resolve(JSON.parse(json as string) as Record<string, any>)
+  return import(json as string).then(mod => mod.default)
 }

packages/pipeline/src/original/index.ts

@@ -217,6 +217,33 @@ describe('original', () => {
     expect(ofetch).not.toHaveBeenCalled()
   })
 
+  it('reads source from inline json string input', async () => {
+    const jsonSource = {
+      swagger: '2.0',
+      info: { title: 'Example API', version: '1.0.0' },
+      paths: {},
+    }
+    const configRead: ApiPipeline.ConfigRead = {
+      config: { input: '' } as ApiPipeline.Config,
+      inputs: { json: JSON.stringify(jsonSource) },
+      outputs: [],
+      graphs: {
+        comments: [],
+        functions: [],
+        imports: [],
+        interfaces: [],
+        typings: [],
+        variables: [],
+        response: {},
+      },
+    }
+
+    const result = await original(configRead)
+
+    expect(result.source).toEqual(jsonSource)
+    expect(ofetch).not.toHaveBeenCalled()
+  })
+
   it('reads source from json string path input', async () => {
     // This test is skipped because dynamic import() requires actual file system
     // and cannot be easily mocked in the test environment

packages/pipeline/test/original/index.test.ts

@@ -70,3 +70,7 @@ onlyBuiltDependencies:
   - esbuild
   - simple-git-hooks
   - vue-demi
+packageExtensions:
+  undocs:
+    dependencies:
+      ufo: '*'