@formspec/build 0.1.0-alpha.37 → 0.1.0-alpha.39

package/dist/index.cjs

@@ -37,10 +37,14 @@ __export(index_exports, {
   createStaticBuildContextFromProgram: () => createStaticBuildContextFromProgram,
   generateJsonSchema: () => generateJsonSchema,
   generateSchemas: () => generateSchemas,
+  generateSchemasBatch: () => generateSchemasBatch,
+  generateSchemasBatchFromProgram: () => generateSchemasBatchFromProgram,
+  generateSchemasDetailed: () => generateSchemasDetailed,
   generateSchemasFromClass: () => generateSchemasFromClass,
   generateSchemasFromDeclaration: () => generateSchemasFromDeclaration,
   generateSchemasFromParameter: () => generateSchemasFromParameter,
   generateSchemasFromProgram: () => generateSchemasFromProgram,
+  generateSchemasFromProgramDetailed: () => generateSchemasFromProgramDetailed,
   generateSchemasFromReturnType: () => generateSchemasFromReturnType,
   generateSchemasFromType: () => generateSchemasFromType,
   generateUiSchema: () => generateUiSchema,
@@ -2019,7 +2023,7 @@ var jsonSchema7Schema = import_zod3.z.lazy(
 );
 
 // src/generators/class-schema.ts
-var ts5 = require("typescript");
+var ts5 = __toESM(require("typescript"), 1);
 
 // src/analyzer/program.ts
 var ts4 = __toESM(require("typescript"), 1);
@@ -2166,6 +2170,16 @@ function buildSupportingDeclarations(sourceFile, extensionTypeNames) {
     return true;
   }).map((statement) => statement.getText(sourceFile));
 }
