@kubb/parser-ts 5.0.0-beta.5 → 5.0.0-beta.50

package/extension.yaml

@@ -2,7 +2,7 @@ $schema: https://kubb.dev/schemas/extension.json
 kind: parser
 id: parser-ts
 name: TypeScript
-description: TypeScript and TSX file parser for Kubb. Converts the universal AST to `.ts`/`.tsx` source code using the official TypeScript compiler.
+description: Default file parser for Kubb. Converts the universal AST to `.ts`/`.tsx` source using the official TypeScript compiler.
 category: typescript
 type: official
 npmPackage: '@kubb/parser-ts'
@@ -29,23 +29,21 @@ featured: true
 icon:
   light: https://kubb.dev/feature/typescript.svg
 intro: |-
-  The TypeScript parser is the default file parser used by Kubb when no `parsers` option is set in `defineConfig`. It converts Kubb's universal AST into `.ts` and `.tsx` source code using the official [TypeScript compiler](https://www.typescriptlang.org/).
+  `@kubb/parser-ts` takes the `FileNode` staged by your plugins and prints it as TypeScript source using the official [TypeScript compiler](https://www.typescriptlang.org/). It resolves import paths, deduplicates declarations, prints JSDoc, and rewrites extensions based on `output.extension`.
 
-  Two parser instances are exported:
+  Two parsers are exported:
 
-  - `parserTs` — handles `.ts` and `.js` files
-  - `parserTsx` — handles `.tsx` and `.jsx` files
-
-  Both are configured globally in `defineConfig` and apply to every file produced by every plugin.
+  - `parserTs` — handles `.ts` and `.js` files.
+  - `parserTsx` — handles `.tsx` and `.jsx` files. Use this for React projects so JSX in generated components is preserved.
 options:
   - name: extname
     type: "'.ts' | '.js' | '.tsx' | '.jsx' | string"
     required: false
     default: "'.ts'"
     description: |-
-      File extension used when rewriting relative import paths. Set to `.js` for ESM-friendly emit, `.tsx` for React projects, or leave unset to keep TypeScript's default behaviour.
+      Controls which extension is written into the generated import specifiers. Set `.js` for ESM-compatible output, `.tsx` for React projects. Leave unset for the TypeScript default.
 
-      Extension rewriting is configured via `output.extension` in `defineConfig`, not as a parser argument.
+      To rewrite extensions in the generated source (e.g. `./foo` → `./foo.js`), use `output.extension` in `defineConfig`, not this option.
     codeBlock:
       lang: typescript
       title: kubb.config.ts
@@ -56,10 +54,11 @@ options:
         import { parserTs } from '@kubb/parser-ts'
 
         export default defineConfig({
-          input: { path: './petstore.yaml' },
+          input: { path: './petStore.yaml' },
           output: { path: './src/gen', extension: { '.ts': '.js' } },
           adapter: adapterOas(),
           parsers: [parserTs],
+          plugins: [],
         })
 examples:
   - name: TypeScript (default)
@@ -73,10 +72,11 @@ examples:
           import { parserTs } from '@kubb/parser-ts'
 
           export default defineConfig({
-            input: { path: './petstore.yaml' },
+            input: { path: './petStore.yaml' },
             output: { path: './src/gen' },
             adapter: adapterOas(),
             parsers: [parserTs],
+            plugins: [],
           })
   - name: TSX (React)
     files:
@@ -89,12 +89,13 @@ examples:
           import { parserTsx } from '@kubb/parser-ts'
 
           export default defineConfig({
-            input: { path: './petstore.yaml' },
+            input: { path: './petStore.yaml' },
             output: { path: './src/gen' },
             adapter: adapterOas(),
             parsers: [parserTsx],
+            plugins: [],
           })
 notes:
   - type: tip
     body: |-
-      `parser-ts` is bundled with Kubb and used automatically when no `parsers` option is provided. You only need to install it explicitly when combining it with other parsers or providing a fully custom parsers list.
+      `@kubb/parser-ts` is bundled with Kubb and used automatically when no `parsers` option is set. Install it explicitly only when combining it with other parsers or providing a fully custom parser list.

package/package.json

@@ -1,9 +1,8 @@
 {
   "name": "@kubb/parser-ts",
-  "version": "5.0.0-beta.5",
-  "description": "TypeScript and TSX file parser for Kubb, converting generated files to strings using the TypeScript compiler.",
+  "version": "5.0.0-beta.50",
+  "description": "TypeScript and TSX source file parser for Kubb. Converts AST nodes and raw TypeScript code into formatted source strings using the TypeScript compiler API.",
   "keywords": [
-    "code-generator",
     "codegen",
     "kubb",
     "parser",
@@ -43,22 +42,23 @@
   },
   "dependencies": {
     "typescript": "^6.0.3",
-    "@kubb/core": "5.0.0-beta.5"
+    "@kubb/core": "5.0.0-beta.50"
   },
   "devDependencies": {
     "@internals/utils": "0.0.0",
-    "@kubb/ast": "5.0.0-beta.5"
+    "@kubb/ast": "5.0.0-beta.50"
   },
   "engines": {
     "node": ">=22"
   },
   "scripts": {
     "build": "tsdown",
-    "clean": "npx rimraf ./dist",
+    "clean": "node -e \"require('node:fs').rmSync('./dist', {recursive:true,force:true})\"",
     "lint": "oxlint .",
     "lint:fix": "oxlint --fix .",
     "release": "pnpm publish --no-git-check",
     "release:canary": "bash ../../.github/canary.sh && node ../../scripts/build.js canary && pnpm publish --no-git-check",
+    "release:stage": "pnpm stage publish --no-git-check",
     "start": "tsdown --watch",
     "test": "vitest --passWithNoTests",
     "typecheck": "tsc -p ./tsconfig.json --noEmit --emitDeclarationOnly false"

package/src/constants.ts

@@ -1,8 +1,18 @@
 /**
- * Number of spaces used to indent a nested block when pretty-printing.
+ * Character used for a single indent step. Set to `'\t'` to emit tab-indented output.
+ */
+export const INDENT_CHAR = ' '
+
+/**
+ * Number of {@link INDENT_CHAR} repeats that make up one nesting level.
  */
 export const INDENT_SIZE = 2 as const
 
+/**
+ * Indentation unit prepended once per nesting level when pretty-printing.
+ */
+export const INDENT = INDENT_CHAR.repeat(INDENT_SIZE)
+
 /**
  * Matches the trailing `.<ext>` segment of a path (keeps segments like `foo.bar.ts`
  * intact by only trimming the last run of non-`/`/`.` characters).
@@ -15,23 +25,23 @@ export const FILE_EXTENSION_PATTERN = /\.[^/.]+$/
 export const WINDOWS_PATH_SEPARATOR = /\\/g
 
 /**
- * Matches `*\/` in free-form text so JSDoc bodies can neutralise premature
+ * Matches `*\/` in free-form text so JSDoc bodies can neutralize premature
  * comment terminators (`*\/` → `* /`).
  */
 export const JSDOC_TERMINATOR_PATTERN = /\*\//g
 
 /**
- * Matches carriage returns for normalising CRLF/CR line endings to LF.
+ * Matches carriage returns for normalizing CRLF/CR line endings to LF.
  */
 export const CARRIAGE_RETURN_PATTERN = /\r/g
 
 /**
- * Matches CRLF sequences used when normalising TypeScript printer output.
+ * Matches CRLF sequences used when normalizing TypeScript printer output.
  */
 export const CRLF_PATTERN = /\r\n/g
 
 /**
- * Matches an identifier that starts with a digit — JavaScript disallows this
+ * Matches an identifier that starts with a digit. JavaScript disallows this,
  * so the printer prefixes such names with `_`.
  */
 export const LEADING_DIGIT_PATTERN = /^\d/

package/src/index.ts

@@ -1,2 +1,2 @@
-export { createExport, createImport, parserTs, print, safePrint, validateNodes } from './parserTs.ts'
+export { parserTs } from './parserTs.ts'
 export { parserTsx } from './parserTsx.ts'