…tests

- Add .mocharc.json files to all three OpenAPI 3.2 packages (namespace and both parser adapters)
- Fix media-types tests to use parser integration pattern instead of testing media types object
directly
- Update CLAUDE.md with comprehensive "Creating a New Package" guide covering required files, test
patterns, and common pitfalls
- Update test snapshots for OpenAPI 3.2 packages

The test commands now work correctly:
- apidom-parser-adapter-openapi-json-3-2: 12 tests passing
- apidom-parser-adapter-openapi-yaml-3-2: 11 tests passing
- apidom-ns-openapi-3-2: tests run (implementation bugs need separate fix)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Add comprehensive skill for generating apidom-ls configuration from namespace packages:
- Analyzes namespace structure and parser adapters
- Generates completion.ts for autocomplete suggestions
- Generates documentation.ts for hover documentation
- Generates lint rules for validation (type checking, required fields, allowed fields)
- Updates target-specs.ts and main config files
- Supports both new version creation and existing config updates

The skill automates the entire process of adding IDE support (autocomplete, hover, validation)
for a namespace package, integrating with the /add-namespace and /add-parser-adapter workflow.

Includes:
- 505-line comprehensive skill guide (update-ls-config.md)
- Updated README.md with skill documentation
- Updated SKILL-SUMMARY.md with workflow integration

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Restructure all skills from flat .md files to proper Claude Code skill format:
- Move skills into individual directories with SKILL.md files
- Add YAML frontmatter with metadata (name, description, invocation settings)
- Update README.md with correct skill creation instructions
- Enable proper skill registration and discovery in Claude Code CLI

Skills updated:
- update-ls-config: Language service configuration automation
- add-namespace: Namespace package creation
- add-parser-adapter: Parser adapter package creation

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Add comprehensive language service support for OpenAPI 3.2.0 including:

- Server.name field: completion, documentation, and validation
- MediaType.itemSchema field: completion and type validation
- Example.dataValue and Example.serializedValue fields: completion and allowed fields validation
- Tag.summary, Tag.parent, and Tag.kind fields: completion and validation
- Discriminator.defaultMapping field: completion and allowed fields
- SecurityScheme.oauth2MetadataUrl field: completion and allowed fields

Updates:
- Update Info.summary and License.identifier to target OpenAPI 3.2
- Add version-specific allowed-fields lint rules for OpenAPI 3.2
- Add new error codes for OpenAPI 3.2 specific validations

All new fields include autocomplete suggestions, hover documentation, and linting rules according
to the OpenAPI 3.2.0 specification.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Add complete dereference strategy for OpenAPI 3.2 based on OpenAPI 3.1 implementation. The strategy
handles reference resolution, discriminator mapping, and circular reference detection for OpenAPI
3.2.x documents.

Changes:
- Add OpenAPI3_2DereferenceStrategy with visitor pattern implementation
- Add OpenAPI3_2ResolveStrategy that delegates to dereference strategy
- Add JSON Schema $anchor and URI selectors for OpenAPI 3.2
- Add utility functions for schema resolution
- Register both strategies in saturated configuration
- Add package.json exports for all new strategy modules
- Update apidom-ns-openapi-3-2 tests to use new dereference strategy
- Update test fixtures from OpenAPI 3.1.0 to 3.2.0
- Update test snapshots to reflect OpenAPI 3.2.0 behavior

All 232 tests passing in apidom-ns-openapi-3-2 package.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Update test expectations to include both OpenAPI 3.1 and 3.2 in targetSpecs for the summary field,
which is available in both versions.

The test was failing because after adding OpenAPI 3.2 support, the summary completion item now
correctly includes both 3.1.0 and 3.2.0 in its targetSpecs array.

Changes:
- Import OpenAPI32 constant in test file
- Update summary field targetSpecs to [...OpenAPI31, ...OpenAPI32]

All 177 tests now passing.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

…tion

Updates all test files, fixtures, and snapshots to reference OpenAPI 3.2.0 instead of 3.1.0. This
aligns the test suite with the OpenAPI 3.2 specification while preserving JSON Schema dialect URLs
which remain unchanged between versions.

