@W-23748890 feat(query): add QUERY method color badge (OAS 3.2) - #100
Draft
alexpmule wants to merge 4 commits into
Draft
@W-23748890 feat(query): add QUERY method color badge (OAS 3.2)#100alexpmule wants to merge 4 commits into
alexpmule wants to merge 4 commits into
Conversation
alexpmule
force-pushed
the
W-23748890-query-badge
branch
from
August 18, 2026 22:17
2b05db4 to
2bfe82e
Compare
OAS 3.2 introduces the QUERY HTTP method, which the archived http-method-label package does not map, so QUERY operations rendered in the default gray, indistinguishable from unmapped verbs. Add a local color override for the QUERY method label. ApiUrl upper-cases the method for display and lower-cases it for the color hook, so the badge shows QUERY while data-method is 'query'; the rule keys on both casings. Teal (#0f9d9d) is read-safe and does not collide with the PATCH purple. W-23748890
OAS 3.2 introduces the COPY and MOVE HTTP methods alongside QUERY. The http-method-label palette has no entry for them, so they fall back to the default gray. Add customizable color hooks matching the QUERY approach: COPY renders indigo, MOVE renders amber. Both are exposed as CSS custom properties (--http-method-label-copy/move-color and -background-color) with sensible fallbacks, and both raw (uppercase) and lower-cased data-method casings are keyed so navigation and documentation views agree. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…el, bump generator to 0.4.0 Bump @api-components/api-model-generator ^0.2.14 -> ^0.4.0 (amf-client-js 5.11 supports OAS 3.1/3.2) and the amf-helper-mixin floor ^4.5.31 -> ^4.5.38. The regenerated 5.11 models wrap custom domain extensions (the x-agent extension on agents-api) in a single-element array; the agent resolver only navigates that shape from 4.5.38+, where _computeNodeAgent uses _findCustomDomainPropertyByKey instead of scanning for an inline amf://id# key. Add a real OAS 3.2 demo spec exercising the QUERY method and register it so prepare generates its model. Make test/amf-loader.js @graph-aware (amf-client-js 5.11 emits flattened @graph models; expand once at load time) and drive the QUERY method-label test from the generated model instead of hand-building AMF. COPY/MOVE stay inline with a comment: AMF 5.11 does not parse copy/move from an OAS 3.2 pathItem. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
alexpmule
force-pushed
the
W-23748890-query-badge
branch
from
August 20, 2026 17:56
b5d9dcc to
7eab8b4
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
@W-23748890
What
Adds a color badge for the OAS 3.2
QUERYHTTP method.@api-components/http-method-labelmaps the classic verbs (get/post/put/delete/patch/…) plus publish/subscribe, but has no entry forquery— so QUERY endpoints fall through to the gray--method-label-default-color. This adds a local CSS override (teal#0F9D9D) keyed on bothdata-method='query'anddata-method='QUERY', mirroring the existing publish/subscribe local-override precedent.Both casings are covered on purpose: AMF emits
apiContract#method="QUERY"(uppercase) verbatim, which api-navigation and api-summary render raw, while api-method-documentation lowercases it viaApiUrl.js.Why
TD-0333486 — OAS 3.1/3.2 support in API Console v6. AC2: new OAS 3.2 methods must be legible/distinguishable in the console.
Color
Teal / cyan
#0F9D9D(bgrgba(15,157,157,0.12)). Read-safe and does not collide with PATCH (purple), GET (green) or POST (blue).Tests
Green in chromium + firefox. Inline AMF expanded-model fixtures (generator-independent): renders
data-method, not lowercased/uppercased incorrectly,_isGrpcfalse.Related
Coordinate with Ale Loose's OAS 3.2
operationKindgrouping (PR #907) at merge — both touch OAS 3.2, zero code collision.Scope
Draft for review.