schema-components 1.23.0 → 1.24.0

package/dist/core/adapter.d.mts

@@ -1,5 +1,5 @@
 import { m as JsonObject, w as SchemaMeta } from "../types-BTB73MB8.mjs";
-import { i as DiagnosticsOptions } from "../diagnostics-BS2kaUyE.mjs";
+import { i as DiagnosticsOptions } from "../diagnostics-Cbwak-ZX.mjs";
 
 //#region src/core/adapter.d.ts
 type SchemaInput = Record<string, unknown>;
@@ -65,7 +65,7 @@ declare function detectSchemaKind(input: unknown): SchemaKind;
  *   "Cannot read properties of undefined".
  * - Transforms → zod-transform-unsupported. This also catches `z.codec(…)`
  *   because Zod implements codecs as a pipe + transform internally, so
- *   they trip the same processor when round-tripping is forced. (Plain
+ * they trip the same processor when round-tripping is forced. (Plain
  *   `z.toJSONSchema(codec)` itself does NOT throw because Zod picks one
  *   side of the codec; the static rejection in `typeInference.ts` is the
  *   compile-time guard.)

package/dist/core/constraints.d.mts

@@ -1,5 +1,5 @@
 import { E as StringConstraints, f as FileConstraints, t as ArrayConstraints, x as ObjectConstraints, y as NumberConstraints } from "../types-BTB73MB8.mjs";
-import { i as DiagnosticsOptions } from "../diagnostics-BS2kaUyE.mjs";
+import { i as DiagnosticsOptions } from "../diagnostics-Cbwak-ZX.mjs";
 
 //#region src/core/constraints.d.ts
 declare function extractStringConstraints(schema: Record<string, unknown>, diagnostics?: DiagnosticsOptions, pointer?: string): StringConstraints;

package/dist/core/diagnostics.d.mts

@@ -1,2 +1,2 @@
-import { a as appendPointer, i as DiagnosticsOptions, n as DiagnosticCode, o as emitDiagnostic, r as DiagnosticSink, t as Diagnostic } from "../diagnostics-BS2kaUyE.mjs";
+import { a as appendPointer, i as DiagnosticsOptions, n as DiagnosticCode, o as emitDiagnostic, r as DiagnosticSink, t as Diagnostic } from "../diagnostics-Cbwak-ZX.mjs";
 export { Diagnostic, DiagnosticCode, DiagnosticSink, DiagnosticsOptions, appendPointer, emitDiagnostic };

package/dist/core/formats.d.mts

@@ -1,4 +1,4 @@
-import { i as DiagnosticsOptions } from "../diagnostics-BS2kaUyE.mjs";
+import { i as DiagnosticsOptions } from "../diagnostics-Cbwak-ZX.mjs";
 
 //#region src/core/formats.d.ts
 /**

package/dist/core/merge.d.mts

@@ -1,4 +1,4 @@
-import { i as DiagnosticsOptions } from "../diagnostics-BS2kaUyE.mjs";
+import { i as DiagnosticsOptions } from "../diagnostics-Cbwak-ZX.mjs";
 
 //#region src/core/merge.d.ts
 /**

package/dist/core/normalise.d.mts

@@ -1,4 +1,4 @@
-import { i as DiagnosticsOptions } from "../diagnostics-BS2kaUyE.mjs";
+import { i as DiagnosticsOptions } from "../diagnostics-Cbwak-ZX.mjs";
 import { i as OpenApiVersionInfo, r as JsonSchemaDraft } from "../version-BFTVLsdb.mjs";
 
 //#region src/core/normalise.d.ts

package/dist/core/ref.d.mts

@@ -1,2 +1,2 @@
-import { a as dereference, i as countDistinctRefs, n as RECURSIVE_ANCHOR_SENTINEL, o as findAnchor, r as RefOptions, s as resolveRef, t as ExternalResolver } from "../ref-DjLEKa_E.mjs";
+import { a as dereference, i as countDistinctRefs, n as RECURSIVE_ANCHOR_SENTINEL, o as findAnchor, r as RefOptions, s as resolveRef, t as ExternalResolver } from "../ref-DCDuswPe.mjs";
 export { ExternalResolver, RECURSIVE_ANCHOR_SENTINEL, RefOptions, countDistinctRefs, dereference, findAnchor, resolveRef };

package/dist/core/ref.mjs

@@ -24,11 +24,10 @@ const RECURSIVE_ANCHOR_SENTINEL = "__recursive__";
 *   `false` → `{ not: {} }`      (never-valid schema)
 *
 * Used by {@link resolveRef} so callers that expect an object schema
-* can continue without per-call-site boolean handling.
-*
-* TODO(round7-integration): once Agent D widens the walker's resolved-
-* ref handling to dispatch through `walkSubSchema`, drop this
-* translation and surface the boolean directly.
+* can continue without per-call-site boolean handling. The walker's
+* sub-schema dispatch (`walkSubSchema`) handles booleans natively at
+* non-root positions; this translation covers the degenerate case
+* where a top-level `$ref` resolves to a boolean schema.
 */
 function booleanSchemaToObject(value) {
 	if (value) return {};

package/dist/core/swagger2.d.mts

@@ -1,4 +1,4 @@
-import { i as DiagnosticsOptions } from "../diagnostics-BS2kaUyE.mjs";
+import { i as DiagnosticsOptions } from "../diagnostics-Cbwak-ZX.mjs";
 import { NodeTransform } from "./normalise.mjs";
 
 //#region src/core/swagger2.d.ts

package/dist/core/walkBuilders.d.mts

@@ -1,6 +1,6 @@
 import { A as UnknownField, D as StringField, b as NumberField, c as FieldBase, j as WalkedField, o as Editability, p as FileField, r as BooleanField, v as NullField, w as SchemaMeta } from "../types-BTB73MB8.mjs";
-import { i as DiagnosticsOptions } from "../diagnostics-BS2kaUyE.mjs";
-import { t as ExternalResolver } from "../ref-DjLEKa_E.mjs";
+import { i as DiagnosticsOptions } from "../diagnostics-Cbwak-ZX.mjs";
+import { t as ExternalResolver } from "../ref-DCDuswPe.mjs";
 
 //#region src/core/walkBuilders.d.ts
 declare function getString(obj: Record<string, unknown>, key: string): string | undefined;

package/dist/{diagnostics-BS2kaUyE.d.mts → diagnostics-Cbwak-ZX.d.mts}

@@ -16,7 +16,7 @@
  * Machine-readable codes identifying each class of diagnostic.
  * Stable across releases — consumers can pattern-match on these.
  */
-type DiagnosticCode = "allof-conflict" | "assumed-draft" | "bare-exclusive-bound" | "conditional-fallback" | "cross-schema-relative-ref-unsupported" | "cyclic-path-item-ref" | "dependencies-conflict" | "dependent-required-invalid" | "depth-exceeded" | "discriminator-inconsistent" | "divisible-by-conflict" | "doc-not-object" | "dropped-swagger-feature" | "duplicate-body-parameter" | "duplicate-operation-id" | "dynamic-ref-degraded" | "enum-value-filtered" | "external-ref" | "invalid-const" | "invalid-id-fragment" | "keyword-out-of-draft" | "legacy-dependencies-split" | "legacy-dependencies-split-2019" | "non-json-media-type-fallback" | "parameter-missing-schema" | "path-item-ref-too-deep" | "path-webhook-name-collision" | "pattern-invalid" | "prototype-polluting-property" | "recursive-anchor-collision" | "relative-ref-resolved" | "required-non-string" | "schema-allof-incompatible" | "swagger-collection-format-dropped" | "swagger-cyclic-parameter-ref" | "swagger-invalid-file-parameter" | "swagger-malformed-oauth-flow" | "swagger-missing-consumes" | "swagger-missing-host" | "type-mismatch" | "type-negation-fallback" | "unknown-format" | "unknown-json-schema-dialect" | "unknown-keyword" | "unknown-openapi-version" | "unknown-parameter-location" | "unknown-security-scheme-type" | "unresolved-ref" | "unsupported-type" | "zod-codec-nested-output-only" | "zod-codec-output-only" | "zod-preprocess-output-only" | "zod-promise-nested-unwrap";
+type DiagnosticCode = "allof-conflict" | "assumed-draft" | "bare-exclusive-bound" | "conditional-fallback" | "cross-schema-relative-ref-unsupported" | "cyclic-header-ref" | "cyclic-link-ref" | "cyclic-parameter-ref" | "cyclic-path-item-ref" | "dependencies-conflict" | "dependent-required-invalid" | "depth-exceeded" | "discriminator-inconsistent" | "divisible-by-conflict" | "doc-not-object" | "dropped-swagger-feature" | "header-ref-too-deep" | "duplicate-body-parameter" | "duplicate-operation-id" | "dynamic-ref-degraded" | "enum-value-filtered" | "external-ref" | "invalid-const" | "invalid-id-fragment" | "keyword-out-of-draft" | "link-ref-too-deep" | "legacy-dependencies-split" | "legacy-dependencies-split-2019" | "non-json-media-type-fallback" | "parameter-missing-schema" | "parameter-ref-too-deep" | "path-item-ref-too-deep" | "path-webhook-name-collision" | "pattern-invalid" | "prototype-polluting-property" | "recursive-anchor-collision" | "relative-ref-resolved" | "required-non-string" | "schema-allof-incompatible" | "swagger-collection-format-dropped" | "swagger-cyclic-parameter-ref" | "swagger-invalid-file-parameter" | "swagger-malformed-oauth-flow" | "swagger-missing-consumes" | "swagger-missing-host" | "type-mismatch" | "type-negation-fallback" | "unknown-format" | "unknown-json-schema-dialect" | "unknown-keyword" | "unknown-openapi-version" | "unknown-parameter-location" | "unknown-security-scheme-type" | "unresolved-ref" | "unsupported-type" | "zod-codec-nested-output-only" | "zod-codec-output-only" | "zod-preprocess-output-only" | "zod-promise-nested-unwrap";
 /**
  * A single diagnostic emitted during schema processing.
  */

package/dist/html/renderers.d.mts

@@ -9,16 +9,11 @@ import { matchUnionOption } from "../core/unionMatch.mjs";
  * `aria-controls`, `aria-labelledby`, and `htmlFor` references resolve
  * consistently across the React, sync-HTML, and streaming-HTML outputs.
  *
- * The wrapper tolerates an empty path here (returning `sc-`) for the
- * sole reason that a leaf renderer at the schema root would otherwise
- * throw — `renderToHtml(z.string())` is a rare but valid call shape.
- * Container renderers thread a non-empty path through `renderChild`, so
- * the empty-id fallback can never produce sibling collisions inside a
- * structured form.
- *
- * TODO(round7-integration): once `renderToHtml` always threads a stable
- * root path (e.g. `"$"`) into the leaf renderers, drop this wrapper and
- * call `fieldDomId` directly so the throw fires as designed.
+ * The wrapper tolerates an empty path here (returning `sc-`) so that
+ * a leaf renderer at the schema root — `renderToHtml(z.string())` — has
+ * a usable id without throwing. Container renderers always thread a
+ * non-empty path through `renderChild`, so the empty-id fallback can
+ * never produce sibling collisions inside a structured form.
  */
 declare function fieldId(path: string): string;
 /**
@@ -32,17 +27,11 @@ declare function fieldId(path: string): string;
  * Exported because `streamRenderers.ts` needs to derive identical ids
  * — the panel id on the `<div role="tabpanel">` must match the
  * `aria-controls` on every tab regardless of which pipeline rendered it.
- *
- * TODO(round7-integration): drop the empty-path branch once `renderToHtml`
- * threads a stable root path so `panelIdFor` can be called directly.
  */
 declare function panelId(path: string): string;
 /**
  * Tab id for tab `i` within a discriminated union at `path`. Mirror of
  * `panelId` above — see its comment.
- *
- * TODO(round7-integration): drop the empty-path branch once `renderToHtml`
- * threads a stable root path so `tabIdFor` can be called directly.
  */
 declare function tabId(path: string, i: number): string;
 declare const defaultHtmlResolver: HtmlResolver;

package/dist/html/renderers.mjs

@@ -15,16 +15,11 @@ import { ariaDescribedByAttrs, ariaLabelAttrs, ariaReadonlyAttrs, ariaRequiredAt
 * `aria-controls`, `aria-labelledby`, and `htmlFor` references resolve
 * consistently across the React, sync-HTML, and streaming-HTML outputs.
 *
-* The wrapper tolerates an empty path here (returning `sc-`) for the
-* sole reason that a leaf renderer at the schema root would otherwise
-* throw — `renderToHtml(z.string())` is a rare but valid call shape.
-* Container renderers thread a non-empty path through `renderChild`, so
-* the empty-id fallback can never produce sibling collisions inside a
-* structured form.
-*
-* TODO(round7-integration): once `renderToHtml` always threads a stable
-* root path (e.g. `"$"`) into the leaf renderers, drop this wrapper and
-* call `fieldDomId` directly so the throw fires as designed.
+* The wrapper tolerates an empty path here (returning `sc-`) so that
+* a leaf renderer at the schema root — `renderToHtml(z.string())` — has
+* a usable id without throwing. Container renderers always thread a
+* non-empty path through `renderChild`, so the empty-id fallback can
+* never produce sibling collisions inside a structured form.
 */
 function fieldId(path) {
 	if (path.length === 0) return "sc-";
@@ -41,9 +36,6 @@ function fieldId(path) {
 * Exported because `streamRenderers.ts` needs to derive identical ids
 * — the panel id on the `<div role="tabpanel">` must match the
 * `aria-controls` on every tab regardless of which pipeline rendered it.
-*
-* TODO(round7-integration): drop the empty-path branch once `renderToHtml`
-* threads a stable root path so `panelIdFor` can be called directly.
 */
 function panelId(path) {
 	if (path.length === 0) return `${fieldId(path)}-panel`;
@@ -52,9 +44,6 @@ function panelId(path) {
 /**
 * Tab id for tab `i` within a discriminated union at `path`. Mirror of
 * `panelId` above — see its comment.
-*
-* TODO(round7-integration): drop the empty-path branch once `renderToHtml`
-* threads a stable root path so `tabIdFor` can be called directly.
 */
 function tabId(path, i) {
 	if (path.length === 0) return `${fieldId(path)}-tab-${String(i)}`;

package/dist/html/streamRenderers.d.mts

@@ -1,5 +1,5 @@
 import { j as WalkedField } from "../types-BTB73MB8.mjs";
-import { i as DiagnosticsOptions } from "../diagnostics-BS2kaUyE.mjs";
+import { i as DiagnosticsOptions } from "../diagnostics-Cbwak-ZX.mjs";
 import { o as HtmlResolver } from "../renderer-CXJ8y0qw.mjs";
 import { HtmlElement } from "./html.mjs";
 

package/dist/openapi/components.d.mts

@@ -1,5 +1,5 @@
 import { u as FieldOverride, w as SchemaMeta } from "../types-BTB73MB8.mjs";
-import { r as DiagnosticSink } from "../diagnostics-BS2kaUyE.mjs";
+import { r as DiagnosticSink } from "../diagnostics-Cbwak-ZX.mjs";
 import { InferParameterOverrides, InferRequestBodyFields, InferResponseFields } from "../core/typeInference.mjs";
 import { WidgetMap } from "../react/SchemaComponent.mjs";
 import { ReactNode } from "react";

package/dist/openapi/parser.d.mts

@@ -1,5 +1,5 @@
 import { m as JsonObject } from "../types-BTB73MB8.mjs";
-import { i as DiagnosticsOptions } from "../diagnostics-BS2kaUyE.mjs";
+import { i as DiagnosticsOptions } from "../diagnostics-Cbwak-ZX.mjs";
 
 //#region src/openapi/parser.d.ts
 interface OpenApiDocument {
@@ -87,17 +87,26 @@ interface LinkInfo {
 }
 declare function parseOpenApiDocument(doc: JsonObject): OpenApiDocument;
 declare function getSchema(parsed: OpenApiDocument, ref: string): JsonObject | undefined;
-declare function listOperations(parsed: OpenApiDocument, diagnostics?: DiagnosticsOptions): OperationInfo[];
+declare function listOperations(parsed: OpenApiDocument, diagnostics?: DiagnosticsOptions, seenIds?: Map<string, string>): OperationInfo[];
 declare function getParameters(parsed: OpenApiDocument, path: string, method: string, diagnostics?: DiagnosticsOptions): ParameterInfo[];
 declare function getRequestBody(parsed: OpenApiDocument, path: string, method: string): RequestBodyInfo | undefined;
 declare function getResponses(parsed: OpenApiDocument, path: string, method: string, diagnostics?: DiagnosticsOptions): ResponseInfo[];
 declare function getSecurityRequirements(parsed: OpenApiDocument, path: string, method: string): SecurityRequirement[];
 declare function getSecuritySchemes(parsed: OpenApiDocument): Map<string, SecurityScheme>;
 declare function getResponseHeaders(response: JsonObject, doc?: JsonObject, diagnostics?: DiagnosticsOptions): Map<string, HeaderInfo>;
-declare function listWebhooks(parsed: OpenApiDocument, diagnostics?: DiagnosticsOptions): WebhookInfo[];
+declare function listWebhooks(parsed: OpenApiDocument, diagnostics?: DiagnosticsOptions, seenIds?: Map<string, string>): WebhookInfo[];
+/**
+ * Enumerate every operation in the document — both the `paths` map and
+ * the OpenAPI 3.1 `webhooks` map — sharing a single `seenIds` cache so
+ * cross-list `operationId` collisions surface the same way as same-list
+ * collisions. Returns the path-operation list followed by webhook
+ * operations (flattened); callers that need the structured webhook
+ * grouping should call `listWebhooks` directly.
+ */
+declare function listAllOperations(parsed: OpenApiDocument, diagnostics?: DiagnosticsOptions): OperationInfo[];
 declare function getExternalDocs(obj: JsonObject): ExternalDocs | undefined;
 declare function getXmlInfo(schema: JsonObject): XmlInfo | undefined;
 declare function listCallbacks(parsed: OpenApiDocument, path: string, method: string, diagnostics?: DiagnosticsOptions): CallbackInfo[];
 declare function getLinks(parsed: OpenApiDocument, path: string, method: string, statusCode: string, diagnostics?: DiagnosticsOptions): LinkInfo[];
 //#endregion
-export { CallbackInfo, ExternalDocs, HeaderInfo, LinkInfo, OpenApiDocument, OperationInfo, ParameterInfo, ParameterLocation, RequestBodyInfo, ResponseInfo, SecurityRequirement, SecurityScheme, WebhookInfo, XmlInfo, getExternalDocs, getLinks, getParameters, getRequestBody, getResponseHeaders, getResponses, getSchema, getSecurityRequirements, getSecuritySchemes, getXmlInfo, listCallbacks, listOperations, listWebhooks, parseOpenApiDocument };
+export { CallbackInfo, ExternalDocs, HeaderInfo, LinkInfo, OpenApiDocument, OperationInfo, ParameterInfo, ParameterLocation, RequestBodyInfo, ResponseInfo, SecurityRequirement, SecurityScheme, WebhookInfo, XmlInfo, getExternalDocs, getLinks, getParameters, getRequestBody, getResponseHeaders, getResponses, getSchema, getSecurityRequirements, getSecuritySchemes, getXmlInfo, listAllOperations, listCallbacks, listOperations, listWebhooks, parseOpenApiDocument };

package/dist/openapi/parser.mjs

@@ -96,11 +96,39 @@ function lookupPathItem(parsed, path) {
 	if (resolved !== void 0) return resolved;
 	return resolvePathItem(parsed, getProperty(getProperty(parsed.doc, "webhooks"), path));
 }
-function listOperations(parsed, diagnostics) {
+/**
+* Record an `operationId` against a shared `seenIds` map and emit a
+* `duplicate-operation-id` diagnostic when a subsequent location reuses
+* the same identifier. Returns the original `operationId` so the caller
+* can pass the value straight onto its `OperationInfo`.
+*
+* When the same map is threaded through `listOperations` and
+* `listWebhooks` (see `listAllOperations`), cross-list collisions
+* between a path operation and a webhook operation surface as the same
+* diagnostic class as same-list collisions.
+*/
+function recordOperationId(operationId, location, pointer, seenIds, diagnostics) {
+	if (operationId === void 0) return;
+	const firstSeenAt = seenIds.get(operationId);
+	if (firstSeenAt !== void 0) {
+		emitDiagnostic(diagnostics, {
+			code: "duplicate-operation-id",
+			message: `operationId "${operationId}" is declared more than once (first at ${firstSeenAt}, again at ${location})`,
+			pointer,
+			detail: {
+				operationId,
+				firstSeenAt,
+				duplicateAt: location
+			}
+		});
+		return;
+	}
+	seenIds.set(operationId, location);
+}
+function listOperations(parsed, diagnostics, seenIds = /* @__PURE__ */ new Map()) {
 	const operations = [];
 	const paths = getProperty(parsed.doc, "paths");
 	if (!isObject(paths)) return operations;
-	const seenIds = /* @__PURE__ */ new Map();
 	for (const [path, rawPathItem] of Object.entries(paths)) {
 		const pathItem = resolvePathItem(parsed, rawPathItem, diagnostics);
 		if (pathItem === void 0) continue;
@@ -108,20 +136,7 @@ function listOperations(parsed, diagnostics) {
 			const operation = getProperty(pathItem, method);
 			if (!isObject(operation)) continue;
 			const operationId = getString(operation, "operationId");
-			if (operationId !== void 0) {
-				const firstSeenAt = seenIds.get(operationId);
-				if (firstSeenAt !== void 0) emitDiagnostic(diagnostics, {
-					code: "duplicate-operation-id",
-					message: `operationId "${operationId}" is declared more than once (first at ${firstSeenAt}, again at ${method.toUpperCase()} ${path})`,
-					pointer: `/paths/${jsonPointerEscape(path)}/${method}/operationId`,
-					detail: {
-						operationId,
-						firstSeenAt,
-						duplicateAt: `${method.toUpperCase()} ${path}`
-					}
-				});
-				else seenIds.set(operationId, `${method.toUpperCase()} ${path}`);
-			}
+			recordOperationId(operationId, `${method.toUpperCase()} ${path}`, `/paths/${jsonPointerEscape(path)}/${method}/operationId`, seenIds, diagnostics);
 			operations.push({
 				path,
 				method,
@@ -179,26 +194,21 @@ function extractParameterList(doc, parameters, pointerBase, diagnostics) {
 * length — a Reference Object whose target is itself a Reference Object
 * is legal. `resolveRefChain` centralises cycle and depth-cap protection.
 *
-* Cycles and over-deep chains reuse the existing `cyclic-path-item-ref`
-* and `path-item-ref-too-deep` diagnostic codes with a
-* `detail.kind: "<node-kind>"` discriminator (e.g. `"parameter"`,
-* `"header"`, `"link"`). There is no dedicated code per node kind in the
-* current `DiagnosticCode` union; consumers filter by `detail.kind` when
-* they care to distinguish the source.
-*
-* TODO(round7-integration): consider adding dedicated `cyclic-*-ref` /
-* `*-ref-too-deep` codes per node kind to `core/diagnostics.ts` so the
-* kind discriminator on `detail` is not needed. The existing Swagger
-* 2.0 path already uses a dedicated `swagger-cyclic-parameter-ref` for
-* the equivalent failure mode.
+* Cycles and over-deep chains emit a dedicated diagnostic code per node
+* kind (`cyclic-parameter-ref`, `parameter-ref-too-deep`, and the
+* `header` / `link` equivalents), mirroring the existing
+* `swagger-cyclic-parameter-ref` precedent so consumers can pattern-match
+* directly on the code instead of filtering by `detail.kind`.
 */
 function resolveReferenceObjectChain(doc, node, kind, diagnostics) {
 	const kindLabel = kind === "parameter" ? "Parameter Object" : kind === "header" ? "Header Object" : "Link Object";
+	const cyclicCode = kind === "parameter" ? "cyclic-parameter-ref" : kind === "header" ? "cyclic-header-ref" : "cyclic-link-ref";
+	const tooDeepCode = kind === "parameter" ? "parameter-ref-too-deep" : kind === "header" ? "header-ref-too-deep" : "link-ref-too-deep";
 	return resolveRefChain(node, {
 		lookup: (ref) => ref.startsWith("#/") ? resolveRefInDoc(doc, ref) : void 0,
 		onCycle: (ref) => {
 			emitDiagnostic(diagnostics, {
-				code: "cyclic-path-item-ref",
+				code: cyclicCode,
 				message: `Cyclic ${kindLabel} $ref "${ref}"`,
 				pointer: ref,
 				detail: {
@@ -209,7 +219,7 @@ function resolveReferenceObjectChain(doc, node, kind, diagnostics) {
 		},
 		onDepthExceeded: (ref) => {
 			emitDiagnostic(diagnostics, {
-				code: "path-item-ref-too-deep",
+				code: tooDeepCode,
 				message: `${kindLabel} $ref chain exceeded the hop cap starting from "${ref}"`,
 				pointer: ref,
 				detail: {
@@ -451,7 +461,7 @@ function getResponseHeaders(response, doc, diagnostics) {
 	}
 	return result;
 }
-function listWebhooks(parsed, diagnostics) {
+function listWebhooks(parsed, diagnostics, seenIds = /* @__PURE__ */ new Map()) {
 	const result = [];
 	const webhooks = getProperty(parsed.doc, "webhooks");
 	if (!isObject(webhooks)) return result;
@@ -462,10 +472,12 @@ function listWebhooks(parsed, diagnostics) {
 		for (const method of HTTP_METHODS) {
 			const operation = getProperty(hookItem, method);
 			if (!isObject(operation)) continue;
+			const operationId = getString(operation, "operationId");
+			recordOperationId(operationId, `${method.toUpperCase()} webhook:${name}`, `/webhooks/${jsonPointerEscape(name)}/${method}/operationId`, seenIds, diagnostics);
 			operations.push({
 				path: name,
 				method,
-				operationId: getString(operation, "operationId"),
+				operationId,
 				summary: getString(operation, "summary"),
 				description: getString(operation, "description"),
 				deprecated: getProperty(operation, "deprecated") === true,
@@ -479,6 +491,20 @@ function listWebhooks(parsed, diagnostics) {
 	}
 	return result;
 }
+/**
+* Enumerate every operation in the document — both the `paths` map and
+* the OpenAPI 3.1 `webhooks` map — sharing a single `seenIds` cache so
+* cross-list `operationId` collisions surface the same way as same-list
+* collisions. Returns the path-operation list followed by webhook
+* operations (flattened); callers that need the structured webhook
+* grouping should call `listWebhooks` directly.
+*/
+function listAllOperations(parsed, diagnostics) {
+	const seenIds = /* @__PURE__ */ new Map();
+	const pathOps = listOperations(parsed, diagnostics, seenIds);
+	const webhookOps = listWebhooks(parsed, diagnostics, seenIds).flatMap((w) => w.operations);
+	return [...pathOps, ...webhookOps];
+}
 function getExternalDocs(obj) {
 	const docs = getProperty(obj, "externalDocs");
 	if (!isObject(docs)) return void 0;
@@ -559,4 +585,4 @@ function getLinks(parsed, path, method, statusCode, diagnostics) {
 	return result;
 }
 //#endregion
-export { getExternalDocs, getLinks, getParameters, getRequestBody, getResponseHeaders, getResponses, getSchema, getSecurityRequirements, getSecuritySchemes, getXmlInfo, listCallbacks, listOperations, listWebhooks, parseOpenApiDocument };
+export { getExternalDocs, getLinks, getParameters, getRequestBody, getResponseHeaders, getResponses, getSchema, getSecurityRequirements, getSecuritySchemes, getXmlInfo, listAllOperations, listCallbacks, listOperations, listWebhooks, parseOpenApiDocument };

package/dist/openapi/resolve.d.mts

@@ -1,4 +1,4 @@
-import { i as DiagnosticsOptions } from "../diagnostics-BS2kaUyE.mjs";
+import { i as DiagnosticsOptions } from "../diagnostics-Cbwak-ZX.mjs";
 import { OpenApiDocument, OperationInfo, ParameterInfo, ResponseInfo, getRequestBody } from "./parser.mjs";
 
 //#region src/openapi/resolve.d.ts

package/dist/openapi/resolve.mjs

@@ -5,7 +5,7 @@ import { isPrototypePollutingKey } from "../core/uri.mjs";
 import { detectOpenApiVersion } from "../core/version.mjs";
 import { o as normaliseOpenApiSchemas, r as documentContainsKeyword } from "../normalise-DCYp06Sr.mjs";
 import { resolveRefChain } from "../core/refChain.mjs";
-import { getParameters, getRequestBody, getResponses, listOperations, listWebhooks, parseOpenApiDocument } from "./parser.mjs";
+import { getParameters, getRequestBody, getResponses, listAllOperations, parseOpenApiDocument } from "./parser.mjs";
 //#region src/openapi/resolve.ts
 /**
 * OpenAPI document resolution and caching.
@@ -325,7 +325,7 @@ function extractPathItemInfo(pathItem) {
 */
 function resolveOperationFromParsed(parsed, path, method, diagnostics) {
 	const pathItemNode = lookupPathItemNode(parsed, path, diagnostics);
-	const operation = [...listOperations(parsed), ...listWebhooks(parsed).flatMap((w) => w.operations)].find((op) => op.path === path && op.method === method);
+	const operation = listAllOperations(parsed).find((op) => op.path === path && op.method === method);
 	if (operation === void 0) throw new Error(`Operation not found: ${method.toUpperCase()} ${path}`);
 	if (pathItemNode === void 0) throw new Error(`Path item missing for ${method.toUpperCase()} ${path}`);
 	return {

package/dist/react/SchemaComponent.d.mts

@@ -1,5 +1,5 @@
 import { d as FieldOverrides, j as WalkedField, u as FieldOverride, w as SchemaMeta } from "../types-BTB73MB8.mjs";
-import { t as Diagnostic } from "../diagnostics-BS2kaUyE.mjs";
+import { t as Diagnostic } from "../diagnostics-Cbwak-ZX.mjs";
 import { t as SchemaError } from "../errors-g_MCTQel.mjs";
 import { l as RenderProps, r as ComponentResolver } from "../renderer-CXJ8y0qw.mjs";
 import { FromJSONSchema, FromJSONSchemaMode, IsSwagger2Doc, PathOfType, RejectUnrepresentableZod, ResolveOpenAPIRef, TypeAtPath, __SchemaInferenceFellBack } from "../core/typeInference.mjs";
@@ -135,7 +135,7 @@ interface SchemaComponentProps<T = unknown, Ref extends string | undefined = und
    *
    * TODO(round7-integration): promote to
    * `NarrowAtPath<InferSchemaValue<T, Ref, "output">, P>` once the
-   * round-7 test fixtures (headless union, discriminated union,
+   * test fixtures (headless union, discriminated union,
    * schemaview equivalence, type-inference issue fixes) are
    * migrated to either narrow their fixtures or accept the loose
    * boundary. The retype cascades through call sites that

package/dist/react/SchemaView.d.mts

@@ -1,5 +1,5 @@
 import { w as SchemaMeta } from "../types-BTB73MB8.mjs";
-import { t as Diagnostic } from "../diagnostics-BS2kaUyE.mjs";
+import { t as Diagnostic } from "../diagnostics-Cbwak-ZX.mjs";
 import { r as ComponentResolver } from "../renderer-CXJ8y0qw.mjs";
 import { RejectUnrepresentableZod } from "../core/typeInference.mjs";
 import { WidgetMap } from "./SchemaComponent.mjs";

package/dist/{ref-DjLEKa_E.d.mts → ref-DCDuswPe.d.mts}

@@ -1,4 +1,4 @@
-import { i as DiagnosticsOptions } from "./diagnostics-BS2kaUyE.mjs";
+import { i as DiagnosticsOptions } from "./diagnostics-Cbwak-ZX.mjs";
 
 //#region src/core/ref.d.ts
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "schema-components",
-    "version": "1.23.0",
+    "version": "1.24.0",
     "description": "React components that render UI from Zod schemas, JSON Schema, and OpenAPI documents",
     "type": "module",
     "exports": {