raffel 0.1.2

package/dist/usd/validator/index.d.ts

@@ -0,0 +1,68 @@
+/**
+ * USD Validator Module
+ *
+ * Provides comprehensive validation for USD documents including:
+ * - JSON Schema validation
+ * - Semantic validation (references, consistency)
+ * - Protocol-specific validation
+ */
+import type { USDValidationResult } from '../spec/types.js';
+export { validateSchema, getSchema } from './schema.js';
+export { validateSemantic } from './semantic.js';
+export { ValidationErrorCodes, createError, createWarning, createSuccessResult, createFailedResult, mergeResults, formatValidationResult, } from './errors.js';
+/**
+ * Validation options
+ */
+export interface ValidateOptions {
+    /**
+     * Treat warnings as errors
+     * @default false
+     */
+    strict?: boolean;
+    /**
+     * Skip schema validation
+     * @default false
+     */
+    skipSchema?: boolean;
+    /**
+     * Skip semantic validation
+     * @default false
+     */
+    skipSemantic?: boolean;
+}
+/**
+ * Validate a USD document
+ *
+ * @param doc - USD document to validate
+ * @param options - Validation options
+ * @returns Validation result
+ *
+ * @example
+ * ```typescript
+ * const result = validate(doc)
+ * if (!result.valid) {
+ *   console.log(formatValidationResult(result))
+ * }
+ * ```
+ */
+export declare function validate(doc: unknown, options?: ValidateOptions): USDValidationResult;
+/**
+ * Validate and throw if invalid
+ *
+ * @param doc - USD document to validate
+ * @param options - Validation options
+ * @throws Error if document is invalid
+ */
+export declare function validateOrThrow(doc: unknown, options?: ValidateOptions): void;
+/**
+ * Quick check if document is valid (no details)
+ */
+export declare function isValid(doc: unknown, options?: ValidateOptions): boolean;
+/**
+ * Validation exception class for programmatic error handling
+ */
+export declare class USDValidationException extends Error {
+    readonly result: USDValidationResult;
+    constructor(message: string, result: USDValidationResult);
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/usd/validator/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/usd/validator/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAe,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AAWxE,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAChD,OAAO,EACL,oBAAoB,EACpB,WAAW,EACX,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,EACZ,sBAAsB,GACvB,MAAM,aAAa,CAAA;AAEpB;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;IAEhB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IAEpB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,GAAE,eAAoB,GAAG,mBAAmB,CAyBzF;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,GAAE,eAAoB,GAAG,IAAI,CAOjF;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAE5E;AAWD;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;aAG7B,MAAM,EAAE,mBAAmB;gBAD3C,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,mBAAmB;CAK9C"}

package/dist/usd/validator/index.js

@@ -0,0 +1,92 @@
+/**
+ * USD Validator Module
+ *
+ * Provides comprehensive validation for USD documents including:
+ * - JSON Schema validation
+ * - Semantic validation (references, consistency)
+ * - Protocol-specific validation
+ */
+import { validateSchema } from './schema.js';
+import { validateSemantic } from './semantic.js';
+import { mergeResults, formatValidationResult, } from './errors.js';
+// Re-export
+export { validateSchema, getSchema } from './schema.js';
+export { validateSemantic } from './semantic.js';
+export { ValidationErrorCodes, createError, createWarning, createSuccessResult, createFailedResult, mergeResults, formatValidationResult, } from './errors.js';
+/**
+ * Validate a USD document
+ *
+ * @param doc - USD document to validate
+ * @param options - Validation options
+ * @returns Validation result
+ *
+ * @example
+ * ```typescript
+ * const result = validate(doc)
+ * if (!result.valid) {
+ *   console.log(formatValidationResult(result))
+ * }
+ * ```
+ */
+export function validate(doc, options = {}) {
+    const results = [];
+    // Schema validation
+    if (!options.skipSchema) {
+        results.push(validateSchema(doc));
+    }
+    // Semantic validation (only if schema passes)
+    if (!options.skipSemantic && isUSDDocumentLike(doc)) {
+        results.push(validateSemantic(doc));
+    }
+    const merged = mergeResults(...results);
+    // In strict mode, warnings become errors
+    if (options.strict && merged.warnings.length > 0) {
+        return {
+            valid: false,
+            errors: [...merged.errors, ...merged.warnings.map((w) => ({ ...w, severity: 'error' }))],
+            warnings: [],
+        };
+    }
+    return merged;
+}
+/**
+ * Validate and throw if invalid
+ *
+ * @param doc - USD document to validate
+ * @param options - Validation options
+ * @throws Error if document is invalid
+ */
+export function validateOrThrow(doc, options = {}) {
+    const result = validate(doc, options);
+    if (!result.valid) {
+        const message = formatValidationResult(result);
+        throw new Error(`USD validation failed:\n${message}`);
+    }
+}
+/**
+ * Quick check if document is valid (no details)
+ */
+export function isValid(doc, options = {}) {
+    return validate(doc, options).valid;
+}
+/**
+ * Type guard to check if object looks like a USD document
+ */
+function isUSDDocumentLike(obj) {
+    if (typeof obj !== 'object' || obj === null)
+        return false;
+    const doc = obj;
+    return typeof doc.info === 'object' && doc.info !== null;
+}
+/**
+ * Validation exception class for programmatic error handling
+ */
+export class USDValidationException extends Error {
+    result;
+    constructor(message, result) {
+        super(message);
+        this.result = result;
+        this.name = 'USDValidationException';
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/usd/validator/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/usd/validator/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,cAAc,EAAa,MAAM,aAAa,CAAA;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAChD,OAAO,EACL,YAAY,EAEZ,sBAAsB,GAEvB,MAAM,aAAa,CAAA;AAEpB,YAAY;AACZ,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAChD,OAAO,EACL,oBAAoB,EACpB,WAAW,EACX,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,EACZ,sBAAsB,GACvB,MAAM,aAAa,CAAA;AAyBpB;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAY,EAAE,UAA2B,EAAE;IAClE,MAAM,OAAO,GAA0B,EAAE,CAAA;IAEzC,oBAAoB;IACpB,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;QACxB,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAA;IACnC,CAAC;IAED,8CAA8C;IAC9C,IAAI,CAAC,OAAO,CAAC,YAAY,IAAI,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC;QACpD,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,GAAkB,CAAC,CAAC,CAAA;IACpD,CAAC;IAED,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,OAAO,CAAC,CAAA;IAEvC,yCAAyC;IACzC,IAAI,OAAO,CAAC,MAAM,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjD,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,QAAQ,EAAE,OAAgB,EAAE,CAAC,CAAC,CAAC;YACjG,QAAQ,EAAE,EAAE;SACb,CAAA;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,GAAY,EAAE,UAA2B,EAAE;IACzE,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;IAErC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,OAAO,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAA;QAC9C,MAAM,IAAI,KAAK,CAAC,2BAA2B,OAAO,EAAE,CAAC,CAAA;IACvD,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,GAAY,EAAE,UAA2B,EAAE;IACjE,OAAO,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,KAAK,CAAA;AACrC,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,GAAY;IACrC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,KAAK,CAAA;IACzD,MAAM,GAAG,GAAG,GAA8B,CAAA;IAC1C,OAAO,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,KAAK,IAAI,CAAA;AAC1D,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAG7B;IAFlB,YACE,OAAe,EACC,MAA2B;QAE3C,KAAK,CAAC,OAAO,CAAC,CAAA;QAFE,WAAM,GAAN,MAAM,CAAqB;QAG3C,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAA;IACtC,CAAC;CACF"}