Using string with space in label() function introduced error in the generated swagger

[Bugslive]

Describe the bug

Following our exchange and your fix in release 7.87.4, I use to swagger-editor from openapi to analyze the generated swagger for property that can be Array or null described by Schema annotation and functions.
In particular, label("string with space") create error in the swagger (last case in code snippet)
Please find in code snippet the different case tested and expected swagger if needed.

To Reproduce

Get the code snippets and inject it in one of your model

Expected behavior

I expect a openapi swagger syntactically correct

Code snippets

// first example: correct without label()
//code
@Schema(
  array()
    .items(
      string()
      .pattern(/[a-zA-Z]{1,20}/)
      .minLength(1)
      .maxLength(20)
    )
    .nullable(true)
    .description("string array")
)
stringArray?: string[] | null;

//openapi swagger => OK
stringArray:
  type: array
  items:
    type: string
    pattern: '[a-zA-Z]{1,20}'
    minLength: 1
    maxLength: 20
  description: string array
  nullable: true

----------------
// second example: introducing label()
//code
@Schema(
  array()
    .items(
      string()
      .pattern(/[a-zA-Z]{1,20}/)
      .minLength(1)
      .maxLength(20)
    )
    .nullable(true)
    .description("string array")
    .label("stringarray")
)
stringArray?: string[] | null;

//openapi swagger => syntactically correct but can be enhanced
stringArray:
  anyOf:          //useless
  - $ref: '#/components/schemas/stringarray'
  nullable: true  //will be ignored

schemas:
  stringarray:
    type: array
    items:
      type: string
      pattern: '[a-zA-Z]{1,20}'
      minLength: 1
      maxLength: 20
    description: string array
    nullable: true

//correct swagger would be:
stringArray:
  - $ref: '#/components/schemas/stringarray'

schemas:
  stringarray:
    type: array
    items:
      type: string
      pattern: '[a-zA-Z]{1,20}'
      minLength: 1
      maxLength: 20
    description: string array
    nullable: true

----------------
// third example: incorrect with label("string with space")
//code
@Schema(
  array()
    .items(
      string()
      .pattern(/[a-zA-Z]{1,20}/)
      .minLength(1)
      .maxLength(20)
     )
    .nullable(true)
    .description("string array")
    .label("string array")
)
stringArray?: string[] | null;

//openapi swagger: Incorrect (the error description is provided by the swagger-editor)
stringArray:
  anyOf:
  - $ref: '#/components/schemas/string array' //Error: should match format "uri-reference", format: uri-reference, $ref values must be RFC3986-compliant percent-encoded URIs
  nullable: true

schemas:
  string array:         //Error: Declaration was declared but never use in the document. Component names can only contain the characters A-Z a-z 0-9 - . _
    type: array
    items:
      type: string
      pattern: '[a-zA-Z]{1,20}'
      minLength: 1
      maxLength: 20
    description: string array
    nullable: true

Repository URL example

No response

OS

macOS

Node version

Node v22.19.0

Library version

v7.87.4

Additional context

Link to openapi swagger editor: https://editor.swagger.io/
I use the official docker image

[Romakita]

Hello @Bugslive

Your are not supposed to write label with a white space. The label is the symbole used in the component path. Please fix your code.

Not sure a fix is necessary for a bad usage

See you

[Bugslive]

Ok for the white space.
Anyway, I'm not going to use the label because I don't want the introduction of the "AnyOf" statement.
It's a bit of a shame for the readability of the swagger.
I close the ticket.
See you.

[github-actions]

🎉 Are you happy?

If you appreciated the support, know that it is free and is carried out on personal time ;)

A support, even a little bit makes a difference for me and continues to bring you answers!

[Romakita]

I realize there is an issue when label + nullable is used. I’ll investigate. Anyof should have two items: the ref and type:null.

[Bugslive]

Hello Romain,
I also confirm that without the @nullable annotation, AJV does not accept request with null, but with this annotation the swagger is broken.
for a model like this:

@Schema(array().items(string()).nullable(true))
  myvar?: string[] | null;

the generated swagger is correct:

myvar:
    type: array
    items:
      type: string
    nullable: true

but if I had the annotation @nullable for AJV, request with null are accepted but the swagger is:

myvar:
   type: array
   items: {}
   nullable: true

[Romakita]

The correct output should be:

{ "oneOf": [{"$ref":""}, {"type": "null"}]  }