Changes:
- Updated 51 test files across main tests, element tests, plugin tests, and performance tests
- Updated version strings from '3.1.0' to '3.2.0' throughout test suite
- Updated test descriptions from 'OpenApi 3.1' to 'OpenApi 3.2'
- Updated all snapshot files to reflect version changes
- Preserved JSON Schema dialect URLs (oas/3.1/dialect/base) which are correct for 3.2

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Adds OpenAPI 3.2.0 support to the ApiDOM playground by registering the namespace and parser
adapters for both JSON and YAML formats. This enables users to parse, visualize, and dereference
OpenAPI 3.2 documents in the playground interface.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Implements BundleStrategy for OpenAPI 3.2 documents to enable bundling
multi-file OpenAPI 3.2 specifications into a Compound Document. The strategy
detects OpenAPI 3.2 files by media type or ApiDOM element inspection and
returns the parsed result for bundling.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Add comprehensive test coverage for OpenAPI 3.2.0 bundle and dereference strategies including:
- Reference Object bundle tests with internal/external references
- 26 dereference test scenarios covering circular references, error cases, max depth limits, and
path encoding

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Add missing JSON schema files and validation infrastructure for OpenAPI 3.2:
- Add openapi-schema-32.json (main schema)
- Add openapi-schema-32-dialect.json (Schema Object Dialect)
- Add openapi-schema-32-meta.json (OAS Base Vocabulary)
- Add OpenAPI 3.2 JSON/YAML parser adapters to dependencies
- Integrate OpenAPI 3.2 parsing support in parser factory

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Add language service configuration for the $self field introduced in OpenAPI 3.2:
- Add $self field to completion suggestions
- Add $self field documentation
- Add $self to allowed fields list
- Add type validation lint rule (OPENAPI3_2_OPEN_API_FIELD_SELF_TYPE)
- Add URI reference format validation lint rule
(OPENAPI3_2_OPEN_API_FIELD_SELF_FORMAT_URI_REFERENCE)

The $self field allows documents to define a base URI for resolving relative references.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Update Info element language service configuration for OpenAPI 3.2:
- Add contact and license completion items for OpenAPI 3.2
- Add version completion item for OpenAPI 3.2
- Extend summary lint rule to target both OpenAPI 3.1 and 3.2
- Add allowed-fields-3-2 lint rule for Info element

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Update all element configurations to include OpenAPI 3.2 support:

Completion files updated (16 files):
- operation, path-item, response, responses, encoding, xml
- schema, components, link, server-variable, parameter
- oauth-flows, oauth-flow, request-body, header, reference

Lint rules updated (20 files):
- Extended targetSpecs to include OpenAPI32 for all validation rules
- Updated allowed-fields, type checking, and schema validation rules
- Covers: operation, path-item, response, responses, license
- security-scheme, components, link, parameter, request-body
- header, server-variable, media-type, security-requirement

All changes maintain backward compatibility with OpenAPI 3.0 and 3.1.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Update documentation targetSpecs to include OpenAPI 3.2 support:

Documentation files updated (9 files):
- callback/documentation.ts - Callback object hover docs
- components/documentation.ts - Components container hover docs
- encoding/documentation.ts - Encoding object hover docs
- oauth-flows/documentation.ts - OAuth Flows hover docs
- paths/documentation.ts - Paths container hover docs
- reference/documentation.ts - Reference object hover docs
- responses/documentation.ts - Responses container hover docs
- schema/documentation.ts - Schema object hover docs
- security-requirement/documentation.ts - Security Requirement hover docs

All elements now have complete hover documentation support for OpenAPI 3.2.

Note: 20 other element documentation files already support OpenAPI 3.2
via the OpenAPI3 constant which includes all 3.x versions.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

- Add OpenAPI 3.2 parser adapter imports to utils.ts
- Add namespace detection for OpenAPI 3.2 JSON and YAML documents
- Fix webhooks lint rule to use correct linter function
- Remove invalid $self URI reference lint rule (handled by JSON schema)
- Add comprehensive test suite for OpenAPI 3.2 validation
- Add test fixtures for valid and invalid OpenAPI 3.2 documents

This fixes the issue where OpenAPI 3.2 documents were not being
recognized by the language service, preventing validation from running.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

…3.2.0

Convert sample-spec.yaml from OpenAPI 3.1.0 to 3.2.0 and add all new
features introduced in the 3.2.0 specification:

- Add $self field at root for self-referencing document URI
- Add info.summary for brief API description
- Add server.name to all server definitions
- Enhance tags with new fields:
  - summary: Brief description for each tag
  - parent: Create hierarchical tag organization
  - kind: Classify tags as 'collection' or 'resource'

Created hierarchical tag structure:
  - animals (collection) > pet (resource)
  - store (collection) > order, inventory (resources)
  - user (resource)

This provides a comprehensive example demonstrating all OpenAPI 3.2.0
features for testing and reference.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

…spec

Update test snapshot to reflect the enhanced sample-spec.yaml with all
OpenAPI 3.2.0 features ($self, info.summary, server.name, enhanced tags).

All 11 tests passing.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Add all OpenAPI 3.2.0 features to sample-spec.json:

- Add $self field at root for self-referencing document URI
- Add server.name to all server definitions (3 locations: root, operation, path item)
- Enhance tags with new hierarchical structure:
  - summary: Brief description for each tag
  - parent: Create parent-child relationships
  - kind: Classify as 'collection' or 'resource'

