@formspec/build 0.1.0-alpha.41 → 0.1.0-alpha.43

package/dist/index.js

@@ -1535,6 +1535,66 @@ function generateCustomType(type, ctx) {
   }
   return registration.toJsonSchema(type.payload, ctx.vendorPrefix);
 }
+var JSON_SCHEMA_STRUCTURAL_KEYWORDS = /* @__PURE__ */ new Set([
+  "$schema",
+  "$ref",
+  "$defs",
+  "$id",
+  "$anchor",
+  "$dynamicRef",
+  "$dynamicAnchor",
+  "$vocabulary",
+  "$comment",
+  "type",
+  "enum",
+  "const",
+  "properties",
+  "patternProperties",
+  "additionalProperties",
+  "required",
+  "items",
+  "prefixItems",
+  "additionalItems",
+  "contains",
+  "allOf",
+  "oneOf",
+  "anyOf",
+  "not",
+  "if",
+  "then",
+  "else",
+  "minimum",
+  "maximum",
+  "exclusiveMinimum",
+  "exclusiveMaximum",
+  "multipleOf",
+  "minLength",
+  "maxLength",
+  "pattern",
+  "minItems",
+  "maxItems",
+  "uniqueItems",
+  "minProperties",
+  "maxProperties",
+  "minContains",
+  "maxContains",
+  "format",
+  "title",
+  "description",
+  "default",
+  "deprecated",
+  "readOnly",
+  "writeOnly",
+  "examples",
+  "dependentRequired",
+  "dependentSchemas",
+  "propertyNames",
+  "unevaluatedItems",
+  "unevaluatedProperties",
+  "contentEncoding",
+  "contentMediaType",
+  "contentSchema"
+]);
 function applyCustomConstraint(schema, constraint, ctx) {
   const registration = ctx.extensionRegistry?.findConstraint(constraint.constraintId);
   if (registration === void 0) {
@@ -1542,12 +1602,25 @@ function applyCustomConstraint(schema, constraint, ctx) {
       `Cannot generate JSON Schema for custom constraint "${constraint.constraintId}" without a matching extension registration`
     );
   }
-  assignVendorPrefixedExtensionKeywords(
-    schema,
-    registration.toJsonSchema(constraint.payload, ctx.vendorPrefix),
-    ctx.vendorPrefix,
-    `custom constraint "${constraint.constraintId}"`
-  );
+  const extensionSchema = registration.toJsonSchema(constraint.payload, ctx.vendorPrefix);
+  if (registration.emitsVocabularyKeywords) {
+    const target = schema;
+    for (const [key, value] of Object.entries(extensionSchema)) {
+      if (JSON_SCHEMA_STRUCTURAL_KEYWORDS.has(key)) {
+        throw new Error(
+          `Custom constraint "${constraint.constraintId}" with emitsVocabularyKeywords must not overwrite standard JSON Schema keyword "${key}"`
+        );
+      }
+      target[key] = value;
+    }
+  } else {
+    assignVendorPrefixedExtensionKeywords(
+      schema,
+      extensionSchema,
+      ctx.vendorPrefix,
+      `custom constraint "${constraint.constraintId}"`
+    );
+  }
 }
 function applyCustomAnnotation(schema, annotation, ctx) {
   const registration = ctx.extensionRegistry?.findAnnotation(annotation.annotationId);
@@ -2077,7 +2150,7 @@ import * as path from "path";
 import * as ts3 from "typescript";
 import {
   analyzeMetadataForNodeWithChecker,
-  parseCommentBlock as parseCommentBlock2
+  parseCommentBlock
 } from "@formspec/analysis/internal";
 
 // src/analyzer/jsdoc-constraints.ts
@@ -2087,73 +2160,25 @@ import * as ts2 from "typescript";
 import * as ts from "typescript";
 import {
   checkSyntheticTagApplication,
+  choosePreferredPayloadText,
   extractPathTarget as extractSharedPathTarget,
   getTagDefinition as getTagDefinition2,
   hasTypeSemanticCapability,
   normalizeFormSpecTagName as normalizeFormSpecTagName2,
   parseConstraintTagValue,
   parseDefaultValueTagValue,
+  parseTagSyntax,
+  parseUnifiedComment,
   resolveDeclarationPlacement,
   resolvePathTargetType,
-  sliceCommentSpan,
-  parseCommentBlock,
-  parseTagSyntax
+  TAGS_REQUIRING_RAW_TEXT
 } from "@formspec/analysis/internal";
-import {
-  TSDocParser,
-  TSDocConfiguration,
-  TSDocTagDefinition,
-  TSDocTagSyntaxKind,
-  DocExcerpt,
-  DocPlainText,
-  DocSoftBreak,
-  TextRange
-} from "@microsoft/tsdoc";
 import {
   BUILTIN_CONSTRAINT_DEFINITIONS as BUILTIN_CONSTRAINT_DEFINITIONS2,
   normalizeConstraintTagName as normalizeConstraintTagName2,
   isBuiltinConstraintName
 } from "@formspec/core/internals";
 import "@formspec/core/internals";
-var TAGS_REQUIRING_RAW_TEXT = /* @__PURE__ */ new Set(["pattern", "enumOptions", "defaultValue"]);
-function createFormSpecTSDocConfig(extensionTagNames = []) {
-  const config = new TSDocConfiguration();
-  for (const tagName of Object.keys(BUILTIN_CONSTRAINT_DEFINITIONS2)) {
-    config.addTagDefinition(
-      new TSDocTagDefinition({
-        tagName: "@" + tagName,
-        syntaxKind: TSDocTagSyntaxKind.BlockTag,
-        allowMultiple: true
-      })
-    );
-  }
-  for (const tagName of ["apiName", "displayName", "format", "placeholder"]) {
-    config.addTagDefinition(
-      new TSDocTagDefinition({
-        tagName: "@" + tagName,
-        syntaxKind: TSDocTagSyntaxKind.BlockTag,
-        allowMultiple: true
-      })
-    );
-  }
-  for (const tagName of extensionTagNames) {
-    config.addTagDefinition(
-      new TSDocTagDefinition({
-        tagName: "@" + tagName,
-        syntaxKind: TSDocTagSyntaxKind.BlockTag,
-        allowMultiple: true
-      })
-    );
-  }
-  return config;
-}
-function sharedCommentSyntaxOptions(options, offset) {
-  const extensions = options?.extensionRegistry?.extensions;
-  return {
-    ...offset !== void 0 ? { offset } : {},
-    ...extensions !== void 0 ? { extensions } : {}
-  };
-}
 function sharedTagValueOptions(options) {
   return {
     ...options?.extensionRegistry !== void 0 ? { registry: options.extensionRegistry } : {},
@@ -2253,6 +2278,30 @@ function pushUniqueCompilerDiagnostics(target, additions) {
     target.push(diagnostic);
   }
 }
+function processConstraintTag(tagName, text, parsedTag, provenance, node, sourceFile, supportingDeclarations, options, constraints, diagnostics) {
+  const compilerDiagnostics = buildCompilerBackedConstraintDiagnostics(
+    node,
+    sourceFile,
+    tagName,
+    parsedTag,
+    provenance,
+    supportingDeclarations,
+    options
+  );
+  if (compilerDiagnostics.length > 0) {
+    pushUniqueCompilerDiagnostics(diagnostics, compilerDiagnostics);
+    return;
+  }
+  const constraintNode = parseConstraintTagValue(
+    tagName,
+    text,
+    provenance,
+    sharedTagValueOptions(options)
+  );
+  if (constraintNode) {
+    constraints.push(constraintNode);
+  }
+}
 function renderSyntheticArgumentExpression(valueKind, argumentText) {
   const trimmed = argumentText.trim();
   if (trimmed === "") {
@@ -2538,10 +2587,9 @@ function buildCompilerBackedConstraintDiagnostics(node, sourceFile, tagName, par
     )
   ];
 }
-var parserCache = /* @__PURE__ */ new Map();
 var parseResultCache = /* @__PURE__ */ new Map();
-function getParser(options) {
-  const extensionTagNames = [
+function getExtensionTagNames(options) {
+  return [
     ...options?.extensionRegistry?.extensions.flatMap(
       (extension) => (extension.constraintTags ?? []).map((tag) => normalizeFormSpecTagName2(tag.tagName))
     ) ?? [],
@@ -2549,14 +2597,6 @@ function getParser(options) {
       (extension) => (extension.metadataSlots ?? []).map((slot) => normalizeFormSpecTagName2(slot.tagName))
     ) ?? []
   ].sort();
-  const cacheKey = extensionTagNames.join("|");
-  const existing = parserCache.get(cacheKey);
-  if (existing) {
-    return existing;
-  }
-  const parser = new TSDocParser(createFormSpecTSDocConfig(extensionTagNames));
-  parserCache.set(cacheKey, parser);
-  return parser;
 }
 function getExtensionRegistryCacheKey(registry) {
   if (registry === void 0) {
@@ -2607,13 +2647,13 @@ function parseTSDocTags(node, file = "", options) {
   let placeholder;
   let displayNameProvenance;
   let placeholderProvenance;
-  const rawTextTags = [];
   const sourceFile = node.getSourceFile();
   const sourceText = sourceFile.getFullText();
   const extensionTypeNames = getExtensionTypeNames(options?.extensionRegistry);
   const supportingDeclarations = buildSupportingDeclarations(sourceFile, extensionTypeNames);
   const commentRanges = ts.getLeadingCommentRanges(sourceText, node.getFullStart());
   const rawTextFallbacks = collectRawTextFallbacks(node, file);
+  const extensionTagNames = getExtensionTagNames(options);
   if (commentRanges) {
     for (const range of commentRanges) {
       if (range.kind !== ts.SyntaxKind.MultiLineCommentTrivia) {
@@ -2623,38 +2663,18 @@ function parseTSDocTags(node, file = "", options) {
       if (!commentText.startsWith("/**")) {
         continue;
       }
-      const parser = getParser(options);
-      const parserContext = parser.parseRange(
-        TextRange.fromStringRange(sourceText, range.pos, range.end)
-      );
-      const docComment = parserContext.docComment;
-      const parsedComment = parseCommentBlock(
-        commentText,
-        sharedCommentSyntaxOptions(options, range.pos)
-      );
-      let parsedTagCursor = 0;
-      const nextParsedTag = (normalizedTagName) => {
-        while (parsedTagCursor < parsedComment.tags.length) {
-          const candidate = parsedComment.tags[parsedTagCursor];
-          parsedTagCursor += 1;
-          if (candidate?.normalizedTagName === normalizedTagName) {
-            return candidate;
-          }
-        }
-        return null;
-      };
-      for (const parsedTag of parsedComment.tags) {
-        if (TAGS_REQUIRING_RAW_TEXT.has(parsedTag.normalizedTagName)) {
-          rawTextTags.push({ tag: parsedTag, commentText, commentOffset: range.pos });
-        }
-      }
-      for (const block of docComment.customBlocks) {
-        const tagName = normalizeConstraintTagName2(block.blockTag.tagName.substring(1));
-        const parsedTag = nextParsedTag(tagName);
+      const extensions = options?.extensionRegistry?.extensions;
+      const unified = parseUnifiedComment(commentText, {
+        offset: range.pos,
+        extensionTagNames,
+        ...extensions !== void 0 ? { extensions } : {}
+      });
+      for (const tag of unified.tags) {
+        const tagName = tag.normalizedTagName;
         if (tagName === "displayName" || tagName === "format" || tagName === "placeholder") {
-          const text2 = getBestBlockPayloadText(parsedTag, commentText, range.pos, block);
+          const text2 = tag.resolvedPayloadText;
           if (text2 === "") continue;
-          const provenance2 = parsedTag !== null ? provenanceForParsedTag(parsedTag, sourceFile, file) : provenanceForComment(range, sourceFile, file, tagName);
+          const provenance2 = provenanceForParsedTag(tag, sourceFile, file);
           switch (tagName) {
             case "displayName":
               if (!isMemberTargetDisplayName(text2) && displayName === void 0) {
@@ -2679,64 +2699,69 @@ function parseTSDocTags(node, file = "", options) {
           }
           continue;
         }
-        if (TAGS_REQUIRING_RAW_TEXT.has(tagName)) continue;
-        const text = getBestBlockPayloadText(parsedTag, commentText, range.pos, block);
-        const expectedType = isBuiltinConstraintName(tagName) ? BUILTIN_CONSTRAINT_DEFINITIONS2[tagName] : void 0;
-        if (text === "" && expectedType !== "boolean") continue;
-        const provenance = parsedTag !== null ? provenanceForParsedTag(parsedTag, sourceFile, file) : provenanceForComment(range, sourceFile, file, tagName);
-        const compilerDiagnostics = buildCompilerBackedConstraintDiagnostics(
-          node,
-          sourceFile,
-          tagName,
-          parsedTag,
-          provenance,
-          supportingDeclarations,
-          options
-        );
-        if (compilerDiagnostics.length > 0) {
-          pushUniqueCompilerDiagnostics(diagnostics, compilerDiagnostics);
+        if (TAGS_REQUIRING_RAW_TEXT.has(tagName)) {
+          const fallback = rawTextFallbacks.get(tagName)?.shift();
+          const text2 = choosePreferredPayloadText(tag.resolvedPayloadText, fallback?.text ?? "");
+          if (text2 === "") continue;
+          const provenance2 = provenanceForParsedTag(tag, sourceFile, file);
+          if (tagName === "defaultValue") {
+            annotations.push(parseDefaultValueTagValue(text2, provenance2));
+            continue;
+          }
+          processConstraintTag(
+            tagName,
+            text2,
+            tag,
+            provenance2,
+            node,
+            sourceFile,
+            supportingDeclarations,
+            options,
+            constraints,
+            diagnostics
+          );
           continue;
         }
-        const constraintNode = parseConstraintTagValue(
+        const text = tag.resolvedPayloadText;
+        const expectedType = isBuiltinConstraintName(tagName) ? BUILTIN_CONSTRAINT_DEFINITIONS2[tagName] : void 0;
+        if (text === "" && expectedType !== "boolean") continue;
+        const provenance = provenanceForParsedTag(tag, sourceFile, file);
+        processConstraintTag(
           tagName,
           text,
+          tag,
           provenance,
-          sharedTagValueOptions(options)
+          node,
+          sourceFile,
+          supportingDeclarations,
+          options,
+          constraints,
+          diagnostics
         );
-        if (constraintNode) {
-          constraints.push(constraintNode);
-        }
       }
-      if (docComment.deprecatedBlock !== void 0) {
-        const message = extractBlockText(docComment.deprecatedBlock).trim();
+      if (unified.isDeprecated) {
         annotations.push({
           kind: "annotation",
           annotationKind: "deprecated",
-          ...message !== "" && { message },
+          ...unified.deprecationMessage !== "" && { message: unified.deprecationMessage },
           provenance: provenanceForComment(range, sourceFile, file, "deprecated")
         });
       }
-      {
-        const summary = extractPlainText(docComment.summarySection).trim();
-        if (summary !== "") {
-          annotations.push({
-            kind: "annotation",
-            annotationKind: "description",
-            value: summary,
-            provenance: provenanceForComment(range, sourceFile, file, "summary")
-          });
-        }
+      if (unified.summaryText !== "") {
+        annotations.push({
+          kind: "annotation",
+          annotationKind: "description",
+          value: unified.summaryText,
+          provenance: provenanceForComment(range, sourceFile, file, "summary")
+        });
       }
-      if (docComment.remarksBlock !== void 0) {
-        const remarksText = extractBlockText(docComment.remarksBlock).trim();
-        if (remarksText !== "") {
-          annotations.push({
-            kind: "annotation",
-            annotationKind: "remarks",
-            value: remarksText,
-            provenance: provenanceForComment(range, sourceFile, file, "remarks")
-          });
-        }
+      if (unified.remarksText !== "") {
+        annotations.push({
+          kind: "annotation",
+          annotationKind: "remarks",
+          value: unified.remarksText,
+          provenance: provenanceForComment(range, sourceFile, file, "remarks")
+        });
       }
     }
   }
@@ -2756,77 +2781,27 @@ function parseTSDocTags(node, file = "", options) {
       provenance: placeholderProvenance
     });
   }
-  if (rawTextTags.length > 0) {
-    for (const rawTextTag of rawTextTags) {
-      const fallbackQueue = rawTextFallbacks.get(rawTextTag.tag.normalizedTagName);
-      const fallback = fallbackQueue?.shift();
-      const text = choosePreferredPayloadText(
-        getSharedPayloadText(rawTextTag.tag, rawTextTag.commentText, rawTextTag.commentOffset),
-        fallback?.text ?? ""
-      );
-      if (text === "") continue;
-      const provenance = provenanceForParsedTag(rawTextTag.tag, sourceFile, file);
-      if (rawTextTag.tag.normalizedTagName === "defaultValue") {
-        const defaultValueNode = parseDefaultValueTagValue(text, provenance);
-        annotations.push(defaultValueNode);
-        continue;
-      }
-      const compilerDiagnostics = buildCompilerBackedConstraintDiagnostics(
-        node,
-        sourceFile,
-        rawTextTag.tag.normalizedTagName,
-        rawTextTag.tag,
-        provenance,
-        supportingDeclarations,
-        options
-      );
-      if (compilerDiagnostics.length > 0) {
-        pushUniqueCompilerDiagnostics(diagnostics, compilerDiagnostics);
-        continue;
-      }
-      const constraintNode = parseConstraintTagValue(
-        rawTextTag.tag.normalizedTagName,
-        text,
-        provenance,
-        sharedTagValueOptions(options)
-      );
-      if (constraintNode) {
-        constraints.push(constraintNode);
-      }
-    }
-  }
   for (const [tagName, fallbacks] of rawTextFallbacks) {
     for (const fallback of fallbacks) {
       const text = fallback.text.trim();
       if (text === "") continue;
       const provenance = fallback.provenance;
       if (tagName === "defaultValue") {
-        const defaultValueNode = parseDefaultValueTagValue(text, provenance);
-        annotations.push(defaultValueNode);
+        annotations.push(parseDefaultValueTagValue(text, provenance));
         continue;
       }
-      const compilerDiagnostics = buildCompilerBackedConstraintDiagnostics(
-        node,
-        sourceFile,
+      processConstraintTag(
         tagName,
+        text,
         null,
         provenance,
+        node,
+        sourceFile,
         supportingDeclarations,
-        options
-      );
-      if (compilerDiagnostics.length > 0) {
-        pushUniqueCompilerDiagnostics(diagnostics, compilerDiagnostics);
-        continue;
-      }
-      const constraintNode = parseConstraintTagValue(
-        tagName,
-        text,
-        provenance,
-        sharedTagValueOptions(options)
+        options,
+        constraints,
+        diagnostics
       );
-      if (constraintNode) {
-        constraints.push(constraintNode);
-      }
     }
   }
   const result = { constraints, annotations, diagnostics };
@@ -2844,8 +2819,8 @@ function extractDisplayNameMetadata(node) {
       if (range.kind !== ts.SyntaxKind.MultiLineCommentTrivia) continue;
       const commentText = sourceText.substring(range.pos, range.end);
       if (!commentText.startsWith("/**")) continue;
-      const parsed = parseCommentBlock(commentText);
-      for (const tag of parsed.tags) {
+      const unified = parseUnifiedComment(commentText);
+      for (const tag of unified.tags) {
         if (tag.normalizedTagName !== "displayName") {
           continue;
         }
@@ -2864,51 +2839,6 @@ function extractDisplayNameMetadata(node) {
     memberDisplayNames
   };
 }
-function extractBlockText(block) {
-  return extractPlainText(block.content);
-}
-function extractPlainText(node) {
-  let result = "";
-  if (node instanceof DocExcerpt) {
-    return node.content.toString();
-  }
-  if (node instanceof DocPlainText) {
-    return node.text;
-  }
-  if (node instanceof DocSoftBreak) {
-    return " ";
-  }
-  if (typeof node.getChildNodes === "function") {
-    for (const child of node.getChildNodes()) {
-      result += extractPlainText(child);
-    }
-  }
-  return result;
-}
-function choosePreferredPayloadText(primary, fallback) {
-  const preferred = primary.trim();
-  const alternate = fallback.trim();
-  if (preferred === "") return alternate;
-  if (alternate === "") return preferred;
-  if (alternate.includes("\n")) return alternate;
-  if (alternate.length > preferred.length && alternate.startsWith(preferred)) {
-    return alternate;
-  }
-  return preferred;
-}
-function getSharedPayloadText(tag, commentText, commentOffset) {
-  if (tag.payloadSpan === null) {
-    return "";
-  }
-  return sliceCommentSpan(commentText, tag.payloadSpan, {
-    offset: commentOffset
-  }).trim();
-}
-function getBestBlockPayloadText(tag, commentText, commentOffset, block) {
-  const sharedText = tag === null ? "" : getSharedPayloadText(tag, commentText, commentOffset);
-  const blockText = extractBlockText(block).replace(/\s+/g, " ").trim();
-  return choosePreferredPayloadText(sharedText, blockText);
-}
 function collectRawTextFallbacks(node, file) {
   const fallbacks = /* @__PURE__ */ new Map();
   for (const tag of ts.getJSDocTags(node)) {
@@ -3406,7 +3336,7 @@ function getLeadingParsedTags(node) {
     if (!commentText.startsWith("/**")) {
       continue;
     }
-    parsedTags.push(...parseCommentBlock2(commentText, { offset: range.pos }).tags);
+    parsedTags.push(...parseCommentBlock(commentText, { offset: range.pos }).tags);
   }
   return parsedTags;
 }
@@ -4558,7 +4488,7 @@ function typeNodeContainsReference(type, targetName) {
   }
 }
 function shouldEmitResolvedObjectProperty(property, declaration) {
-  if (property.name.startsWith("__@")) {
+  if (property.name.startsWith("__")) {
     return false;
   }
   if (declaration !== void 0 && "name" in declaration && declaration.name !== void 0) {
@@ -5551,7 +5481,9 @@ function generateSchemasFromClass(options) {
     classDecl,
     ctx.checker,
     options.filePath,
+    // eslint-disable-next-line @typescript-eslint/no-deprecated -- migration bridge reads deprecated fields
     options.extensionRegistry,
+    // eslint-disable-next-line @typescript-eslint/no-deprecated -- migration bridge reads deprecated fields
     options.metadata,
     options.discriminator
   );
@@ -5559,9 +5491,13 @@ function generateSchemasFromClass(options) {
     analysis,
     { file: options.filePath },
     {
+      // eslint-disable-next-line @typescript-eslint/no-deprecated -- migration bridge reads deprecated fields
       extensionRegistry: options.extensionRegistry,
+      // eslint-disable-next-line @typescript-eslint/no-deprecated -- migration bridge reads deprecated fields
       metadata: options.metadata,
+      // eslint-disable-next-line @typescript-eslint/no-deprecated -- migration bridge reads deprecated fields
       enumSerialization: options.enumSerialization,
+      // eslint-disable-next-line @typescript-eslint/no-deprecated -- migration bridge reads deprecated fields
       vendorPrefix: options.vendorPrefix
     }
   );
@@ -5608,7 +5544,12 @@ function generateSchemasDetailedInternal(options) {
       diagnostics: [createProgramContextFailureDiagnostic(options.filePath, error)]
     };
   }
-  return generateSchemasFromDetailedProgramContext(ctx, options.filePath, options.typeName, options);
+  return generateSchemasFromDetailedProgramContext(
+    ctx,
+    options.filePath,
+    options.typeName,
+    options
+  );
 }
 function generateSchemasFromProgramDetailed(options) {
   return generateSchemasFromProgram({
@@ -5626,7 +5567,12 @@ function generateSchemasFromProgramDetailedInternal(options) {
       diagnostics: [createProgramContextFailureDiagnostic(options.filePath, error)]
     };
   }
-  return generateSchemasFromDetailedProgramContext(ctx, options.filePath, options.typeName, options);
+  return generateSchemasFromDetailedProgramContext(
+    ctx,
+    options.filePath,
+    options.typeName,
+    options
+  );
 }
 function generateSchemasBatch(options) {
   const contextCache = /* @__PURE__ */ new Map();
@@ -5670,13 +5616,27 @@ function generateSchemasBatchFromProgram(options) {
     );
   });
 }
+function resolveOptions(options) {
+  const configRegistry = options.config?.extensions !== void 0 ? createExtensionRegistry(options.config.extensions) : void 0;
+  return {
+    // eslint-disable-next-line @typescript-eslint/no-deprecated -- migration bridge reads deprecated fields
+    extensionRegistry: options.extensionRegistry ?? configRegistry,
+    // eslint-disable-next-line @typescript-eslint/no-deprecated -- migration bridge reads deprecated fields
+    vendorPrefix: options.vendorPrefix ?? options.config?.vendorPrefix,
+    // eslint-disable-next-line @typescript-eslint/no-deprecated -- migration bridge reads deprecated fields
+    enumSerialization: options.enumSerialization ?? options.config?.enumSerialization,
+    // eslint-disable-next-line @typescript-eslint/no-deprecated -- migration bridge reads deprecated fields
+    metadata: options.metadata ?? options.config?.metadata
+  };
+}
 function generateSchemasFromDetailedProgramContext(ctx, filePath, typeName, options) {
+  const resolved = resolveOptions(options);
   const analysisResult = analyzeNamedTypeToIRFromProgramContextDetailed(
     ctx,
     filePath,
     typeName,
-    options.extensionRegistry,
-    options.metadata,
+    resolved.extensionRegistry,
+    resolved.metadata,
     options.discriminator
   );
   if (!analysisResult.ok) {
@@ -5689,10 +5649,10 @@ function generateSchemasFromDetailedProgramContext(ctx, filePath, typeName, opti
     analysisResult.analysis,
     { file: filePath },
     {
-      extensionRegistry: options.extensionRegistry,
-      metadata: options.metadata,
-      enumSerialization: options.enumSerialization,
-      vendorPrefix: options.vendorPrefix
+      extensionRegistry: resolved.extensionRegistry,
+      metadata: resolved.metadata,
+      enumSerialization: resolved.enumSerialization,
+      vendorPrefix: resolved.vendorPrefix
     }
   );
 }
@@ -5829,6 +5789,7 @@ function omitApiName(metadata) {
 }
 function enforceRequiredMetadata(metadata, declarationKind, logicalName, options) {
   const declarationPolicy = getDeclarationMetadataPolicy(
+    // eslint-disable-next-line @typescript-eslint/no-deprecated -- migration bridge reads deprecated fields
     normalizeMetadataPolicy(options.metadata),
     declarationKind
   );
@@ -5903,6 +5864,7 @@ function toStandaloneJsonSchema(root, typeRegistry, options) {
       provenance: syntheticField.provenance
     },
     {
+      // eslint-disable-next-line @typescript-eslint/no-deprecated -- migration bridge reads deprecated fields
       policy: normalizeMetadataPolicy(options?.metadata),
       surface: "tsdoc",
       rootLogicalName: root.name
@@ -5911,8 +5873,11 @@ function toStandaloneJsonSchema(root, typeRegistry, options) {
   const schema = generateJsonSchemaFromIR(
     ir,
     {
+      // eslint-disable-next-line @typescript-eslint/no-deprecated -- migration bridge reads deprecated fields
       extensionRegistry: options?.extensionRegistry,
+      // eslint-disable-next-line @typescript-eslint/no-deprecated -- migration bridge reads deprecated fields
       enumSerialization: options?.enumSerialization,
+      // eslint-disable-next-line @typescript-eslint/no-deprecated -- migration bridge reads deprecated fields
       vendorPrefix: options?.vendorPrefix
     }
   );
@@ -5938,9 +5903,13 @@ function generateSchemasFromAnalysis(analysis, filePath, options) {
       analysis,
       { file: filePath },
       {
+        // eslint-disable-next-line @typescript-eslint/no-deprecated -- migration bridge reads deprecated fields
         extensionRegistry: options?.extensionRegistry,
+        // eslint-disable-next-line @typescript-eslint/no-deprecated -- migration bridge reads deprecated fields
         enumSerialization: options?.enumSerialization,
+        // eslint-disable-next-line @typescript-eslint/no-deprecated -- migration bridge reads deprecated fields
         metadata: options?.metadata,
+        // eslint-disable-next-line @typescript-eslint/no-deprecated -- migration bridge reads deprecated fields
         vendorPrefix: options?.vendorPrefix
       }
     ),
@@ -5965,7 +5934,9 @@ function generateSchemasFromResolvedType(options, skipNamedDeclaration = false,
     typeRegistry,
     /* @__PURE__ */ new Set(),
     options.sourceNode,
+    // eslint-disable-next-line @typescript-eslint/no-deprecated -- migration bridge reads deprecated fields
     createAnalyzerMetadataPolicy(options.metadata, options.discriminator),
+    // eslint-disable-next-line @typescript-eslint/no-deprecated -- migration bridge reads deprecated fields
     options.extensionRegistry,
     diagnostics
   );
@@ -6014,7 +5985,9 @@ function generateSchemasFromDeclaration(options) {
         options.declaration,
         options.context.checker,
         filePath,
+        // eslint-disable-next-line @typescript-eslint/no-deprecated -- migration bridge reads deprecated fields
         options.extensionRegistry,
+        // eslint-disable-next-line @typescript-eslint/no-deprecated -- migration bridge reads deprecated fields
         options.metadata,
         options.discriminator
       ),
@@ -6028,7 +6001,9 @@ function generateSchemasFromDeclaration(options) {
         options.declaration,
         options.context.checker,
         filePath,
+        // eslint-disable-next-line @typescript-eslint/no-deprecated -- migration bridge reads deprecated fields
         options.extensionRegistry,
+        // eslint-disable-next-line @typescript-eslint/no-deprecated -- migration bridge reads deprecated fields
         options.metadata,
         options.discriminator
       ),
@@ -6041,7 +6016,9 @@ function generateSchemasFromDeclaration(options) {
       options.declaration,
       options.context.checker,
       filePath,
+      // eslint-disable-next-line @typescript-eslint/no-deprecated -- migration bridge reads deprecated fields
       options.extensionRegistry,
+      // eslint-disable-next-line @typescript-eslint/no-deprecated -- migration bridge reads deprecated fields
       options.metadata,
       options.discriminator
     );
@@ -6052,7 +6029,9 @@ function generateSchemasFromDeclaration(options) {
       options.declaration,
       options.context.checker,
       filePath,
+      // eslint-disable-next-line @typescript-eslint/no-deprecated -- migration bridge reads deprecated fields
       options.extensionRegistry,
+      // eslint-disable-next-line @typescript-eslint/no-deprecated -- migration bridge reads deprecated fields
       options.metadata
     );
     if (aliasRootInfo.diagnostics.length > 0) {
@@ -6107,7 +6086,9 @@ function resolveDeclarationMetadata(options) {
   const analysis = analyzeMetadataForNodeWithChecker2({
     checker: options.context.checker,
     node: options.declaration,
+    // eslint-disable-next-line @typescript-eslint/no-deprecated -- migration bridge reads deprecated fields
     metadata: options.metadata,
+    // eslint-disable-next-line @typescript-eslint/no-deprecated -- migration bridge reads deprecated fields
     extensions: options.extensionRegistry?.extensions,
     buildContext: options.context
   });
@@ -6144,7 +6125,9 @@ function buildMixedAuthoringSchemas(options) {
   const analysis = analyzeNamedTypeToIR(
     filePath,
     typeName,
+    // eslint-disable-next-line @typescript-eslint/no-deprecated -- migration bridge reads deprecated fields
     schemaOptions.extensionRegistry,
+    // eslint-disable-next-line @typescript-eslint/no-deprecated -- migration bridge reads deprecated fields
     schemaOptions.metadata,
     schemaOptions.discriminator
   );
@@ -6152,6 +6135,7 @@ function buildMixedAuthoringSchemas(options) {
   const ir = canonicalizeTSDoc(
     composedAnalysis,
     { file: filePath },
+    // eslint-disable-next-line @typescript-eslint/no-deprecated -- migration bridge reads deprecated fields
     schemaOptions.metadata !== void 0 ? { metadata: schemaOptions.metadata } : void 0
   );
   return {