[nicolasiscoding]

Closes #131

createSigningUrl: optional pageNavigation controls the embedded signing page's page navigation (auto | collapsed | hidden).

const { url } = await TurboSign.createSigningUrl(documentId, {
  recipientId,
  pageNavigation: 'collapsed', // 'auto' (default) | 'collapsed' | 'hidden'
});

• auto (default): sized to the iframe width. The thumbnail rail is open at 1200px and wider, collapsed from 900px to 1199px, and a "Pages" button in the bottom bar under 900px.
• collapsed: the rail starts collapsed at any width. The signer can still expand it.
• hidden: no rail and no "Pages" button.

It works like returnUrl: it applies to that signing URL only, is left out of the body when not set, and does not change the response.

All six SDKs

• JS: pageNavigation?: PageNavigationMode (exported 'auto' | 'collapsed' | 'hidden' union) on CreateSigningUrlRequest and CreateEmbeddedSignatureRequest.
• Python: page_navigation kwarg typed as the exported PageNavigationMode Literal, sent as pageNavigation.
• Go: PageNavigation PageNavigationMode with json:"pageNavigation,omitempty", plus PageNavigationAuto / PageNavigationCollapsed / PageNavigationHidden.
• PHP: PageNavigation backed enum, pageNavigation: named arg (last). fromArray() accepts the string value.
• Java: PageNavigation enum, .pageNavigation(...) builder method. The empty-returnUrl rebuild path copies it too.
• Ruby: page_navigation: kwarg (plain string, like the other TurboSign options), :pageNavigation on create_embedded_signature.
• createEmbeddedSignature forwards it to each signing-url call in all six, like returnUrl.
• Docs: openapi.yaml description, root README embedded-signing section (with each language's name), embed README, Java and PHP createSigningUrl references, PHP CHANGELOG, a commented option in each embedded identity example, parity rule.
• @turbodocx/embed: no code change. It only consumes the URL; the option is set when the URL is minted.

Tests (written first, watched fail, then implemented): body includes pageNavigation when given, omits it when not, createEmbeddedSignature forwards it, and the enum/union holds exactly the three values.
JS 410 passed (tsc --noEmit clean), Python 424 passed, Go go test ./... ok, Java 376 passed, PHP 454 passed (phpstan level 8 clean), Ruby 402 examples, 0 failures.

Notes for release

• The API rejects unknown body keys, so setting pageNavigation against an API version without it returns a 400. Callers who don't set it are unaffected. Publish after the matching API release.
• PHP only: CreateSigningUrlRequest::fromArray() throws ValidationException (InvalidPageNavigation) for a string outside the three values, since the property is enum-typed. The other SDKs leave validation to the API's 400.

🤖 Generated with Claude Code