@contractual/differs.json-schema 0.1.0-dev.0

package/dist/types.d.ts

@@ -0,0 +1,276 @@
+/**
+ * Internal types for JSON Schema structural differ
+ */
+/**
+ * Strands compatibility classification for a trace
+ */
+export type StrandsCompatibility = 'incompatible' | 'compatible' | 'unknown';
+/**
+ * Strands version bump level
+ */
+export type StrandsVersion = 'equal' | 'patch' | 'minor' | 'major' | null;
+/**
+ * A single trace showing where schemas differ (Strands format)
+ */
+export interface StrandsTrace {
+    /** Compatibility status of this change */
+    readonly compatibility: StrandsCompatibility;
+    /** JSON Pointer path in the source (left) schema, null if added */
+    readonly left: string | null;
+    /** JSON Pointer path in the target (right) schema, null if removed */
+    readonly right: string | null;
+}
+/**
+ * Semantic version object
+ */
+export interface SemanticVersion {
+    readonly major: number;
+    readonly minor: number;
+    readonly patch: number;
+    readonly version: string;
+}
+/**
+ * Strands API response format
+ */
+export interface CompareResult {
+    /** Version bump level, null if unknown/error */
+    readonly version: StrandsVersion;
+    /** List of traces showing where schemas differ */
+    readonly traces: StrandsTrace[];
+    /** Computed new version based on current version + bump */
+    readonly newVersion: SemanticVersion | null;
+    /** Error or warning message */
+    readonly message?: string;
+}
+/**
+ * Options for schema comparison
+ */
+export interface CompareOptions {
+    /** Current version to compute newVersion from (e.g., "1.0.0") */
+    readonly currentVersion?: string;
+    /** Draft version for validation rules */
+    readonly draft?: JsonSchemaDraft;
+}
+/**
+ * Supported JSON Schema drafts
+ */
+export type JsonSchemaDraft = 'draft-07' | 'draft-2019-09' | 'draft-2020-12';
+/**
+ * JSON Schema type values
+ */
+export type JSONSchemaType = 'string' | 'number' | 'integer' | 'boolean' | 'object' | 'array' | 'null';
+/**
+ * Normalized type representation (always an array for comparison)
+ */
+export type NormalizedType = JSONSchemaType[];
+/**
+ * JSON Schema constraint keys that can be tightened or loosened
+ */
+export type ConstraintKey = 'minimum' | 'maximum' | 'exclusiveMinimum' | 'exclusiveMaximum' | 'minLength' | 'maxLength' | 'minItems' | 'maxItems' | 'minProperties' | 'maxProperties' | 'minContains' | 'maxContains' | 'pattern' | 'multipleOf' | 'uniqueItems';
+/**
+ * Constraint comparison direction
+ */
+export type ConstraintDirection = 'min' | 'max' | 'exact';
+/**
+ * Constraint metadata for determining tightened vs loosened
+ */
+export interface ConstraintMeta {
+    readonly key: ConstraintKey;
+    readonly direction: ConstraintDirection;
+}
+/**
+ * Map of constraint keys to their comparison direction
+ */
+export declare const CONSTRAINT_DIRECTION: Record<ConstraintKey, ConstraintDirection>;
+/**
+ * All constraint keys for iteration
+ */
+export declare const CONSTRAINT_KEYS: ConstraintKey[];
+/**
+ * Composition keywords in JSON Schema
+ */
+export type CompositionKeyword = 'anyOf' | 'oneOf' | 'allOf' | 'if' | 'then' | 'else' | 'not';
+/**
+ * All composition keywords for iteration
+ */
+export declare const COMPOSITION_KEYWORDS: CompositionKeyword[];
+/**
+ * Metadata keys that are compared (patch-level changes)
+ */
+export type MetadataKey = 'description' | 'title' | 'default' | 'examples';
+/**
+ * All metadata keys for iteration
+ */
+export declare const METADATA_KEYS: MetadataKey[];
+/**
+ * Annotation keys (patch-level changes per Strands API)
+ */
+export type AnnotationKey = 'deprecated' | 'readOnly' | 'writeOnly';
+/**
+ * All annotation keys for iteration
+ */
+export declare const ANNOTATION_KEYS: AnnotationKey[];
+/**
+ * Content keywords (patch-level changes per Strands API)
+ */
+export type ContentKey = 'contentEncoding' | 'contentMediaType' | 'contentSchema';
+/**
+ * All content keys for iteration
+ */
+export declare const CONTENT_KEYS: ContentKey[];
+/**
+ * Resolved JSON Schema object (refs already resolved)
+ */
+export interface ResolvedSchema {
+    $schema?: string;
+    $id?: string;
+    $ref?: string;
+    $defs?: Record<string, ResolvedSchema>;
+    type?: JSONSchemaType | JSONSchemaType[];
+    title?: string;
+    description?: string;
+    default?: unknown;
+    examples?: unknown[];
+    deprecated?: boolean;
+    readOnly?: boolean;
+    writeOnly?: boolean;
+    enum?: unknown[];
+    const?: unknown;
+    format?: string;
+    minimum?: number;
+    maximum?: number;
+    exclusiveMinimum?: number;
+    exclusiveMaximum?: number;
+    multipleOf?: number;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    contentEncoding?: string;
+    contentMediaType?: string;
+    contentSchema?: ResolvedSchema;
+    properties?: Record<string, ResolvedSchema>;
+    required?: string[];
+    additionalProperties?: boolean | ResolvedSchema;
+    minProperties?: number;
+    maxProperties?: number;
+    propertyNames?: ResolvedSchema;
+    patternProperties?: Record<string, ResolvedSchema>;
+    dependentRequired?: Record<string, string[]>;
+    dependentSchemas?: Record<string, ResolvedSchema>;
+    unevaluatedProperties?: boolean | ResolvedSchema;
+    items?: ResolvedSchema | ResolvedSchema[];
+    prefixItems?: ResolvedSchema[];
+    minItems?: number;
+    maxItems?: number;
+    uniqueItems?: boolean;
+    contains?: ResolvedSchema;
+    minContains?: number;
+    maxContains?: number;
+    unevaluatedItems?: boolean | ResolvedSchema;
+    anyOf?: ResolvedSchema[];
+    oneOf?: ResolvedSchema[];
+    allOf?: ResolvedSchema[];
+    if?: ResolvedSchema;
+    then?: ResolvedSchema;
+    else?: ResolvedSchema;
+    not?: ResolvedSchema;
+    [key: string]: unknown;
+}
+/**
+ * Walker context for tracking traversal state
+ */
+export interface WalkerContext {
+    /** Current JSON Pointer path */
+    readonly path: string;
+    /** Depth of recursion (for cycle detection) */
+    readonly depth: number;
+    /** Maximum allowed depth */
+    readonly maxDepth: number;
+}
+/**
+ * Default maximum recursion depth
+ */
+export declare const DEFAULT_MAX_DEPTH = 100;
+/**
+ * Type guard to check if value is a schema object
+ */
+export declare function isSchemaObject(value: unknown): value is ResolvedSchema;
+/**
+ * Type guard to check if value is an array of schemas
+ */
+export declare function isSchemaArray(value: unknown): value is ResolvedSchema[];
+/**
+ * Normalize type to array for consistent comparison
+ */
+export declare function normalizeType(type: JSONSchemaType | JSONSchemaType[] | undefined): NormalizedType;
+/**
+ * Check if two arrays have the same elements (order-independent)
+ */
+export declare function arraysEqual<T>(a: T[], b: T[]): boolean;
+/**
+ * Deep equality check for JSON values
+ */
+export declare function deepEqual(a: unknown, b: unknown): boolean;
+/**
+ * Escape JSON Pointer segment according to RFC 6901
+ */
+export declare function escapeJsonPointer(segment: string): string;
+/**
+ * Join path segments into a JSON Pointer
+ */
+export declare function joinPath(basePath: string, ...segments: string[]): string;
+/**
+ * Severity classification for detected changes
+ */
+export type ChangeSeverity = 'breaking' | 'non-breaking' | 'patch' | 'unknown';
+/**
+ * Suggested semver bump based on detected changes
+ */
+export type SuggestedBump = 'major' | 'minor' | 'patch' | 'none';
+/**
+ * A single change detected between two spec versions
+ */
+export interface Change {
+    path: string;
+    severity: ChangeSeverity;
+    category: string;
+    message: string;
+    oldValue?: unknown;
+    newValue?: unknown;
+}
+/**
+ * Summary counts of changes by severity
+ */
+export interface DiffSummary {
+    breaking: number;
+    nonBreaking: number;
+    patch: number;
+    unknown: number;
+}
+/**
+ * Result of comparing two spec versions
+ */
+export interface DiffResult {
+    contract: string;
+    changes: Change[];
+    summary: DiffSummary;
+    suggestedBump: SuggestedBump;
+}
+/**
+ * All possible structural change types for classification
+ */
+export type ChangeType = 'property-added' | 'property-removed' | 'required-added' | 'required-removed' | 'type-changed' | 'type-narrowed' | 'type-widened' | 'enum-value-added' | 'enum-value-removed' | 'enum-added' | 'enum-removed' | 'constraint-tightened' | 'constraint-loosened' | 'format-changed' | 'format-added' | 'format-removed' | 'additional-properties-denied' | 'additional-properties-allowed' | 'additional-properties-changed' | 'property-names-changed' | 'dependent-required-added' | 'dependent-required-removed' | 'dependent-schemas-changed' | 'unevaluated-properties-changed' | 'items-changed' | 'min-items-increased' | 'max-items-decreased' | 'min-contains-changed' | 'max-contains-changed' | 'unevaluated-items-changed' | 'ref-target-changed' | 'description-changed' | 'title-changed' | 'default-changed' | 'examples-changed' | 'deprecated-changed' | 'read-only-changed' | 'write-only-changed' | 'content-encoding-changed' | 'content-media-type-changed' | 'content-schema-changed' | 'anyof-option-added' | 'anyof-option-removed' | 'oneof-option-added' | 'oneof-option-removed' | 'allof-member-added' | 'allof-member-removed' | 'not-schema-changed' | 'if-then-else-changed' | 'composition-changed' | 'unknown-change';
+/**
+ * Raw change detected by a differ before severity classification
+ */
+export interface RawChange {
+    path: string;
+    type: ChangeType;
+    oldValue?: unknown;
+    newValue?: unknown;
+}
+/**
+ * Mapping from change types to their severity classification
+ */
+export declare const CHANGE_TYPE_SEVERITY: Record<ChangeType, ChangeSeverity>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,cAAc,GAAG,YAAY,GAAG,SAAS,CAAC;AAE7E;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,IAAI,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,0CAA0C;IAC1C,QAAQ,CAAC,aAAa,EAAE,oBAAoB,CAAC;IAC7C,mEAAmE;IACnE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,sEAAsE;IACtE,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,gDAAgD;IAChD,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,kDAAkD;IAClD,QAAQ,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC;IAChC,2DAA2D;IAC3D,QAAQ,CAAC,UAAU,EAAE,eAAe,GAAG,IAAI,CAAC;IAC5C,+BAA+B;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,iEAAiE;IACjE,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,yCAAyC;IACzC,QAAQ,CAAC,KAAK,CAAC,EAAE,eAAe,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,eAAe,GAAG,eAAe,CAAC;AAM7E;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,SAAS,GACT,QAAQ,GACR,OAAO,GACP,MAAM,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,cAAc,EAAE,CAAC;AAE9C;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,SAAS,GACT,kBAAkB,GAClB,kBAAkB,GAClB,WAAW,GACX,WAAW,GACX,UAAU,GACV,UAAU,GACV,eAAe,GACf,eAAe,GACf,aAAa,GACb,aAAa,GACb,SAAS,GACT,YAAY,GACZ,aAAa,CAAC;AAElB;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,KAAK,GAAG,KAAK,GAAG,OAAO,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,mBAAmB,CAAC;CACzC;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,aAAa,EAAE,mBAAmB,CAgB3E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,aAAa,EAgB1C,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAE9F;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,kBAAkB,EAQpD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,CAAC;AAE3E;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,WAAW,EAAoD,CAAC;AAE5F;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG,UAAU,GAAG,WAAW,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,aAAa,EAA4C,CAAC;AAExF;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,iBAAiB,GAAG,kBAAkB,GAAG,eAAe,CAAC;AAElF;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,UAAU,EAA6D,CAAC;AAEnG;;GAEG;AACH,MAAM,WAAW,cAAc;IAE7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAGvC,IAAI,CAAC,EAAE,cAAc,GAAG,cAAc,EAAE,CAAC;IAGzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IAGrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IAGpB,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAGhB,MAAM,CAAC,EAAE,MAAM,CAAC;IAGhB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IAGjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,cAAc,CAAC;IAG/B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC5C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,oBAAoB,CAAC,EAAE,OAAO,GAAG,cAAc,CAAC;IAChD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,cAAc,CAAC;IAC/B,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACnD,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7C,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAClD,qBAAqB,CAAC,EAAE,OAAO,GAAG,cAAc,CAAC;IAGjD,KAAK,CAAC,EAAE,cAAc,GAAG,cAAc,EAAE,CAAC;IAC1C,WAAW,CAAC,EAAE,cAAc,EAAE,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,OAAO,GAAG,cAAc,CAAC;IAG5C,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;IACzB,EAAE,CAAC,EAAE,cAAc,CAAC;IACpB,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,GAAG,CAAC,EAAE,cAAc,CAAC;IAGrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,gCAAgC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,4BAA4B;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAErC;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAEtE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,EAAE,CAEvE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,cAAc,GAAG,cAAc,EAAE,GAAG,SAAS,GAAG,cAAc,CAQjG;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,OAAO,CAKtD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CA0BzD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAMxE;AAMD;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,cAAc,GAAG,OAAO,GAAG,SAAS,CAAC;AAE/E;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,cAAc,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,WAAW,CAAC;IACrB,aAAa,EAAE,aAAa,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAElB,gBAAgB,GAChB,kBAAkB,GAClB,gBAAgB,GAChB,kBAAkB,GAElB,cAAc,GACd,eAAe,GACf,cAAc,GAEd,kBAAkB,GAClB,oBAAoB,GACpB,YAAY,GACZ,cAAc,GAEd,sBAAsB,GACtB,qBAAqB,GACrB,gBAAgB,GAChB,cAAc,GACd,gBAAgB,GAEhB,8BAA8B,GAC9B,+BAA+B,GAC/B,+BAA+B,GAC/B,wBAAwB,GACxB,0BAA0B,GAC1B,4BAA4B,GAC5B,2BAA2B,GAC3B,gCAAgC,GAEhC,eAAe,GACf,qBAAqB,GACrB,qBAAqB,GACrB,sBAAsB,GACtB,sBAAsB,GACtB,2BAA2B,GAE3B,oBAAoB,GAEpB,qBAAqB,GACrB,eAAe,GACf,iBAAiB,GACjB,kBAAkB,GAElB,oBAAoB,GACpB,mBAAmB,GACnB,oBAAoB,GAEpB,0BAA0B,GAC1B,4BAA4B,GAC5B,wBAAwB,GAExB,oBAAoB,GACpB,sBAAsB,GACtB,oBAAoB,GACpB,sBAAsB,GACtB,oBAAoB,GACpB,sBAAsB,GACtB,oBAAoB,GACpB,sBAAsB,GAEtB,qBAAqB,GAErB,gBAAgB,CAAC;AAErB;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,UAAU,EAAE,cAAc,CA2DnE,CAAC"}

