@kubb/ast 5.0.0-beta.63 → 5.0.0-beta.64
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/{defineMacro-Shz8f6SG.js → defineMacro-B76LsJwO.js} +4 -4
- package/dist/{defineMacro-Shz8f6SG.js.map → defineMacro-B76LsJwO.js.map} +1 -1
- package/dist/{defineMacro-BATi7xoC.d.ts → defineMacro-B7qm3zTd.d.ts} +3 -3
- package/dist/factory-wJLzHeXT.d.ts +27 -0
- package/dist/factory.d.ts +3 -27
- package/dist/factory.js +2 -2
- package/dist/{index-B9cc8MBS.d.ts → index-BKD4drsX.d.ts} +2 -2
- package/dist/index.cjs +54 -2
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.ts +24 -21
- package/dist/index.js +54 -8
- package/dist/index.js.map +1 -1
- package/dist/macros.d.ts +2 -2
- package/dist/macros.js +4 -4
- package/dist/{operationParams-k5CKwSWZ.d.ts → operationParams-ByVfpYr7.d.ts} +3 -3
- package/dist/{refs-BjNDuCBD.js → refs-Dx6U5LoE.js} +3 -3
- package/dist/{refs-BjNDuCBD.js.map → refs-Dx6U5LoE.js.map} +1 -1
- package/dist/{schema-Cbnxmz4b.js → schema-YNbOtTCM.js} +2 -2
- package/dist/{schema-Cbnxmz4b.js.map → schema-YNbOtTCM.js.map} +1 -1
- package/dist/{types-BB_xgRJ3.d.ts → types-BP9BZoq-.d.ts} +8 -8
- package/dist/types.d.ts +5 -5
- package/dist/{utils-DaXkewb1.js → utils-BJi0y-xg.js} +4 -4
- package/dist/{utils-DaXkewb1.js.map → utils-BJi0y-xg.js.map} +1 -1
- package/dist/utils.d.ts +3 -3
- package/dist/utils.js +3 -3
- package/package.json +1 -2
- package/src/constants.ts +0 -150
- package/src/defineMacro.ts +0 -139
- package/src/defineNode.ts +0 -102
- package/src/definePrinter.ts +0 -258
- package/src/dialect.ts +0 -86
- package/src/factory.ts +0 -44
- package/src/guards.ts +0 -28
- package/src/index.ts +0 -13
- package/src/infer.ts +0 -132
- package/src/macros/index.ts +0 -3
- package/src/macros/macroDiscriminatorEnum.ts +0 -50
- package/src/macros/macroEnumName.ts +0 -33
- package/src/macros/macroSimplifyUnion.ts +0 -60
- package/src/nodes/base.ts +0 -49
- package/src/nodes/code.ts +0 -355
- package/src/nodes/content.ts +0 -51
- package/src/nodes/file.ts +0 -380
- package/src/nodes/function.ts +0 -283
- package/src/nodes/index.ts +0 -93
- package/src/nodes/input.ts +0 -144
- package/src/nodes/operation.ts +0 -168
- package/src/nodes/output.ts +0 -49
- package/src/nodes/parameter.ts +0 -71
- package/src/nodes/property.ts +0 -67
- package/src/nodes/requestBody.ts +0 -54
- package/src/nodes/response.ts +0 -173
- package/src/nodes/schema.ts +0 -732
- package/src/optionality.ts +0 -15
- package/src/registry.ts +0 -75
- package/src/signature.ts +0 -207
- package/src/types.ts +0 -8
- package/src/utils/codegen.ts +0 -103
- package/src/utils/extractStringsFromNodes.ts +0 -35
- package/src/utils/fileMerge.ts +0 -183
- package/src/utils/index.ts +0 -11
- package/src/utils/operationParams.ts +0 -353
- package/src/utils/refs.ts +0 -134
- package/src/utils/schemaGraph.ts +0 -177
- package/src/utils/schemaMerge.ts +0 -34
- package/src/utils/schemaTraversal.ts +0 -86
- package/src/utils/strings.ts +0 -139
- package/src/visitor.ts +0 -519
- /package/dist/{chunk-CNktS9qV.js → rolldown-runtime-CNktS9qV.js} +0 -0
package/src/optionality.ts
DELETED
|
@@ -1,15 +0,0 @@
|
|
|
1
|
-
import type { SchemaNode } from './nodes/schema.ts'
|
|
2
|
-
|
|
3
|
-
/**
|
|
4
|
-
* Generic JSON Schema optionality: a non-required field is optional, and a
|
|
5
|
-
* non-required nullable field is nullish.
|
|
6
|
-
*/
|
|
7
|
-
export function optionality(schema: SchemaNode, required: boolean): SchemaNode {
|
|
8
|
-
const nullable = schema.nullable ?? false
|
|
9
|
-
|
|
10
|
-
return {
|
|
11
|
-
...schema,
|
|
12
|
-
optional: !required && !nullable ? true : undefined,
|
|
13
|
-
nullish: !required && nullable ? true : undefined,
|
|
14
|
-
}
|
|
15
|
-
}
|
package/src/registry.ts
DELETED
|
@@ -1,75 +0,0 @@
|
|
|
1
|
-
import type { NodeDef } from './defineNode.ts'
|
|
2
|
-
import { arrowFunctionDef, breakDef, constDef, functionDef, jsxDef, textDef, typeDef } from './nodes/code.ts'
|
|
3
|
-
import { contentDef } from './nodes/content.ts'
|
|
4
|
-
import { exportDef, fileDef, importDef, sourceDef } from './nodes/file.ts'
|
|
5
|
-
import { functionParameterDef, functionParametersDef, indexedAccessTypeDef, objectBindingPatternDef, typeLiteralDef } from './nodes/function.ts'
|
|
6
|
-
import { inputDef } from './nodes/input.ts'
|
|
7
|
-
import { operationDef } from './nodes/operation.ts'
|
|
8
|
-
import { outputDef } from './nodes/output.ts'
|
|
9
|
-
import { parameterDef } from './nodes/parameter.ts'
|
|
10
|
-
import { propertyDef } from './nodes/property.ts'
|
|
11
|
-
import { requestBodyDef } from './nodes/requestBody.ts'
|
|
12
|
-
import { responseDef } from './nodes/response.ts'
|
|
13
|
-
import { schemaDef } from './nodes/schema.ts'
|
|
14
|
-
|
|
15
|
-
// Surface every def from one place so the package barrel re-exports them with `export * from './registry.ts'`.
|
|
16
|
-
// Adding a node means adding its `defineNode` to a `nodes/*.ts` file and listing it in `nodeDefs` below, nothing else.
|
|
17
|
-
export {
|
|
18
|
-
arrowFunctionDef,
|
|
19
|
-
breakDef,
|
|
20
|
-
constDef,
|
|
21
|
-
contentDef,
|
|
22
|
-
exportDef,
|
|
23
|
-
fileDef,
|
|
24
|
-
functionDef,
|
|
25
|
-
functionParameterDef,
|
|
26
|
-
functionParametersDef,
|
|
27
|
-
importDef,
|
|
28
|
-
indexedAccessTypeDef,
|
|
29
|
-
inputDef,
|
|
30
|
-
jsxDef,
|
|
31
|
-
objectBindingPatternDef,
|
|
32
|
-
operationDef,
|
|
33
|
-
outputDef,
|
|
34
|
-
parameterDef,
|
|
35
|
-
propertyDef,
|
|
36
|
-
requestBodyDef,
|
|
37
|
-
responseDef,
|
|
38
|
-
schemaDef,
|
|
39
|
-
sourceDef,
|
|
40
|
-
textDef,
|
|
41
|
-
typeDef,
|
|
42
|
-
typeLiteralDef,
|
|
43
|
-
}
|
|
44
|
-
|
|
45
|
-
/**
|
|
46
|
-
* Every node definition. Adding a node means adding its `defineNode` to one
|
|
47
|
-
* `nodes/*.ts` file and listing it here. The visitor tables in `visitor.ts` derive from it.
|
|
48
|
-
*/
|
|
49
|
-
export const nodeDefs = [
|
|
50
|
-
inputDef,
|
|
51
|
-
outputDef,
|
|
52
|
-
operationDef,
|
|
53
|
-
requestBodyDef,
|
|
54
|
-
contentDef,
|
|
55
|
-
responseDef,
|
|
56
|
-
schemaDef,
|
|
57
|
-
propertyDef,
|
|
58
|
-
parameterDef,
|
|
59
|
-
functionParameterDef,
|
|
60
|
-
functionParametersDef,
|
|
61
|
-
typeLiteralDef,
|
|
62
|
-
indexedAccessTypeDef,
|
|
63
|
-
objectBindingPatternDef,
|
|
64
|
-
constDef,
|
|
65
|
-
typeDef,
|
|
66
|
-
functionDef,
|
|
67
|
-
arrowFunctionDef,
|
|
68
|
-
textDef,
|
|
69
|
-
breakDef,
|
|
70
|
-
jsxDef,
|
|
71
|
-
importDef,
|
|
72
|
-
exportDef,
|
|
73
|
-
sourceDef,
|
|
74
|
-
fileDef,
|
|
75
|
-
] satisfies ReadonlyArray<NodeDef>
|
package/src/signature.ts
DELETED
|
@@ -1,207 +0,0 @@
|
|
|
1
|
-
import { hash } from 'node:crypto'
|
|
2
|
-
import type { SchemaNode } from './nodes/index.ts'
|
|
3
|
-
import { extractRefName } from './utils/index.ts'
|
|
4
|
-
|
|
5
|
-
/**
|
|
6
|
-
* The flags shared by every node kind that affect its type: `primitive`, `format`, `nullable`.
|
|
7
|
-
*/
|
|
8
|
-
function flagsDescriptor(node: SchemaNode): string {
|
|
9
|
-
return `${node.primitive ?? ''};${node.format ?? ''};${node.nullable ? 1 : 0}`
|
|
10
|
-
}
|
|
11
|
-
|
|
12
|
-
function refTargetName(node: Extract<SchemaNode, { type: 'ref' }>): string {
|
|
13
|
-
if (node.ref) return extractRefName(node.ref)
|
|
14
|
-
return node.name ?? ''
|
|
15
|
-
}
|
|
16
|
-
|
|
17
|
-
type ScalarField = { kind: 'scalar'; key: string; prefix: string }
|
|
18
|
-
type BoolField = { kind: 'bool'; key: string; prefix: string }
|
|
19
|
-
type ChildField = { kind: 'child'; key: string; prefix: string }
|
|
20
|
-
type ChildrenField = { kind: 'children'; key: string; prefix: string }
|
|
21
|
-
type ObjectPropsField = { kind: 'objectProps' }
|
|
22
|
-
type AdditionalPropsField = { kind: 'additionalProps' }
|
|
23
|
-
type PatternPropsField = { kind: 'patternProps' }
|
|
24
|
-
type EnumValuesField = { kind: 'enumValues' }
|
|
25
|
-
type RefTargetField = { kind: 'refTarget' }
|
|
26
|
-
|
|
27
|
-
type ShapeField =
|
|
28
|
-
| ScalarField
|
|
29
|
-
| BoolField
|
|
30
|
-
| ChildField
|
|
31
|
-
| ChildrenField
|
|
32
|
-
| ObjectPropsField
|
|
33
|
-
| AdditionalPropsField
|
|
34
|
-
| PatternPropsField
|
|
35
|
-
| EnumValuesField
|
|
36
|
-
| RefTargetField
|
|
37
|
-
|
|
38
|
-
const arrayTupleFields: ReadonlyArray<ShapeField> = [
|
|
39
|
-
{ kind: 'children', key: 'items', prefix: 'i' },
|
|
40
|
-
{ kind: 'child', key: 'rest', prefix: 'r' },
|
|
41
|
-
{ kind: 'scalar', key: 'min', prefix: 'mn' },
|
|
42
|
-
{ kind: 'scalar', key: 'max', prefix: 'mx' },
|
|
43
|
-
{ kind: 'bool', key: 'unique', prefix: 'u' },
|
|
44
|
-
]
|
|
45
|
-
|
|
46
|
-
const numericFields: ReadonlyArray<ShapeField> = [
|
|
47
|
-
{ kind: 'scalar', key: 'min', prefix: 'mn' },
|
|
48
|
-
{ kind: 'scalar', key: 'max', prefix: 'mx' },
|
|
49
|
-
{ kind: 'scalar', key: 'exclusiveMinimum', prefix: 'emn' },
|
|
50
|
-
{ kind: 'scalar', key: 'exclusiveMaximum', prefix: 'emx' },
|
|
51
|
-
{ kind: 'scalar', key: 'multipleOf', prefix: 'mo' },
|
|
52
|
-
]
|
|
53
|
-
|
|
54
|
-
const rangeFields: ReadonlyArray<ShapeField> = [
|
|
55
|
-
{ kind: 'scalar', key: 'min', prefix: 'mn' },
|
|
56
|
-
{ kind: 'scalar', key: 'max', prefix: 'mx' },
|
|
57
|
-
]
|
|
58
|
-
|
|
59
|
-
/**
|
|
60
|
-
* Maps each node `type` to its ordered shape-contributing fields. Types absent from the map
|
|
61
|
-
* (boolean, null, any, and other scalars) fall back to `${type}|${flags}`.
|
|
62
|
-
*/
|
|
63
|
-
const SHAPE_KEYS: Partial<Record<SchemaNode['type'], ReadonlyArray<ShapeField>>> = {
|
|
64
|
-
object: [
|
|
65
|
-
{ kind: 'objectProps' },
|
|
66
|
-
{ kind: 'additionalProps' },
|
|
67
|
-
{ kind: 'patternProps' },
|
|
68
|
-
{ kind: 'scalar', key: 'minProperties', prefix: 'mn' },
|
|
69
|
-
{ kind: 'scalar', key: 'maxProperties', prefix: 'mx' },
|
|
70
|
-
],
|
|
71
|
-
array: arrayTupleFields,
|
|
72
|
-
tuple: arrayTupleFields,
|
|
73
|
-
union: [
|
|
74
|
-
{ kind: 'scalar', key: 'strategy', prefix: 's' },
|
|
75
|
-
{ kind: 'scalar', key: 'discriminatorPropertyName', prefix: 'd' },
|
|
76
|
-
{ kind: 'children', key: 'members', prefix: 'm' },
|
|
77
|
-
],
|
|
78
|
-
intersection: [{ kind: 'children', key: 'members', prefix: 'm' }],
|
|
79
|
-
enum: [{ kind: 'enumValues' }],
|
|
80
|
-
ref: [{ kind: 'refTarget' }],
|
|
81
|
-
string: [
|
|
82
|
-
{ kind: 'scalar', key: 'min', prefix: 'mn' },
|
|
83
|
-
{ kind: 'scalar', key: 'max', prefix: 'mx' },
|
|
84
|
-
{ kind: 'scalar', key: 'pattern', prefix: 'pt' },
|
|
85
|
-
],
|
|
86
|
-
number: numericFields,
|
|
87
|
-
integer: numericFields,
|
|
88
|
-
bigint: numericFields,
|
|
89
|
-
url: [
|
|
90
|
-
{ kind: 'scalar', key: 'path', prefix: 'path' },
|
|
91
|
-
{ kind: 'scalar', key: 'min', prefix: 'mn' },
|
|
92
|
-
{ kind: 'scalar', key: 'max', prefix: 'mx' },
|
|
93
|
-
],
|
|
94
|
-
uuid: rangeFields,
|
|
95
|
-
email: rangeFields,
|
|
96
|
-
datetime: [
|
|
97
|
-
{ kind: 'bool', key: 'offset', prefix: 'o' },
|
|
98
|
-
{ kind: 'bool', key: 'local', prefix: 'l' },
|
|
99
|
-
],
|
|
100
|
-
date: [{ kind: 'scalar', key: 'representation', prefix: 'rep' }],
|
|
101
|
-
time: [{ kind: 'scalar', key: 'representation', prefix: 'rep' }],
|
|
102
|
-
}
|
|
103
|
-
|
|
104
|
-
function serializeShapeField(field: ShapeField, node: SchemaNode, record: Record<string, unknown>): string {
|
|
105
|
-
switch (field.kind) {
|
|
106
|
-
case 'scalar':
|
|
107
|
-
return `${field.prefix}:${record[field.key] ?? ''}`
|
|
108
|
-
case 'bool':
|
|
109
|
-
return `${field.prefix}:${record[field.key] ? 1 : 0}`
|
|
110
|
-
case 'child': {
|
|
111
|
-
const child = record[field.key] as SchemaNode | undefined
|
|
112
|
-
return `${field.prefix}:${child ? signatureOf(child) : ''}`
|
|
113
|
-
}
|
|
114
|
-
case 'children': {
|
|
115
|
-
const children = (record[field.key] as Array<SchemaNode> | undefined) ?? []
|
|
116
|
-
return `${field.prefix}[${children.map((c) => signatureOf(c)).join(',')}]`
|
|
117
|
-
}
|
|
118
|
-
case 'objectProps': {
|
|
119
|
-
const obj = node as Extract<SchemaNode, { type: 'object' }>
|
|
120
|
-
const props = (obj.properties ?? []).map((prop) => `${prop.name}${prop.required ? '!' : '?'}${signatureOf(prop.schema)}`).join(',')
|
|
121
|
-
return `p[${props}]`
|
|
122
|
-
}
|
|
123
|
-
case 'additionalProps': {
|
|
124
|
-
const obj = node as Extract<SchemaNode, { type: 'object' }>
|
|
125
|
-
if (typeof obj.additionalProperties === 'boolean') return `ab:${obj.additionalProperties}`
|
|
126
|
-
if (obj.additionalProperties) return `as:${signatureOf(obj.additionalProperties)}`
|
|
127
|
-
return ''
|
|
128
|
-
}
|
|
129
|
-
case 'patternProps': {
|
|
130
|
-
const obj = node as Extract<SchemaNode, { type: 'object' }>
|
|
131
|
-
const pattern = obj.patternProperties
|
|
132
|
-
? Object.keys(obj.patternProperties)
|
|
133
|
-
.sort()
|
|
134
|
-
.map((key) => `${key}=${signatureOf(obj.patternProperties![key]!)}`)
|
|
135
|
-
.join(',')
|
|
136
|
-
: ''
|
|
137
|
-
return `pp[${pattern}]`
|
|
138
|
-
}
|
|
139
|
-
case 'enumValues': {
|
|
140
|
-
const en = node as Extract<SchemaNode, { type: 'enum' }>
|
|
141
|
-
let values = ''
|
|
142
|
-
if (en.namedEnumValues?.length) {
|
|
143
|
-
values = en.namedEnumValues.map((entry) => `${entry.name}=${entry.primitive}:${String(entry.value)}`).join(',')
|
|
144
|
-
} else if (en.enumValues?.length) {
|
|
145
|
-
values = en.enumValues.map((value) => `${value === null ? 'null' : typeof value}:${String(value)}`).join(',')
|
|
146
|
-
}
|
|
147
|
-
return `v[${values}]`
|
|
148
|
-
}
|
|
149
|
-
case 'refTarget': {
|
|
150
|
-
return `->${refTargetName(node as Extract<SchemaNode, { type: 'ref' }>)}`
|
|
151
|
-
}
|
|
152
|
-
}
|
|
153
|
-
}
|
|
154
|
-
|
|
155
|
-
/**
|
|
156
|
-
* Builds the local shape descriptor that {@link signatureOf} hashes: the node's kind, flags,
|
|
157
|
-
* constraints, and its children's signatures.
|
|
158
|
-
*/
|
|
159
|
-
function describeShape(node: SchemaNode): string {
|
|
160
|
-
const flags = flagsDescriptor(node)
|
|
161
|
-
const fields = SHAPE_KEYS[node.type]
|
|
162
|
-
if (!fields) return `${node.type}|${flags}`
|
|
163
|
-
|
|
164
|
-
const record = node as unknown as Record<string, unknown>
|
|
165
|
-
const parts: Array<string> = [`${node.type}|${flags}`]
|
|
166
|
-
for (const field of fields) {
|
|
167
|
-
parts.push(serializeShapeField(field, node, record))
|
|
168
|
-
}
|
|
169
|
-
return parts.join('|')
|
|
170
|
-
}
|
|
171
|
-
|
|
172
|
-
/**
|
|
173
|
-
* Caches the digest per node, keyed by identity. A `WeakMap` so entries die with the node, and so
|
|
174
|
-
* a tree hashed during dedupe planning is not walked again when it is rewritten during streaming.
|
|
175
|
-
* Reuse is safe because a signature depends only on content, and nodes are immutable once created.
|
|
176
|
-
*/
|
|
177
|
-
const signatureCache = new WeakMap<SchemaNode, string>()
|
|
178
|
-
|
|
179
|
-
/**
|
|
180
|
-
* Computes a deterministic, shape-only signature (a content hash) for a schema node. Two schemas
|
|
181
|
-
* share a signature when they are structurally identical, ignoring documentation (`name`, `title`,
|
|
182
|
-
* `description`, `example`, `default`, `deprecated`) and usage-slot flags (`optional`, `nullish`,
|
|
183
|
-
* `readOnly`, `writeOnly`). `nullable` is kept because it changes the produced type, and `ref`
|
|
184
|
-
* nodes compare by target name, which also terminates on circular shapes.
|
|
185
|
-
*
|
|
186
|
-
* @example Two enums with different descriptions share a signature
|
|
187
|
-
* ```ts
|
|
188
|
-
* signatureOf(createSchema({ type: 'enum', primitive: 'string', enumValues: ['a', 'b'], description: 'x' })) ===
|
|
189
|
-
* signatureOf(createSchema({ type: 'enum', primitive: 'string', enumValues: ['a', 'b'] }))
|
|
190
|
-
* ```
|
|
191
|
-
*/
|
|
192
|
-
export function signatureOf(node: SchemaNode): string {
|
|
193
|
-
const cached = signatureCache.get(node)
|
|
194
|
-
if (cached !== undefined) return cached
|
|
195
|
-
const signature = hash('sha256', describeShape(node), 'hex')
|
|
196
|
-
signatureCache.set(node, signature)
|
|
197
|
-
|
|
198
|
-
return signature
|
|
199
|
-
}
|
|
200
|
-
|
|
201
|
-
/**
|
|
202
|
-
* Returns `true` when two schema nodes are structurally identical under shape-only equality,
|
|
203
|
-
* meaning they produce the same TypeScript type.
|
|
204
|
-
*/
|
|
205
|
-
export function isSchemaEqual(a: SchemaNode, b: SchemaNode): boolean {
|
|
206
|
-
return signatureOf(a) === signatureOf(b)
|
|
207
|
-
}
|
package/src/types.ts
DELETED
|
@@ -1,8 +0,0 @@
|
|
|
1
|
-
export type { Dedupe, Dialect, SchemaDialect } from './dialect.ts'
|
|
2
|
-
export type { DistributiveOmit, NodeDef } from './defineNode.ts'
|
|
3
|
-
export type { InferSchemaNode, ParserOptions } from './infer.ts'
|
|
4
|
-
export type * from './nodes/index.ts'
|
|
5
|
-
export type { ParentOf, Visitor, VisitorContext } from './visitor.ts'
|
|
6
|
-
export type { Printer, PrinterFactoryOptions, PrinterPartial } from './definePrinter.ts'
|
|
7
|
-
export type { OperationParamsResolver } from './utils/operationParams.ts'
|
|
8
|
-
export type { Enforce, Macro } from './defineMacro.ts'
|
package/src/utils/codegen.ts
DELETED
|
@@ -1,103 +0,0 @@
|
|
|
1
|
-
import { isIdentifier, singleQuote } from '@internals/utils'
|
|
2
|
-
import { INDENT } from '../constants.ts'
|
|
3
|
-
|
|
4
|
-
/**
|
|
5
|
-
* Builds a JSDoc comment block from an array of lines. Returns `fallback` when there are no
|
|
6
|
-
* comments.
|
|
7
|
-
*
|
|
8
|
-
* @example
|
|
9
|
-
* ```ts
|
|
10
|
-
* buildJSDoc(['@type string', '@example hello'])
|
|
11
|
-
* // '/**\n * @type string\n * @example hello\n *\/\n '
|
|
12
|
-
* ```
|
|
13
|
-
*/
|
|
14
|
-
export function buildJSDoc(
|
|
15
|
-
comments: Array<string>,
|
|
16
|
-
options: {
|
|
17
|
-
/**
|
|
18
|
-
* String used to indent each comment line.
|
|
19
|
-
* @default ' * '
|
|
20
|
-
*/
|
|
21
|
-
indent?: string
|
|
22
|
-
/**
|
|
23
|
-
* String appended after the closing tag.
|
|
24
|
-
* @default '\n '
|
|
25
|
-
*/
|
|
26
|
-
suffix?: string
|
|
27
|
-
/**
|
|
28
|
-
* Returned as-is when `comments` is empty.
|
|
29
|
-
* @default ' '
|
|
30
|
-
*/
|
|
31
|
-
fallback?: string
|
|
32
|
-
} = {},
|
|
33
|
-
): string {
|
|
34
|
-
const { indent = ' * ', suffix = '\n ', fallback = ' ' } = options
|
|
35
|
-
|
|
36
|
-
if (comments.length === 0) return fallback
|
|
37
|
-
|
|
38
|
-
return `/**\n${comments.map((c) => `${indent}${c}`).join('\n')}\n */${suffix}`
|
|
39
|
-
}
|
|
40
|
-
|
|
41
|
-
/**
|
|
42
|
-
* Indents every non-empty line of `text` by one indent level, leaving blank lines empty.
|
|
43
|
-
*/
|
|
44
|
-
function indentLines(text: string): string {
|
|
45
|
-
if (!text) return ''
|
|
46
|
-
return text
|
|
47
|
-
.split('\n')
|
|
48
|
-
.map((line) => (line.trim() ? `${INDENT}${line}` : ''))
|
|
49
|
-
.join('\n')
|
|
50
|
-
}
|
|
51
|
-
|
|
52
|
-
/**
|
|
53
|
-
* Renders an object key, quoting it with single quotes only when it is not a valid identifier.
|
|
54
|
-
* Reserved words and globals (`name`, `class`, …) are valid bare keys and stay unquoted.
|
|
55
|
-
*
|
|
56
|
-
* @example
|
|
57
|
-
* ```ts
|
|
58
|
-
* objectKey('name') // 'name'
|
|
59
|
-
* objectKey('x-total') // "'x-total'"
|
|
60
|
-
* ```
|
|
61
|
-
*/
|
|
62
|
-
export function objectKey(name: string): string {
|
|
63
|
-
return isIdentifier(name) ? name : singleQuote(name)
|
|
64
|
-
}
|
|
65
|
-
|
|
66
|
-
/**
|
|
67
|
-
* Assembles a multi-line object literal from already-rendered `entries`, indenting each entry one
|
|
68
|
-
* level and closing the brace at column zero. Entries that are themselves multi-line objects indent
|
|
69
|
-
* cumulatively. Each entry ends with a trailing comma to match the formatter's multi-line style.
|
|
70
|
-
*
|
|
71
|
-
* @example
|
|
72
|
-
* ```ts
|
|
73
|
-
* buildObject(['id: z.number()', 'name: z.string()'])
|
|
74
|
-
* // '{\n id: z.number(),\n name: z.string(),\n}'
|
|
75
|
-
* ```
|
|
76
|
-
*/
|
|
77
|
-
export function buildObject(entries: Array<string>): string {
|
|
78
|
-
if (entries.length === 0) return '{}'
|
|
79
|
-
const body = entries.map((entry) => `${indentLines(entry)},`).join('\n')
|
|
80
|
-
|
|
81
|
-
return `{\n${body}\n}`
|
|
82
|
-
}
|
|
83
|
-
|
|
84
|
-
/**
|
|
85
|
-
* Assembles a bracketed list (array by default) from already-rendered `items`. Keeps everything on
|
|
86
|
-
* one line when no item spans multiple lines, and otherwise puts each item on its own line, indented
|
|
87
|
-
* one level with a trailing comma and the closing bracket at column zero. Used for member lists such
|
|
88
|
-
* as `z.union([…])` and `z.array([…])`.
|
|
89
|
-
*
|
|
90
|
-
* @example
|
|
91
|
-
* ```ts
|
|
92
|
-
* buildList(['z.string()', 'z.number()'])
|
|
93
|
-
* // '[z.string(), z.number()]'
|
|
94
|
-
* ```
|
|
95
|
-
*/
|
|
96
|
-
export function buildList(items: Array<string>, brackets: [open: string, close: string] = ['[', ']']): string {
|
|
97
|
-
const [open, close] = brackets
|
|
98
|
-
if (items.length === 0) return `${open}${close}`
|
|
99
|
-
if (!items.some((item) => item.includes('\n'))) return `${open}${items.join(', ')}${close}`
|
|
100
|
-
const body = items.map((item) => `${indentLines(item)},`).join('\n')
|
|
101
|
-
|
|
102
|
-
return `${open}\n${body}\n${close}`
|
|
103
|
-
}
|
|
@@ -1,35 +0,0 @@
|
|
|
1
|
-
import type { CodeNode } from '../nodes/code.ts'
|
|
2
|
-
|
|
3
|
-
/**
|
|
4
|
-
* Extracts all string content from a `CodeNode` tree recursively.
|
|
5
|
-
*
|
|
6
|
-
* Collects text node values, identifier references in string fields (`params`, `generics`, `returnType`, `type`),
|
|
7
|
-
* and nested node content. Used to build the full source string for import filtering.
|
|
8
|
-
*/
|
|
9
|
-
export function extractStringsFromNodes(nodes: Array<CodeNode> | undefined): string {
|
|
10
|
-
if (!nodes?.length) return ''
|
|
11
|
-
|
|
12
|
-
return nodes
|
|
13
|
-
.map((node) => {
|
|
14
|
-
// Backward-compat: compiled plugins may still pass bare strings at runtime
|
|
15
|
-
if (typeof node === 'string') return node as string
|
|
16
|
-
if (node.kind === 'Text') return node.value
|
|
17
|
-
if (node.kind === 'Break') return ''
|
|
18
|
-
if (node.kind === 'Jsx') return node.value
|
|
19
|
-
|
|
20
|
-
const parts: Array<string> = []
|
|
21
|
-
|
|
22
|
-
if ('params' in node && node.params) parts.push(node.params)
|
|
23
|
-
if ('generics' in node && node.generics) parts.push(Array.isArray(node.generics) ? node.generics.join(', ') : node.generics)
|
|
24
|
-
if ('returnType' in node && node.returnType) parts.push(node.returnType)
|
|
25
|
-
if ('type' in node && typeof node.type === 'string') parts.push(node.type)
|
|
26
|
-
|
|
27
|
-
const nested = extractStringsFromNodes(node.nodes)
|
|
28
|
-
|
|
29
|
-
if (nested) parts.push(nested)
|
|
30
|
-
|
|
31
|
-
return parts.join('\n')
|
|
32
|
-
})
|
|
33
|
-
.filter(Boolean)
|
|
34
|
-
.join('\n')
|
|
35
|
-
}
|
package/src/utils/fileMerge.ts
DELETED
|
@@ -1,183 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* File-member merging. `combineImports` and `combineExports` deduplicate and sort the import and
|
|
3
|
-
* export entries of one file, while `combineSources` deduplicates source entries in original order.
|
|
4
|
-
* `combineImports` also drops imports nothing references. This works on a file's members, not on
|
|
5
|
-
* schema content.
|
|
6
|
-
*/
|
|
7
|
-
import type { ExportNode, ImportNode, SourceNode } from '../nodes/index.ts'
|
|
8
|
-
import { extractStringsFromNodes } from './extractStringsFromNodes.ts'
|
|
9
|
-
|
|
10
|
-
function sourceKey(source: SourceNode): string {
|
|
11
|
-
const nameKey = source.name ?? extractStringsFromNodes(source.nodes)
|
|
12
|
-
return `${nameKey}:${source.isExportable ?? false}:${source.isTypeOnly ?? false}`
|
|
13
|
-
}
|
|
14
|
-
|
|
15
|
-
function pathTypeKey(path: string, isTypeOnly: boolean | null | undefined): string {
|
|
16
|
-
return `${path}:${isTypeOnly ?? false}`
|
|
17
|
-
}
|
|
18
|
-
|
|
19
|
-
function exportKey(path: string, name: string | null | undefined, isTypeOnly: boolean | null | undefined, asAlias: boolean | null | undefined): string {
|
|
20
|
-
return `${path}:${name ?? ''}:${isTypeOnly ?? false}:${asAlias ?? ''}`
|
|
21
|
-
}
|
|
22
|
-
|
|
23
|
-
function importKey(path: string, name: string | null | undefined, isTypeOnly: boolean | null | undefined): string {
|
|
24
|
-
return `${path}:${name ?? ''}:${isTypeOnly ?? false}`
|
|
25
|
-
}
|
|
26
|
-
|
|
27
|
-
/**
|
|
28
|
-
* Computes a multi-level sort key for exports and imports:
|
|
29
|
-
* non-array names first (wildcards/namespace aliases). Type-only before value. Alphabetical path. Unnamed before named.
|
|
30
|
-
*/
|
|
31
|
-
function sortKey(node: { name?: string | Array<unknown> | null; isTypeOnly?: boolean | null; path: string }): string {
|
|
32
|
-
const isArray = Array.isArray(node.name) ? '1' : '0'
|
|
33
|
-
const typeOnly = node.isTypeOnly ? '0' : '1'
|
|
34
|
-
const hasName = node.name != null ? '1' : '0'
|
|
35
|
-
const name = Array.isArray(node.name) ? node.name.toSorted().join('\0') : (node.name ?? '')
|
|
36
|
-
return `${isArray}:${typeOnly}:${node.path}:${hasName}:${name}`
|
|
37
|
-
}
|
|
38
|
-
|
|
39
|
-
/**
|
|
40
|
-
* Deduplicates `SourceNode` objects by `name + isExportable + isTypeOnly`, keeping the first of each
|
|
41
|
-
* key. Unnamed sources fall back to their extracted node strings as the name part of the key. Returns
|
|
42
|
-
* the deduplicated array in original order.
|
|
43
|
-
*/
|
|
44
|
-
export function combineSources(sources: Array<SourceNode>): Array<SourceNode> {
|
|
45
|
-
const seen = new Map<string, SourceNode>()
|
|
46
|
-
for (const source of sources) {
|
|
47
|
-
const key = sourceKey(source)
|
|
48
|
-
if (!seen.has(key)) seen.set(key, source)
|
|
49
|
-
}
|
|
50
|
-
return [...seen.values()]
|
|
51
|
-
}
|
|
52
|
-
|
|
53
|
-
/**
|
|
54
|
-
* Merges `incoming` names into `existing`, preserving order and dropping duplicates.
|
|
55
|
-
*
|
|
56
|
-
* Shared by `combineExports` and `combineImports` for the same-path name-merge case.
|
|
57
|
-
*/
|
|
58
|
-
function mergeNameArrays<TName>(existing: Array<TName>, incoming: Array<TName>): Array<TName> {
|
|
59
|
-
const merged = new Set(existing)
|
|
60
|
-
for (const name of incoming) merged.add(name)
|
|
61
|
-
return [...merged]
|
|
62
|
-
}
|
|
63
|
-
|
|
64
|
-
/**
|
|
65
|
-
* Deduplicates and merges `ExportNode` objects by path and type.
|
|
66
|
-
*
|
|
67
|
-
* Named exports with the same path and `isTypeOnly` flag have their names merged into a single export.
|
|
68
|
-
* Non-array exports are deduplicated by exact identity. Returns a sorted, deduplicated array.
|
|
69
|
-
*/
|
|
70
|
-
export function combineExports(exports: Array<ExportNode>): Array<ExportNode> {
|
|
71
|
-
const result: Array<ExportNode> = []
|
|
72
|
-
// Accumulates array-named exports keyed by `path:isTypeOnly` for name-merging
|
|
73
|
-
const namedByPath = new Map<string, ExportNode>()
|
|
74
|
-
// Deduplicates non-array exports by their exact identity
|
|
75
|
-
const seen = new Set<string>()
|
|
76
|
-
|
|
77
|
-
// Precompute sort keys once, avoids recomputing per comparison.
|
|
78
|
-
const keyed = exports.map((node) => ({ node, key: sortKey(node) }))
|
|
79
|
-
keyed.sort((a, b) => (a.key < b.key ? -1 : a.key > b.key ? 1 : 0))
|
|
80
|
-
|
|
81
|
-
for (const { node: curr } of keyed) {
|
|
82
|
-
const { name, path, isTypeOnly, asAlias } = curr
|
|
83
|
-
|
|
84
|
-
if (Array.isArray(name)) {
|
|
85
|
-
if (!name.length) continue
|
|
86
|
-
|
|
87
|
-
const key = pathTypeKey(path, isTypeOnly)
|
|
88
|
-
const existing = namedByPath.get(key)
|
|
89
|
-
|
|
90
|
-
if (existing && Array.isArray(existing.name)) {
|
|
91
|
-
existing.name = mergeNameArrays(existing.name, name)
|
|
92
|
-
} else {
|
|
93
|
-
const newItem: ExportNode = { ...curr, name: [...new Set(name)] }
|
|
94
|
-
result.push(newItem)
|
|
95
|
-
namedByPath.set(key, newItem)
|
|
96
|
-
}
|
|
97
|
-
} else {
|
|
98
|
-
const key = exportKey(path, name, isTypeOnly, asAlias)
|
|
99
|
-
if (!seen.has(key)) {
|
|
100
|
-
result.push(curr)
|
|
101
|
-
seen.add(key)
|
|
102
|
-
}
|
|
103
|
-
}
|
|
104
|
-
}
|
|
105
|
-
|
|
106
|
-
return result
|
|
107
|
-
}
|
|
108
|
-
|
|
109
|
-
/**
|
|
110
|
-
* Deduplicates and merges `ImportNode` objects, filtering out unused imports.
|
|
111
|
-
*
|
|
112
|
-
* Retains imports that are referenced in `source` or re-exported. Imports with the same path and
|
|
113
|
-
* `isTypeOnly` flag have their names merged. Returns a sorted, deduplicated, filtered array.
|
|
114
|
-
*/
|
|
115
|
-
export function combineImports(imports: Array<ImportNode>, exports: Array<ExportNode>, source?: string): Array<ImportNode> {
|
|
116
|
-
// Build a lookup of all exported names to retain imports that are re-exported
|
|
117
|
-
const exportedNames = new Set(exports.flatMap((e) => (Array.isArray(e.name) ? e.name : e.name ? [e.name] : [])))
|
|
118
|
-
const isUsed = (importName: string): boolean => !source || source.includes(importName) || exportedNames.has(importName)
|
|
119
|
-
|
|
120
|
-
// Memoize object import names so the same logical (propertyName, name) pair always
|
|
121
|
-
// reuses the same object reference. Set-based deduplication then works correctly.
|
|
122
|
-
const importNameMemo = new Map<string, { propertyName: string; name?: string }>()
|
|
123
|
-
const canonicalizeName = (n: string | { propertyName: string; name?: string }): string | { propertyName: string; name?: string } => {
|
|
124
|
-
if (typeof n === 'string') return n
|
|
125
|
-
const key = `${n.propertyName}:${n.name ?? ''}`
|
|
126
|
-
if (!importNameMemo.has(key)) importNameMemo.set(key, n)
|
|
127
|
-
return importNameMemo.get(key)!
|
|
128
|
-
}
|
|
129
|
-
|
|
130
|
-
// Paths that keep at least one used named import. A default import from such a path is retained
|
|
131
|
-
// even when its binding can't be found in `source` e.g. a generated `client` default import
|
|
132
|
-
// alongside `import type { Client } from <same path>`, where merged grouped output omits the body.
|
|
133
|
-
const pathsWithUsedNamedImport = new Set<string>()
|
|
134
|
-
for (const node of imports) {
|
|
135
|
-
if (!Array.isArray(node.name)) continue
|
|
136
|
-
if (node.name.some((item) => (typeof item === 'string' ? isUsed(item) : isUsed(item.name ?? item.propertyName)))) {
|
|
137
|
-
pathsWithUsedNamedImport.add(node.path)
|
|
138
|
-
}
|
|
139
|
-
}
|
|
140
|
-
|
|
141
|
-
const result: Array<ImportNode> = []
|
|
142
|
-
// Accumulates array-named imports keyed by `path:isTypeOnly` for name-merging
|
|
143
|
-
const namedByPath = new Map<string, ImportNode>()
|
|
144
|
-
// Deduplicates non-array imports by their exact identity
|
|
145
|
-
const seen = new Set<string>()
|
|
146
|
-
|
|
147
|
-
// Precompute sort keys once, avoids recomputing per comparison.
|
|
148
|
-
const keyed = imports.map((node) => ({ node, key: sortKey(node) }))
|
|
149
|
-
keyed.sort((a, b) => (a.key < b.key ? -1 : a.key > b.key ? 1 : 0))
|
|
150
|
-
|
|
151
|
-
for (const { node: curr } of keyed) {
|
|
152
|
-
if (curr.path === curr.root) continue
|
|
153
|
-
|
|
154
|
-
const { path, isTypeOnly } = curr
|
|
155
|
-
let { name } = curr
|
|
156
|
-
|
|
157
|
-
if (Array.isArray(name)) {
|
|
158
|
-
name = [...new Set(name.map(canonicalizeName))].filter((item) => (typeof item === 'string' ? isUsed(item) : isUsed(item.name ?? item.propertyName)))
|
|
159
|
-
if (!name.length) continue
|
|
160
|
-
|
|
161
|
-
const key = pathTypeKey(path, isTypeOnly)
|
|
162
|
-
const existing = namedByPath.get(key)
|
|
163
|
-
|
|
164
|
-
if (existing && Array.isArray(existing.name)) {
|
|
165
|
-
existing.name = mergeNameArrays(existing.name, name)
|
|
166
|
-
} else {
|
|
167
|
-
const newItem: ImportNode = { ...curr, name }
|
|
168
|
-
result.push(newItem)
|
|
169
|
-
namedByPath.set(key, newItem)
|
|
170
|
-
}
|
|
171
|
-
} else {
|
|
172
|
-
if (name && !isUsed(name) && !pathsWithUsedNamedImport.has(path)) continue
|
|
173
|
-
|
|
174
|
-
const key = importKey(path, name, isTypeOnly)
|
|
175
|
-
if (!seen.has(key)) {
|
|
176
|
-
result.push(curr)
|
|
177
|
-
seen.add(key)
|
|
178
|
-
}
|
|
179
|
-
}
|
|
180
|
-
}
|
|
181
|
-
|
|
182
|
-
return result
|
|
183
|
-
}
|
package/src/utils/index.ts
DELETED
|
@@ -1,11 +0,0 @@
|
|
|
1
|
-
export { isValidVarName } from '@internals/utils'
|
|
2
|
-
export { buildJSDoc, buildList, buildObject, objectKey } from './codegen.ts'
|
|
3
|
-
export { extractStringsFromNodes } from './extractStringsFromNodes.ts'
|
|
4
|
-
export { childName, enumPropName, extractRefName, isStringType, resolveGroupType, resolveRefName, syncSchemaRef } from './refs.ts'
|
|
5
|
-
export { mergeAdjacentObjectsLazy } from './schemaMerge.ts'
|
|
6
|
-
export { getNestedAccessor, jsStringEscape, stringify, stringifyObject, toRegExpString, trimQuotes } from './strings.ts'
|
|
7
|
-
export { collectUsedSchemaNames, containsCircularRef, findCircularSchemas } from './schemaGraph.ts'
|
|
8
|
-
export { lazyGetter, mapSchemaItems, mapSchemaMembers, mapSchemaProperties } from './schemaTraversal.ts'
|
|
9
|
-
export type { MappedProperty, MappedSchema, SchemaTransform } from './schemaTraversal.ts'
|
|
10
|
-
export { buildGroupParam, buildTypeLiteral, caseParams, createOperationParams, resolveParamType } from './operationParams.ts'
|
|
11
|
-
export type { BuildGroupArgs, ParamGroupType } from './operationParams.ts'
|