@formspec/build 0.1.0-alpha.42 → 0.1.0-alpha.44

package/dist/index.cjs

@@ -1594,7 +1594,7 @@ function generateCustomType(type, ctx) {
   }
   return registration.toJsonSchema(type.payload, ctx.vendorPrefix);
 }
-var JSON_SCHEMA_STRUCTURAL_KEYWORDS = /* @__PURE__ */ new Set([
+var VOCABULARY_MODE_BLOCKED_KEYWORDS = /* @__PURE__ */ new Set([
   "$schema",
   "$ref",
   "$defs",
@@ -1665,7 +1665,7 @@ function applyCustomConstraint(schema, constraint, ctx) {
   if (registration.emitsVocabularyKeywords) {
     const target = schema;
     for (const [key, value] of Object.entries(extensionSchema)) {
-      if (JSON_SCHEMA_STRUCTURAL_KEYWORDS.has(key)) {
+      if (VOCABULARY_MODE_BLOCKED_KEYWORDS.has(key)) {
         throw new Error(
           `Custom constraint "${constraint.constraintId}" with emitsVocabularyKeywords must not overwrite standard JSON Schema keyword "${key}"`
         );
@@ -2209,48 +2209,8 @@ var ts2 = __toESM(require("typescript"), 1);
 // src/analyzer/tsdoc-parser.ts
 var ts = __toESM(require("typescript"), 1);
 var import_internal2 = require("@formspec/analysis/internal");
-var import_tsdoc = require("@microsoft/tsdoc");
 var import_internals4 = require("@formspec/core/internals");
 var import_internals5 = require("@formspec/core/internals");
-var TAGS_REQUIRING_RAW_TEXT = /* @__PURE__ */ new Set(["pattern", "enumOptions", "defaultValue"]);
-function createFormSpecTSDocConfig(extensionTagNames = []) {
-  const config = new import_tsdoc.TSDocConfiguration();
-  for (const tagName of Object.keys(import_internals4.BUILTIN_CONSTRAINT_DEFINITIONS)) {
-    config.addTagDefinition(
-      new import_tsdoc.TSDocTagDefinition({
-        tagName: "@" + tagName,
-        syntaxKind: import_tsdoc.TSDocTagSyntaxKind.BlockTag,
-        allowMultiple: true
-      })
-    );
-  }
-  for (const tagName of ["apiName", "displayName", "format", "placeholder"]) {
-    config.addTagDefinition(
-      new import_tsdoc.TSDocTagDefinition({
-        tagName: "@" + tagName,
-        syntaxKind: import_tsdoc.TSDocTagSyntaxKind.BlockTag,
-        allowMultiple: true
-      })
-    );
-  }
-  for (const tagName of extensionTagNames) {
-    config.addTagDefinition(
-      new import_tsdoc.TSDocTagDefinition({
-        tagName: "@" + tagName,
-        syntaxKind: import_tsdoc.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 } : {},
@@ -2350,6 +2310,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 = (0, import_internal2.parseConstraintTagValue)(
+    tagName,
+    text,
+    provenance,
+    sharedTagValueOptions(options)
+  );
+  if (constraintNode) {
+    constraints.push(constraintNode);
+  }
+}
 function renderSyntheticArgumentExpression(valueKind, argumentText) {
   const trimmed = argumentText.trim();
   if (trimmed === "") {
@@ -2635,10 +2619,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) => (0, import_internal2.normalizeFormSpecTagName)(tag.tagName))
     ) ?? [],
@@ -2646,14 +2629,6 @@ function getParser(options) {
       (extension) => (extension.metadataSlots ?? []).map((slot) => (0, import_internal2.normalizeFormSpecTagName)(slot.tagName))
     ) ?? []
   ].sort();
-  const cacheKey = extensionTagNames.join("|");
-  const existing = parserCache.get(cacheKey);
-  if (existing) {
-    return existing;
-  }
-  const parser = new import_tsdoc.TSDocParser(createFormSpecTSDocConfig(extensionTagNames));
-  parserCache.set(cacheKey, parser);
-  return parser;
 }
 function getExtensionRegistryCacheKey(registry) {
   if (registry === void 0) {
@@ -2704,13 +2679,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) {
@@ -2720,38 +2695,18 @@ function parseTSDocTags(node, file = "", options) {
       if (!commentText.startsWith("/**")) {
         continue;
       }
-      const parser = getParser(options);
-      const parserContext = parser.parseRange(
-        import_tsdoc.TextRange.fromStringRange(sourceText, range.pos, range.end)
-      );
-      const docComment = parserContext.docComment;
-      const parsedComment = (0, import_internal2.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 = (0, import_internals4.normalizeConstraintTagName)(block.blockTag.tagName.substring(1));
-        const parsedTag = nextParsedTag(tagName);
+      const extensions = options?.extensionRegistry?.extensions;
+      const unified = (0, import_internal2.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) {
@@ -2776,64 +2731,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 = (0, import_internals4.isBuiltinConstraintName)(tagName) ? import_internals4.BUILTIN_CONSTRAINT_DEFINITIONS[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 (import_internal2.TAGS_REQUIRING_RAW_TEXT.has(tagName)) {
+          const fallback = rawTextFallbacks.get(tagName)?.shift();
+          const text2 = (0, import_internal2.choosePreferredPayloadText)(tag.resolvedPayloadText, fallback?.text ?? "");
+          if (text2 === "") continue;
+          const provenance2 = provenanceForParsedTag(tag, sourceFile, file);
+          if (tagName === "defaultValue") {
+            annotations.push((0, import_internal2.parseDefaultValueTagValue)(text2, provenance2));
+            continue;
+          }
+          processConstraintTag(
+            tagName,
+            text2,
+            tag,
+            provenance2,
+            node,
+            sourceFile,
+            supportingDeclarations,
+            options,
+            constraints,
+            diagnostics
+          );
           continue;
         }
-        const constraintNode = (0, import_internal2.parseConstraintTagValue)(
+        const text = tag.resolvedPayloadText;
+        const expectedType = (0, import_internals4.isBuiltinConstraintName)(tagName) ? import_internals4.BUILTIN_CONSTRAINT_DEFINITIONS[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")
+        });
       }
     }
   }
@@ -2853,77 +2813,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 = (0, import_internal2.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 = (0, import_internal2.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 = (0, import_internal2.parseDefaultValueTagValue)(text, provenance);
-        annotations.push(defaultValueNode);
+        annotations.push((0, import_internal2.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 = (0, import_internal2.parseConstraintTagValue)(
-        tagName,
-        text,
-        provenance,
-        sharedTagValueOptions(options)
+        options,
+        constraints,
+        diagnostics
       );
-      if (constraintNode) {
-        constraints.push(constraintNode);
-      }
     }
   }
   const result = { constraints, annotations, diagnostics };
@@ -2941,8 +2851,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 = (0, import_internal2.parseCommentBlock)(commentText);
-      for (const tag of parsed.tags) {
+      const unified = (0, import_internal2.parseUnifiedComment)(commentText);
+      for (const tag of unified.tags) {
         if (tag.normalizedTagName !== "displayName") {
           continue;
         }
@@ -2961,56 +2871,11 @@ function extractDisplayNameMetadata(node) {
     memberDisplayNames
   };
 }
-function extractBlockText(block) {
-  return extractPlainText(block.content);
-}
-function extractPlainText(node) {
-  let result = "";
-  if (node instanceof import_tsdoc.DocExcerpt) {
-    return node.content.toString();
-  }
-  if (node instanceof import_tsdoc.DocPlainText) {
-    return node.text;
-  }
-  if (node instanceof import_tsdoc.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 (0, import_internal2.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)) {
     const tagName = (0, import_internals4.normalizeConstraintTagName)(tag.tagName.text);
-    if (!TAGS_REQUIRING_RAW_TEXT.has(tagName)) continue;
+    if (!import_internal2.TAGS_REQUIRING_RAW_TEXT.has(tagName)) continue;
     const commentText = getTagCommentText(tag)?.trim() ?? "";
     if (commentText === "") continue;
     const entries = fallbacks.get(tagName) ?? [];
@@ -3119,6 +2984,31 @@ function isObjectType(type) {
 function isIntersectionType(type) {
   return !!(type.flags & ts3.TypeFlags.Intersection);
 }
+function isIntegerBrandedType(type) {
+  if (!type.isIntersection()) {
+    return false;
+  }
+  const hasNumberBase = type.types.some(
+    (member) => !!(member.flags & ts3.TypeFlags.Number)
+  );
+  if (!hasNumberBase) {
+    return false;
+  }
+  return type.getProperties().some((prop) => {
+    const declaration = prop.valueDeclaration ?? prop.declarations?.[0];
+    if (declaration === void 0) {
+      return false;
+    }
+    if (!ts3.isPropertySignature(declaration) && !ts3.isPropertyDeclaration(declaration)) {
+      return false;
+    }
+    const name = declaration.name;
+    if (!ts3.isComputedPropertyName(name)) {
+      return false;
+    }
+    return ts3.isIdentifier(name.expression) && name.expression.text === "__integerBrand";
+  });
+}
 function isResolvableObjectLikeAliasTypeNode(typeNode) {
   if (ts3.isParenthesizedTypeNode(typeNode)) {
     return isResolvableObjectLikeAliasTypeNode(typeNode.type);
@@ -4244,6 +4134,9 @@ function resolveTypeNode(type, checker, file, typeRegistry, visiting, sourceNode
   if (primitiveAlias) {
     return primitiveAlias;
   }
+  if (isIntegerBrandedType(type)) {
+    return { kind: "primitive", primitiveKind: "integer" };
+  }
   if (type.flags & ts3.TypeFlags.String) {
     return { kind: "primitive", primitiveKind: "string" };
   }
@@ -4346,7 +4239,7 @@ function resolveTypeNode(type, checker, file, typeRegistry, visiting, sourceNode
   return { kind: "primitive", primitiveKind: "string" };
 }
 function tryResolveNamedPrimitiveAlias(type, checker, file, typeRegistry, visiting, sourceNode, metadataPolicy = createAnalyzerMetadataPolicy(void 0), extensionRegistry, diagnostics) {
-  if (!(type.flags & (ts3.TypeFlags.String | ts3.TypeFlags.Number | ts3.TypeFlags.BigInt | ts3.TypeFlags.BigIntLiteral | ts3.TypeFlags.Boolean | ts3.TypeFlags.Null))) {
+  if (!(type.flags & (ts3.TypeFlags.String | ts3.TypeFlags.Number | ts3.TypeFlags.BigInt | ts3.TypeFlags.BigIntLiteral | ts3.TypeFlags.Boolean | ts3.TypeFlags.Null)) && !isIntegerBrandedType(type)) {
     return null;
   }
   const aliasDecl = type.aliasSymbol?.declarations?.find(ts3.isTypeAliasDeclaration) ?? getReferencedTypeAliasDeclaration(sourceNode, checker);
@@ -4432,6 +4325,9 @@ function resolveAliasedPrimitiveTarget(type, checker, file, typeRegistry, visiti
       visitedAliases
     );
   }
+  if (isIntegerBrandedType(type)) {
+    return { kind: "primitive", primitiveKind: "integer" };
+  }
   if (type.flags & ts3.TypeFlags.String) {
     return { kind: "primitive", primitiveKind: "string" };
   }
@@ -4655,7 +4551,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) {
@@ -5646,7 +5542,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
   );
@@ -5654,9 +5552,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
     }
   );
@@ -5703,7 +5605,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({
@@ -5721,7 +5628,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();
@@ -5765,13 +5677,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) {
@@ -5784,10 +5710,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
     }
   );
 }
@@ -5924,6 +5850,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
   );
@@ -5998,6 +5925,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
@@ -6006,8 +5934,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
     }
   );
@@ -6033,9 +5964,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
       }
     ),
@@ -6060,7 +5995,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
   );
@@ -6109,7 +6046,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
       ),
@@ -6123,7 +6062,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
       ),
@@ -6136,7 +6077,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
     );
@@ -6147,7 +6090,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) {
@@ -6202,7 +6147,9 @@ function resolveDeclarationMetadata(options) {
   const analysis = (0, import_internal5.analyzeMetadataForNodeWithChecker)({
     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
   });
@@ -6239,7 +6186,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
   );
@@ -6247,6 +6196,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 {