Created tag hierarchy:
  - resources (collection)
    - tag1 (resource, with externalDocs)
    - tag2 (resource)

Updated test snapshot to reflect enhanced sample spec.
All 12 tests passing.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Address 7 more review comments from 2026-02-24:

Visitor pattern improvements:
- WebhooksVisitor: Remove Reference support (OAS 3.2 only accepts Path Item)
- Callback visitor already fixed in previous commit
- AdditionalOperationsVisitor: Remove Reference support (only Operation Objects)
- RequestBody ContentVisitor: Use standard pattern instead of ramda ifElse
- Response ContentVisitor: Use standard pattern instead of ramda ifElse

LS configuration fixes:
- Fix media-types lint to check children (mediaType) not parent element
- Fix query operation lint message to match other operations pattern
- Fix item-schema lint to accept boolean JSON Schema (not reference)

All visitors now consistently use standard arrow function pattern for specPath.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Address 3 more PR review comments from 2026-02-24:

Add prefixEncoding/itemEncoding to MediaType:
- Add to allowed-fields-3-2.ts
- Create prefix-encoding--type.ts (array type check)
- Create item-encoding--type.ts (Encoding Object check)
- Register in lint index

Add deviceAuthorizationUrl to OAuth Flow:
- Already in completion.ts
- Create allowed-fields-3-2.ts with deviceAuthorizationUrl
- Create device-authorization-url--format-uri.ts (URI validation)
- Register in lint index

Add deviceAuthorization to OAuth Flows:
- Already in completion.ts
- Create allowed-fields-3-2.ts with deviceAuthorization
- Create device-authorization--type.ts (OAuth Flow Object check)
- Register in lint index

Added error codes:
- OPENAPI3_2_MEDIA_TYPE_FIELD_PREFIX_ENCODING_TYPE = 7130100
- OPENAPI3_2_MEDIA_TYPE_FIELD_ITEM_ENCODING_TYPE = 7130200
- OPENAPI3_2_OAUTH_FLOW_FIELD_DEVICE_AUTHORIZATION_URL_FORMAT_URI = 7165100
- OPENAPI3_2_OAUTH_FLOWS_FIELD_DEVICE_AUTHORIZATION_TYPE = 7166100

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Address the final 10 PR review comments from 2026-02-24 via parallel agents.

Encoding Object (3 fields added):
- Add encoding, prefixEncoding, itemEncoding to documentation
- Add to completion with proper formats (OBJECT, ARRAY, OBJECT)
- Create allowed-fields for 3.0/3.1 and 3.2 versions
- Create 3 type lint rules (encoding--values-type, prefix-encoding--type,
  item-encoding--type)
- Error codes: 7230100, 7230200, 7230300

Security Scheme (1 field added):
- Add deprecated field to allowed-fields-3-2.ts
- Create deprecated--type.ts (boolean validation)
- Add to completion.ts
- Error code: 7220100

Example Object (1 field added):
- Create serialized-value--type.ts (string validation)
- Already in allowed-fields-3-2.ts
- Error code: 5200500

Discriminator Object (1 field added):
- Create default-mapping--type.ts (string validation)
- Add test fixture and test case
- Error code: 5250300

File consolidations (13 renames):
- Rename files from *-3-1.ts to *-3-1--3-2.ts pattern
- Update targetSpecs to include OpenAPI32
- Objects: Parameter (3 files), Header (3 files), License (1 file),
  Link (1 file), Request Body (1 file), Media Type (1 file),
  Security Scheme (1 file), Server Variable (2 files)
- Total: 13 files renamed, all updated to support both 3.1 and 3.2

Reference Object extensions:
- Update 3 lint files to include OpenAPI32 in targetSpecs
- Files: $ref-3-1--allowed-siblings.ts, description-3-1--type.ts,
  summary-3-1--type.ts
- Reference Object unchanged between 3.1 and 3.2

Total changes:
- 6 new lint rule files created
- 13 files renamed for version consolidation
- 19 files modified (codes, completion, documentation, lint indexes)
- 1 test fixture added
- All builds pass successfully

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Add comprehensive section on "Best Practices for Addressing PR Review
Comments" based on lessons learned from PR #5110.

Key additions:
1. Always fetch ALL comments with pagination (avoid missing comments)
2. Create tracking documents for large reviews (>10 comments)
3. Organize comments by package/category before starting
4. Avoid task duplication by checking existing tasks first
5. Use parallel agents for independent work
6. Commit strategy for large reviews (logical batches)
7. Verification checklist before marking complete
8. Common pitfalls from PR #5110 with solutions