package/dist/types.js

@@ -0,0 +1,210 @@
+/**
+ * Internal types for JSON Schema structural differ
+ */
+/**
+ * Map of constraint keys to their comparison direction
+ */
+export const CONSTRAINT_DIRECTION = {
+    minimum: 'min',
+    maximum: 'max',
+    exclusiveMinimum: 'min',
+    exclusiveMaximum: 'max',
+    minLength: 'min',
+    maxLength: 'max',
+    minItems: 'min',
+    maxItems: 'max',
+    minProperties: 'min',
+    maxProperties: 'max',
+    minContains: 'min',
+    maxContains: 'max',
+    pattern: 'exact',
+    multipleOf: 'exact',
+    uniqueItems: 'exact',
+};
+/**
+ * All constraint keys for iteration
+ */
+export const CONSTRAINT_KEYS = [
+    'minimum',
+    'maximum',
+    'exclusiveMinimum',
+    'exclusiveMaximum',
+    'minLength',
+    'maxLength',
+    'minItems',
+    'maxItems',
+    'minProperties',
+    'maxProperties',
+    'minContains',
+    'maxContains',
+    'pattern',
+    'multipleOf',
+    'uniqueItems',
+];
+/**
+ * All composition keywords for iteration
+ */
+export const COMPOSITION_KEYWORDS = [
+    'anyOf',
+    'oneOf',
+    'allOf',
+    'if',
+    'then',
+    'else',
+    'not',
+];
+/**
+ * All metadata keys for iteration
+ */
+export const METADATA_KEYS = ['description', 'title', 'default', 'examples'];
+/**
+ * All annotation keys for iteration
+ */
+export const ANNOTATION_KEYS = ['deprecated', 'readOnly', 'writeOnly'];
+/**
+ * All content keys for iteration
+ */
+export const CONTENT_KEYS = ['contentEncoding', 'contentMediaType', 'contentSchema'];
+/**
+ * Default maximum recursion depth
+ */
+export const DEFAULT_MAX_DEPTH = 100;
+/**
+ * Type guard to check if value is a schema object
+ */
+export function isSchemaObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * Type guard to check if value is an array of schemas
+ */
+export function isSchemaArray(value) {
+    return Array.isArray(value) && value.every(isSchemaObject);
+}
+/**
+ * Normalize type to array for consistent comparison
+ */
+export function normalizeType(type) {
+    if (type === undefined) {
+        return [];
+    }
+    if (Array.isArray(type)) {
+        return [...type].sort();
+    }
+    return [type];
+}
+/**
+ * Check if two arrays have the same elements (order-independent)
+ */
+export function arraysEqual(a, b) {
+    if (a.length !== b.length)
+        return false;
+    const sortedA = [...a].sort();
+    const sortedB = [...b].sort();
+    return sortedA.every((val, idx) => val === sortedB[idx]);
+}
+/**
+ * Deep equality check for JSON values
+ */
+export function deepEqual(a, b) {
+    if (a === b) {
+        return true;
+    }
+    if (typeof a !== typeof b) {
+        return false;
+    }
+    if (a === null || b === null)
+        return a === b;
+    if (Array.isArray(a) && Array.isArray(b)) {
+        if (a.length !== b.length)
+            return false;
+        return a.every((val, idx) => deepEqual(val, b[idx]));
+    }
+    if (typeof a === 'object' && typeof b === 'object') {
+        const aObj = a;
+        const bObj = b;
+        const aKeys = Object.keys(aObj);
+        const bKeys = Object.keys(bObj);
+        if (aKeys.length !== bKeys.length)
+            return false;
+        return aKeys.every((key) => deepEqual(aObj[key], bObj[key]));
+    }
+    return false;
+}
+/**
+ * Escape JSON Pointer segment according to RFC 6901
+ */
+export function escapeJsonPointer(segment) {
+    return segment.replace(/~/g, '~0').replace(/\//g, '~1');
+}
+/**
+ * Join path segments into a JSON Pointer
+ */
+export function joinPath(basePath, ...segments) {
+    const escaped = segments.map(escapeJsonPointer);
+    if (basePath === '') {
+        return escaped.length > 0 ? '/' + escaped.join('/') : '';
+    }
+    return basePath + '/' + escaped.join('/');
+}
+/**
+ * Mapping from change types to their severity classification
+ */
+export const CHANGE_TYPE_SEVERITY = {
+    // Breaking changes (major)
+    'property-removed': 'breaking',
+    'required-added': 'breaking',
+    'type-changed': 'breaking',
+    'type-narrowed': 'breaking',
+    'enum-value-removed': 'breaking',
+    'enum-added': 'breaking',
+    'constraint-tightened': 'breaking',
+    'additional-properties-denied': 'breaking',
+    'items-changed': 'breaking',
+    'min-items-increased': 'breaking',
+    'max-items-decreased': 'breaking',
+    'ref-target-changed': 'breaking',
+    'dependent-required-added': 'breaking',
+    'anyof-option-added': 'breaking',
+    'oneof-option-added': 'breaking',
+    'allof-member-added': 'breaking',
+    'not-schema-changed': 'breaking',
+    // Non-breaking changes (minor)
+    'property-added': 'non-breaking',
+    'required-removed': 'non-breaking',
+    'type-widened': 'non-breaking',
+    'enum-value-added': 'non-breaking',
+    'enum-removed': 'non-breaking',
+    'constraint-loosened': 'non-breaking',
+    'additional-properties-allowed': 'non-breaking',
+    'additional-properties-changed': 'non-breaking',
+    'dependent-required-removed': 'non-breaking',
+    'anyof-option-removed': 'non-breaking',
+    'oneof-option-removed': 'non-breaking',
+    'allof-member-removed': 'non-breaking',
+    // Patch-level changes
+    'format-added': 'patch',
+    'format-removed': 'patch',
+    'format-changed': 'patch',
+    'description-changed': 'patch',
+    'title-changed': 'patch',
+    'default-changed': 'patch',
+    'examples-changed': 'patch',
+    'deprecated-changed': 'patch',
+    'read-only-changed': 'patch',
+    'write-only-changed': 'patch',
+    'content-encoding-changed': 'patch',
+    'content-media-type-changed': 'patch',
+    'content-schema-changed': 'patch',
+    // Unknown (manual review)
+    'property-names-changed': 'unknown',
+    'dependent-schemas-changed': 'unknown',
+    'unevaluated-properties-changed': 'unknown',
+    'unevaluated-items-changed': 'unknown',
+    'min-contains-changed': 'unknown',
+    'max-contains-changed': 'unknown',
+    'if-then-else-changed': 'unknown',
+    'composition-changed': 'unknown',
+    'unknown-change': 'unknown',
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/walker.d.ts

@@ -0,0 +1,17 @@
+/**
+ * JSON Schema structural walker
+ *
+ * Recursively walks two resolved JSON Schemas side-by-side (DFS)
+ * and emits RawChange for every structural difference.
+ */
+import type { RawChange } from './types.js';
+/**
+ * Walk two resolved JSON Schemas and emit changes
+ *
+ * @param oldSchema - The original schema (resolved, no $refs)
+ * @param newSchema - The new schema (resolved, no $refs)
+ * @param basePath - JSON Pointer base path (default: '')
+ * @returns Array of raw changes detected
+ */
+export declare function walk(oldSchema: unknown, newSchema: unknown, basePath?: string): RawChange[];
+//# sourceMappingURL=walker.d.ts.map

package/dist/walker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walker.d.ts","sourceRoot":"","sources":["../src/walker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAc,SAAS,EAAE,MAAM,YAAY,CAAC;AAkBxD;;;;;;;GAOG;AACH,wBAAgB,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,GAAE,MAAW,GAAG,SAAS,EAAE,CAE/F"}