+function pushUniqueCompilerDiagnostics(target, additions) {
+  for (const diagnostic of additions) {
+    if ((diagnostic.code === "UNSUPPORTED_CUSTOM_TYPE_OVERRIDE" || diagnostic.code === "SYNTHETIC_SETUP_FAILURE") && target.some(
+      (existing) => existing.code === diagnostic.code && existing.message === diagnostic.message
+    )) {
+      continue;
+    }
+    target.push(diagnostic);
+  }
+}
 function renderSyntheticArgumentExpression(valueKind, argumentText) {
   const trimmed = argumentText.trim();
   if (trimmed === "") {
@@ -2432,6 +2446,16 @@ function buildCompilerBackedConstraintDiagnostics(node, sourceFile, tagName, par
   if (result.diagnostics.length === 0) {
     return [];
   }
+  const setupDiagnostic = result.diagnostics.find((diagnostic) => diagnostic.kind !== "typescript");
+  if (setupDiagnostic !== void 0) {
+    return [
+      makeDiagnostic(
+        setupDiagnostic.kind === "unsupported-custom-type-override" ? "UNSUPPORTED_CUSTOM_TYPE_OVERRIDE" : "SYNTHETIC_SETUP_FAILURE",
+        setupDiagnostic.message,
+        provenance
+      )
+    ];
+  }
   const expectedLabel = definition.valueKind === null ? "compatible argument" : capabilityLabel(definition.valueKind);
   return [
     makeDiagnostic(
@@ -2597,7 +2621,7 @@ function parseTSDocTags(node, file = "", options) {
           options
         );
         if (compilerDiagnostics.length > 0) {
-          diagnostics.push(...compilerDiagnostics);
+          pushUniqueCompilerDiagnostics(diagnostics, compilerDiagnostics);
           continue;
         }
         const constraintNode = (0, import_internal2.parseConstraintTagValue)(
@@ -2684,7 +2708,7 @@ function parseTSDocTags(node, file = "", options) {
         options
       );
       if (compilerDiagnostics.length > 0) {
-        diagnostics.push(...compilerDiagnostics);
+        pushUniqueCompilerDiagnostics(diagnostics, compilerDiagnostics);
         continue;
       }
       const constraintNode = (0, import_internal2.parseConstraintTagValue)(
@@ -2718,7 +2742,7 @@ function parseTSDocTags(node, file = "", options) {
         options
       );
       if (compilerDiagnostics.length > 0) {
-        diagnostics.push(...compilerDiagnostics);
+        pushUniqueCompilerDiagnostics(diagnostics, compilerDiagnostics);
         continue;
       }
       const constraintNode = (0, import_internal2.parseConstraintTagValue)(
@@ -5142,29 +5166,35 @@ function analyzeNamedTypeToIR(filePath, typeName, extensionRegistry, metadataPol
     discriminatorOptions
   );
 }
-function analyzeNamedTypeToIRFromProgramContext(ctx, filePath, typeName, extensionRegistry, metadataPolicy, discriminatorOptions) {
+function analyzeNamedTypeToIRFromProgramContextDetailed(ctx, filePath, typeName, extensionRegistry, metadataPolicy, discriminatorOptions) {
   const analysisFilePath = path.resolve(filePath);
   const classDecl = findClassByName(ctx.sourceFile, typeName);
   if (classDecl !== null) {
-    return analyzeClassToIR(
-      classDecl,
-      ctx.checker,
-      analysisFilePath,
-      extensionRegistry,
-      metadataPolicy,
-      discriminatorOptions
-    );
+    return {
+      ok: true,
+      analysis: analyzeClassToIR(
+        classDecl,
+        ctx.checker,
+        analysisFilePath,
+        extensionRegistry,
+        metadataPolicy,
+        discriminatorOptions
+      )
+    };
   }
   const interfaceDecl = findInterfaceByName(ctx.sourceFile, typeName);
   if (interfaceDecl !== null) {
-    return analyzeInterfaceToIR(
-      interfaceDecl,
-      ctx.checker,
-      analysisFilePath,
-      extensionRegistry,
-      metadataPolicy,
-      discriminatorOptions
-    );
+    return {
+      ok: true,
+      analysis: analyzeInterfaceToIR(
+        interfaceDecl,
+        ctx.checker,
+        analysisFilePath,
+        extensionRegistry,
+        metadataPolicy,
+        discriminatorOptions
+      )
+    };
   }
   const typeAlias = findTypeAliasByName(ctx.sourceFile, typeName);
   if (typeAlias !== null) {
@@ -5177,11 +5207,20 @@ function analyzeNamedTypeToIRFromProgramContext(ctx, filePath, typeName, extensi
       discriminatorOptions
     );
     if (result.ok) {
-      return result.analysis;
+      return { ok: true, analysis: result.analysis };
     }
     const fallbackEligible = result.kind === "not-object-like" && isResolvableObjectLikeAliasTypeNode(typeAlias.type) && containsTypeReferenceInObjectLikeAlias(typeAlias.type);
     if (!fallbackEligible) {
-      throw new Error(result.error);
+      return {
+        ok: false,
+        diagnostics: [
+          makeProgramDiagnostic(
+            result.kind === "duplicate-properties" ? "DUPLICATE_ROOT_PROPERTIES" : "UNSUPPORTED_ROOT_TYPE",
+            result.error,
+            makeNodeProvenance(typeAlias, analysisFilePath)
+          )
+        ]
+      };
     }
     const duplicatePropertyNames = findFallbackAliasDuplicatePropertyNames(
       typeAlias.type,
@@ -5190,9 +5229,16 @@ function analyzeNamedTypeToIRFromProgramContext(ctx, filePath, typeName, extensi
     if (duplicatePropertyNames.length > 0) {
       const sourceFile = typeAlias.getSourceFile();
       const { line } = sourceFile.getLineAndCharacterOfPosition(typeAlias.getStart());
-      throw new Error(
-        `Type alias "${typeAlias.name.text}" at line ${String(line + 1)} contains duplicate property names across object-like members: ${duplicatePropertyNames.join(", ")}`
-      );
+      return {
+        ok: false,
+        diagnostics: [
+          makeProgramDiagnostic(
+            "DUPLICATE_ROOT_PROPERTIES",
+            `Type alias "${typeAlias.name.text}" at line ${String(line + 1)} contains duplicate property names across object-like members: ${duplicatePropertyNames.join(", ")}`,
+            makeNodeProvenance(typeAlias, analysisFilePath)
+          )
+        ]
+      };
     }
     const rootInfo = analyzeDeclarationRootInfo(
       typeAlias,
@@ -5222,13 +5268,71 @@ function analyzeNamedTypeToIRFromProgramContext(ctx, filePath, typeName, extensi
       diagnostics
     );
     if (fallbackAnalysis !== null) {
-      return fallbackAnalysis;
+      return { ok: true, analysis: fallbackAnalysis };
     }
-    throw new Error(result.error);
+    return {
+      ok: false,
+      diagnostics: [
+        makeProgramDiagnostic(
+          "UNSUPPORTED_ROOT_TYPE",
+          result.error,
+          makeNodeProvenance(typeAlias, analysisFilePath)
+        )
+      ]
+    };
   }
-  throw new Error(
-    `Type "${typeName}" not found as a class, interface, or type alias in ${analysisFilePath}`
+  return {
+    ok: false,
+    diagnostics: [
+      makeProgramDiagnostic(
+        "TYPE_NOT_FOUND",
+        `Type "${typeName}" not found as a class, interface, or type alias in ${analysisFilePath}`,
+        makeFileProvenance(analysisFilePath)
+      )
+    ]
+  };
+}
+function analyzeNamedTypeToIRFromProgramContext(ctx, filePath, typeName, extensionRegistry, metadataPolicy, discriminatorOptions) {
+  const result = analyzeNamedTypeToIRFromProgramContextDetailed(
+    ctx,
+    filePath,
+    typeName,
+    extensionRegistry,
+    metadataPolicy,
+    discriminatorOptions
   );
+  if (result.ok) {
+    return result.analysis;
+  }
+  throw new Error(result.diagnostics.map((diagnostic) => diagnostic.message).join("\n"));
+}
+function makeProgramDiagnostic(code, message, primaryLocation) {
+  return {
+    code,
+    message,
+    severity: "error",
+    primaryLocation,
+    relatedLocations: []
+  };
+}
+function makeNodeProvenance(node, filePath) {
+  const sourceFile = node.getSourceFile();
+  const position = sourceFile.getLineAndCharacterOfPosition(node.getStart());
+  return {
+    surface: "tsdoc",
+    file: filePath,
+    line: position.line + 1,
+    column: position.character,
+    length: node.getWidth()
+  };
+}
+function makeFileProvenance(filePath) {
+  return {
+    surface: "tsdoc",
+    file: filePath,
+    line: 1,
+    column: 0
+  };
 }
 
 // src/validate/constraint-validator.ts
@@ -5306,11 +5410,25 @@ function validateIR(ir, options) {
 
 // src/generators/class-schema.ts
 function generateClassSchemas(analysis, source, options) {
-  const errorDiagnostics = analysis.diagnostics?.filter(
+  const result = generateClassSchemasDetailed(analysis, source, options);
+  if (!result.ok || result.jsonSchema === void 0 || result.uiSchema === void 0) {
+    throw new Error(formatValidationError(result.diagnostics));
+  }
+  return {
+    jsonSchema: result.jsonSchema,
+    uiSchema: result.uiSchema
+  };
+}
+function generateClassSchemasDetailed(analysis, source, options) {
+  const analysisDiagnostics = analysis.diagnostics ?? [];
+  const errorDiagnostics = analysisDiagnostics.filter(
     (diagnostic) => diagnostic.severity === "error"
   );
-  if (errorDiagnostics !== void 0 && errorDiagnostics.length > 0) {
-    throw new Error(formatValidationError(errorDiagnostics));
+  if (errorDiagnostics.length > 0) {
+    return {
+      ok: false,
+      diagnostics: analysisDiagnostics
+    };
   }
   const ir = canonicalizeTSDoc(
     analysis,
@@ -5324,9 +5442,14 @@ function generateClassSchemas(analysis, source, options) {
     ...options?.vendorPrefix !== void 0 && { vendorPrefix: options.vendorPrefix }
   });
   if (!validationResult.valid) {
-    throw new Error(formatValidationError(validationResult.diagnostics));
+    return {
+      ok: false,
+      diagnostics: [...analysisDiagnostics, ...validationResult.diagnostics]
+    };
   }
   return {
+    ok: true,
+    diagnostics: [...analysisDiagnostics, ...validationResult.diagnostics],
     jsonSchema: generateJsonSchemaFromIR(ir, options),
     uiSchema: generateUiSchemaFromIR(ir)
   };
@@ -5368,25 +5491,127 @@ function generateSchemasFromClass(options) {
   );
 }
 function generateSchemas(options) {
-  const ctx = createProgramContext(options.filePath);
+  const result = generateSchemasDetailedInternal(options);
+  if (options.errorReporting === "diagnostics") {
+    return result;
+  }
+  if (!result.ok || result.jsonSchema === void 0 || result.uiSchema === void 0) {
+    throw new Error(formatValidationError(result.diagnostics));
+  }
+  return {
+    jsonSchema: result.jsonSchema,
+    uiSchema: result.uiSchema
+  };
+}
+function generateSchemasFromProgram(options) {
+  const result = generateSchemasFromProgramDetailedInternal(options);
+  if (options.errorReporting === "diagnostics") {
+    return result;
+  }
+  if (!result.ok || result.jsonSchema === void 0 || result.uiSchema === void 0) {
+    throw new Error(formatValidationError(result.diagnostics));
+  }
+  return {
+    jsonSchema: result.jsonSchema,
+    uiSchema: result.uiSchema
+  };
+}
+function generateSchemasDetailed(options) {
+  return generateSchemas({
+    ...options,
+    errorReporting: "diagnostics"
+  });
+}
+function generateSchemasDetailedInternal(options) {
+  let ctx;
+  try {
+    ctx = createProgramContext(options.filePath);
+  } catch (error) {
+    return {
+      ok: false,
+      diagnostics: [createProgramContextFailureDiagnostic(options.filePath, error)]
+    };
+  }
+  return generateSchemasFromDetailedProgramContext(ctx, options.filePath, options.typeName, options);
+}
+function generateSchemasFromProgramDetailed(options) {
   return generateSchemasFromProgram({
     ...options,
-    program: ctx.program
+    errorReporting: "diagnostics"
   });
 }
-function generateSchemasFromProgram(options) {
-  const ctx = createProgramContextFromProgram(options.program, options.filePath);
-  const analysis = analyzeNamedTypeToIRFromProgramContext(
+function generateSchemasFromProgramDetailedInternal(options) {
+  let ctx;
+  try {
+    ctx = createProgramContextFromProgram(options.program, options.filePath);
+  } catch (error) {
+    return {
+      ok: false,
+      diagnostics: [createProgramContextFailureDiagnostic(options.filePath, error)]
+    };
+  }
+  return generateSchemasFromDetailedProgramContext(ctx, options.filePath, options.typeName, options);
+}
+function generateSchemasBatch(options) {
+  const contextCache = /* @__PURE__ */ new Map();
+  return options.targets.map((target) => {
+    let ctx;
+    try {
+      const cacheKey = ts5.sys.useCaseSensitiveFileNames ? target.filePath : target.filePath.toLowerCase();
+      const cachedContext = contextCache.get(cacheKey);
+      if (cachedContext === void 0) {
+        ctx = createProgramContext(target.filePath);
+        contextCache.set(cacheKey, ctx);
+      } else {
+        ctx = cachedContext;
+      }
+    } catch (error) {
+      return withTarget(target, {
+        ok: false,
+        diagnostics: [createProgramContextFailureDiagnostic(target.filePath, error)]
+      });
+    }
+    return withTarget(
+      target,
+      generateSchemasFromDetailedProgramContext(ctx, target.filePath, target.typeName, options)
+    );
+  });
+}
+function generateSchemasBatchFromProgram(options) {
+  return options.targets.map((target) => {
+    let ctx;
+    try {
+      ctx = createProgramContextFromProgram(options.program, target.filePath);
+    } catch (error) {
+      return withTarget(target, {
+        ok: false,
+        diagnostics: [createProgramContextFailureDiagnostic(target.filePath, error)]
+      });
+    }
+    return withTarget(
+      target,
+      generateSchemasFromDetailedProgramContext(ctx, target.filePath, target.typeName, options)
+    );
+  });
+}
+function generateSchemasFromDetailedProgramContext(ctx, filePath, typeName, options) {
+  const analysisResult = analyzeNamedTypeToIRFromProgramContextDetailed(
     ctx,
-    options.filePath,
-    options.typeName,
+    filePath,
+    typeName,
     options.extensionRegistry,
     options.metadata,
     options.discriminator
   );
-  return generateClassSchemas(
-    analysis,
-    { file: options.filePath },
+  if (!analysisResult.ok) {
+    return {
+      ok: false,
+      diagnostics: analysisResult.diagnostics
+    };
+  }
+  return generateClassSchemasDetailed(
+    analysisResult.analysis,
+    { file: filePath },
     {
       extensionRegistry: options.extensionRegistry,
       metadata: options.metadata,
@@ -5394,6 +5619,27 @@ function generateSchemasFromProgram(options) {
     }
   );
 }
+function withTarget(target, result) {
+  return {
+    filePath: target.filePath,
+    typeName: target.typeName,
+    ...result
+  };
+}
+function createProgramContextFailureDiagnostic(filePath, error) {
+  return {
+    code: "PROGRAM_CONTEXT_FAILURE",
+    message: error instanceof Error ? error.message : String(error),
+    severity: "error",
+    primaryLocation: {
+      surface: "tsdoc",
+      file: filePath,
+      line: 1,
+      column: 0
+    },
+    relatedLocations: []
+  };
+}
 
 // src/static-build.ts
 var ts6 = __toESM(require("typescript"), 1);
@@ -5431,8 +5677,11 @@ function resolveModuleExportDeclaration(context, exportName = "default") {
 // src/generators/discovered-schema.ts
 var ts7 = __toESM(require("typescript"), 1);
 var import_internals6 = require("@formspec/core/internals");
-function toDiscoveredTypeSchemas(result) {
-  return result;
+function toDiscoveredTypeSchemas(result, resolvedMetadata) {
+  return {
+    ...result,
+    ...resolvedMetadata !== void 0 && { resolvedMetadata }
+  };
 }
 function isNamedTypeDeclaration(declaration) {
   return ts7.isClassDeclaration(declaration) || ts7.isInterfaceDeclaration(declaration) || ts7.isTypeAliasDeclaration(declaration);
@@ -5580,7 +5829,8 @@ function generateSchemasFromAnalysis(analysis, filePath, options) {
         metadata: options?.metadata,
         vendorPrefix: options?.vendorPrefix
       }
-    )
+    ),
+    analysis.metadata
   );
 }
 function generateSchemasFromResolvedType(options, skipNamedDeclaration = false, rootOverride) {
@@ -5638,7 +5888,8 @@ function generateSchemasFromResolvedType(options, skipNamedDeclaration = false,
   }
   return {
     jsonSchema: toStandaloneJsonSchema(root, typeRegistry, options),
-    uiSchema: null
+    uiSchema: null,
+    ...root.metadata !== void 0 && { resolvedMetadata: root.metadata }
   };
 }
 function generateSchemasFromDeclaration(options) {
@@ -5978,10 +6229,14 @@ function writeSchemas(form, options) {
   createStaticBuildContextFromProgram,
   generateJsonSchema,
   generateSchemas,
+  generateSchemasBatch,
+  generateSchemasBatchFromProgram,
+  generateSchemasDetailed,
   generateSchemasFromClass,
   generateSchemasFromDeclaration,
   generateSchemasFromParameter,
   generateSchemasFromProgram,
+  generateSchemasFromProgramDetailed,
   generateSchemasFromReturnType,
   generateSchemasFromType,
   generateUiSchema,