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

package/dist/cli.js

@@ -1604,7 +1604,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}"`
         );
@@ -1647,13 +1647,13 @@ function assignVendorPrefixedExtensionKeywords(schema, extensionSchema, vendorPr
     schema[key] = value;
   }
 }
-var JSON_SCHEMA_STRUCTURAL_KEYWORDS;
+var VOCABULARY_MODE_BLOCKED_KEYWORDS;
 var init_ir_generator = __esm({
   "src/json-schema/ir-generator.ts"() {
     "use strict";
     init_metadata();
     init_collision_guards();
-    JSON_SCHEMA_STRUCTURAL_KEYWORDS = /* @__PURE__ */ new Set([
+    VOCABULARY_MODE_BLOCKED_KEYWORDS = /* @__PURE__ */ new Set([
       "$schema",
       "$ref",
       "$defs",
@@ -2253,72 +2253,25 @@ var init_schema2 = __esm({
 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";
-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 } : {},
@@ -2417,6 +2370,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 === "") {
@@ -2702,8 +2679,8 @@ function buildCompilerBackedConstraintDiagnostics(node, sourceFile, tagName, par
     )
   ];
 }
-function getParser(options) {
-  const extensionTagNames = [
+function getExtensionTagNames(options) {
+  return [
     ...options?.extensionRegistry?.extensions.flatMap(
       (extension) => (extension.constraintTags ?? []).map((tag) => normalizeFormSpecTagName2(tag.tagName))
     ) ?? [],
@@ -2711,14 +2688,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) {
@@ -2769,13 +2738,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) {
@@ -2785,38 +2754,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) {
@@ -2841,64 +2790,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")
+        });
       }
     }
   }
@@ -2918,77 +2872,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 };
@@ -3006,8 +2910,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;
         }
@@ -3026,51 +2930,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)) {
@@ -3130,13 +2989,11 @@ function getTagCommentText(tag) {
   }
   return ts.getTextOfJSDocComment(tag.comment);
 }
-var TAGS_REQUIRING_RAW_TEXT, SYNTHETIC_TYPE_FORMAT_FLAGS, parserCache, parseResultCache;
+var SYNTHETIC_TYPE_FORMAT_FLAGS, parseResultCache;
 var init_tsdoc_parser = __esm({
   "src/analyzer/tsdoc-parser.ts"() {
     "use strict";
-    TAGS_REQUIRING_RAW_TEXT = /* @__PURE__ */ new Set(["pattern", "enumOptions", "defaultValue"]);
     SYNTHETIC_TYPE_FORMAT_FLAGS = ts.TypeFormatFlags.NoTruncation | ts.TypeFormatFlags.UseAliasDefinedOutsideCurrentScope;
-    parserCache = /* @__PURE__ */ new Map();
     parseResultCache = /* @__PURE__ */ new Map();
   }
 });
@@ -3198,7 +3055,7 @@ var init_jsdoc_constraints = __esm({
 import * as ts3 from "typescript";
 import {
   analyzeMetadataForNodeWithChecker,
-  parseCommentBlock as parseCommentBlock2
+  parseCommentBlock
 } from "@formspec/analysis/internal";
 function isObjectType(type) {
   return !!(type.flags & ts3.TypeFlags.Object);
@@ -3206,6 +3063,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);
@@ -3585,7 +3467,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;
 }
@@ -4326,6 +4208,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" };
   }
@@ -4428,7 +4313,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);
@@ -4514,6 +4399,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" };
   }
@@ -4737,7 +4625,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) {
@@ -5766,7 +5654,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
   );
@@ -5774,9 +5664,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
     }
   );
@@ -5823,7 +5717,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({
@@ -5841,7 +5740,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();
@@ -5885,13 +5789,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) {
@@ -5904,10 +5822,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
     }
   );
 }
@@ -5939,6 +5857,7 @@ var init_class_schema = __esm({
     init_class_analyzer();
     init_canonicalize();
     init_ir_generator();
+    init_extensions();
     init_ir_generator2();
     init_validate();
   }
@@ -6061,6 +5980,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
   );
@@ -6135,6 +6055,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
@@ -6143,8 +6064,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
     }
   );
@@ -6170,9 +6094,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
       }
     ),
@@ -6197,7 +6125,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
   );
@@ -6246,7 +6176,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
       ),
@@ -6260,7 +6192,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
       ),
@@ -6273,7 +6207,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
     );
@@ -6284,7 +6220,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) {
@@ -6339,7 +6277,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
   });
@@ -6385,7 +6325,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
   );
@@ -6393,6 +6335,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 {