Prevents issues like:
- Missing 20 of 32 comments due to no pagination
- Creating duplicate tasks (#21 and #35 for same work)
- Context switching between packages
- Starting work without complete overview

Follows "measure twice, cut once" principle for efficient PR review
resolution.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Update REMAINING_PR_COMMENTS.md to reflect 100% completion status.

Changes:
- Update header to show COMPLETED status
- Add completion summary with all 5 commits
- Document commit breakdown (12+7+3+10 comments)
- Mark all 32 comments as completed
- Add verification checkmarks

This tracking document served its purpose for organizing and tracking
the 32 PR review comments from 2026-02-24.

Updated test snapshots to reflect that Callback Objects in OpenAPI 3.2
only accept Path Item Objects, not Reference Objects. This aligns with
the specification change where Path Item itself can have $ref field
(handled by dereference strategy), but Callback values are strictly
Path Item Objects.

Changed snapshots:
- Callback element: ReferenceElement -> PathItemElement
- OpenApi3_2 element: ReferenceElement -> PathItemElement in webhooks
- Main refractor: ReferenceElement -> PathItemElement

All 242 tests passing.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

…anges

Updated test snapshot to reflect OpenAPI 3.2 Callback Object changes
where Callback values are strictly Path Item Objects, not Reference
Objects. This change cascades from apidom-ns-openapi-3-2 package.

Changed: ReferenceElement -> PathItemElement in callback webhook

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Consolidate identical lint rules across OpenAPI 3.1 and 3.2 versions
to reduce duplication and improve maintainability.

Changes:
- Info Object: Consolidate allowed-fields rules (3.1 and 3.2 identical)
- License Object: Consolidate identifier-mutually-exclusive rules
  (3.1 and 3.2 identical except error code - using 3.1 code)

Files consolidated:
- info/lint/allowed-fields-3-1.ts + allowed-fields-3-2.ts
  → allowed-fields-3-1--3-2.ts
- license/lint/identifier--mutually-exclusive.ts +
  identifier--mutually-exclusive-3-2.ts
  → identifier--mutually-exclusive-3-1--3-2.ts

Addresses PR #5110 review comments #22 and #23.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Remove the $selfValue-based document identity mechanism from the OAS 3.2
dereference visitor. No other strategy (OAS 3.1, OAS 2.0, AsyncAPI 2/3)
uses self-assigned URI for base URI resolution, making this premature for
an initial support PR.

- Remove isAbsoluteURI helper, $selfValue property and all related logic
  from the dereference visitor; simplify toBaseURI to match OAS 3.1
- Remove isCurrentDocument check from toReference
- Remove extractSelfFromReference method (~40 lines)
- Remove OpenApi3_2Element enter handler (keep leave for discriminator mapping)
- Simplify isInternalReference in all element handlers (drop isFragmentOnly
  and $selfValue checks)
- Remove $self-* test fixtures and test block from reference-object suite;
  retain no-$self and direct-self-circular fixtures
- Replace dead self--type lint with self--format-uri-reference lint;
  fix linterFunction to use existing apilintValidURI

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

… behavior

OAS 3.2 does not define the example override behavior that was present
in OAS 3.1 ("SHALL override" language was removed). Update JSDoc in both
normalize-header-examples and normalize-parameter-examples plugins to
accurately reflect this, noting they are carried over from OAS 3.1
semantics pending proper OAS 3.2 example normalization.

Addresses PR #5110 review comment on normalize-header-examples:16.

…tion logic"

This reverts commit 9660036.

…t check

Align toBaseURI with the OAS 3.1 strategy by using the retrieval URI
directly instead of $selfValue for base URI resolution. Also remove the
isCurrentDocument early-return block from toReference.

The $selfValue field is still stored and used for annotation and
isInternalReference detection, but no longer drives base URI resolution.

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

Remove the isFragmentOnly check and the $selfValue clause from all four
isInternalReference computations in the OAS 3.2 dereference visitor.
The isFragmentOnly check is redundant because toBaseURI already resolves
fragment-only refs to this.reference.uri. Aligns with the OAS 3.1
strategy which uses only url.stripHash(this.reference.uri) === retrievalURI.

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

Files previously named with 3-1 already applied targetSpecs covering both
OpenAPI31 and OpenAPI32; rename to make the scope explicit:

- $ref-3-1--allowed-siblings -> $ref-3-1--3-2--allowed-siblings
- description-3-1--type      -> description-3-1--3-2--type
- summary-3-1--type          -> summary-3-1--3-2--type

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

…apidom-reference

apidom-reference tests use port 8123 for HTTP servers; using the same port in
apidom-ls causes EADDRINUSE when both packages run in parallel under
LERNA_TEST_CONCURRENCY. Switching to port 8124 and updating all fixture URLs
and diagnostic line numbers accordingly.

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>