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

package/dist/validate/constraint-validator.d.ts

@@ -7,17 +7,79 @@
  *
  * @packageDocumentation
  */
-import { type ConstraintSemanticDiagnostic } from "@formspec/analysis/internal";
 import type { FormIR } from "@formspec/core/internals";
 import type { ExtensionRegistry } from "../extensions/index.js";
-export type ValidationDiagnostic = ConstraintSemanticDiagnostic;
+/**
+ * Supported severity levels returned by static build validation.
+ *
+ * @public
+ */
+export type ValidationDiagnosticSeverity = "error" | "warning";
+/**
+ * Public source-location shape attached to validation diagnostics.
+ *
+ * This mirrors the provenance information surfaced by the shared analysis
+ * layer without exposing `@formspec/core/internals` through the public API.
+ *
+ * @public
+ */
+export interface ValidationDiagnosticLocation {
+    /** Authoring surface that produced the diagnostic location. */
+    readonly surface: "tsdoc" | "chain-dsl" | "extension" | "inferred";
+    /** Absolute path to the source file. */
+    readonly file: string;
+    /** 1-based line number in the source file. */
+    readonly line: number;
+    /** 0-based column number in the source file. */
+    readonly column: number;
+    /** Optional span length in characters. */
+    readonly length?: number;
+    /** Optional tag or construct associated with the location. */
+    readonly tagName?: string;
+}
+/**
+ * A machine-readable validation diagnostic returned by static schema analysis.
+ *
+ * @public
+ */
+export interface ValidationDiagnostic {
+    /** Stable machine-readable diagnostic code. */
+    readonly code: string;
+    /** Human-readable explanation of the validation problem. */
+    readonly message: string;
+    /** Severity of the reported validation problem. */
+    readonly severity: ValidationDiagnosticSeverity;
+    /** Primary source location associated with the diagnostic. */
+    readonly primaryLocation: ValidationDiagnosticLocation;
+    /** Related source locations that add context to the diagnostic. */
+    readonly relatedLocations: readonly ValidationDiagnosticLocation[];
+}
+/**
+ * Result of validating canonical FormIR before schema emission.
+ *
+ * @public
+ */
 export interface ValidationResult {
+    /** Diagnostics produced during validation. */
     readonly diagnostics: readonly ValidationDiagnostic[];
+    /** Whether any error-severity diagnostics were produced. */
     readonly valid: boolean;
 }
+/**
+ * Options for validating canonical FormIR.
+ *
+ * @public
+ */
 export interface ValidateIROptions {
+    /** Vendor prefix used when resolving extension-backed keywords. */
     readonly vendorPrefix?: string;
+    /** Extension registry used to resolve custom constraints and types. */
     readonly extensionRegistry?: ExtensionRegistry;
 }
+/**
+ * Validates canonical FormIR and returns all discovered diagnostics.
+ *
+ * @public
+ */
 export declare function validateIR(ir: FormIR, options?: ValidateIROptions): ValidationResult;
 //# sourceMappingURL=constraint-validator.d.ts.map

package/dist/validate/constraint-validator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constraint-validator.d.ts","sourceRoot":"","sources":["../../src/validate/constraint-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAGL,KAAK,4BAA4B,EAClC,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,MAAM,EAA4C,MAAM,0BAA0B,CAAC;AACjG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,MAAM,MAAM,oBAAoB,GAAG,4BAA4B,CAAC;AAEhE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,WAAW,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACtD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;CAChD;AA6ED,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,gBAAgB,CAepF"}
+{"version":3,"file":"constraint-validator.d.ts","sourceRoot":"","sources":["../../src/validate/constraint-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EAAE,MAAM,EAA4C,MAAM,0BAA0B,CAAC;AACjG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE;;;;GAIG;AACH,MAAM,MAAM,4BAA4B,GAAG,OAAO,GAAG,SAAS,CAAC;AAE/D;;;;;;;GAOG;AACH,MAAM,WAAW,4BAA4B;IAC3C,+DAA+D;IAC/D,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,WAAW,GAAG,WAAW,GAAG,UAAU,CAAC;IACnE,wCAAwC;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,gDAAgD;IAChD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,mDAAmD;IACnD,QAAQ,CAAC,QAAQ,EAAE,4BAA4B,CAAC;IAChD,8DAA8D;IAC9D,QAAQ,CAAC,eAAe,EAAE,4BAA4B,CAAC;IACvD,mEAAmE;IACnE,QAAQ,CAAC,gBAAgB,EAAE,SAAS,4BAA4B,EAAE,CAAC;CACpE;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8CAA8C;IAC9C,QAAQ,CAAC,WAAW,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACtD,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,mEAAmE;IACnE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,uEAAuE;IACvE,QAAQ,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;CAChD;AA6ED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,gBAAgB,CAepF"}

package/dist/validate/index.d.ts

@@ -4,6 +4,6 @@
  * @packageDocumentation
  */
 export { validateIR } from "./constraint-validator.js";
-export type { ValidationDiagnostic, ValidationResult, ValidateIROptions, } from "./constraint-validator.js";
+export type { ValidationDiagnostic, ValidationDiagnosticLocation, ValidationDiagnosticSeverity, ValidationResult, ValidateIROptions, } from "./constraint-validator.js";
 export type { ExtensionRegistry } from "../extensions/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/validate/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validate/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,YAAY,EACV,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,2BAA2B,CAAC;AAGnC,YAAY,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validate/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,YAAY,EACV,oBAAoB,EACpB,4BAA4B,EAC5B,4BAA4B,EAC5B,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,2BAA2B,CAAC;AAGnC,YAAY,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@formspec/build",
-  "version": "0.1.0-alpha.38",
+  "version": "0.1.0-alpha.39",
   "description": "Build tools to compile FormSpec forms to JSON Schema and UI Schema",
   "type": "module",
   "main": "./dist/index.cjs",