@sudosandwich/limps-headless 0.1.3

package/dist/differ/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Contract differ module for detecting changes between Radix versions.
+ */
+import type { RadixChange, RadixDiff } from './types.js';
+export * from './types.js';
+export { diffContracts, diffProps, diffSubComponents } from './props.js';
+export { getSeverity, isBreaking, isWarning, isInfo, getBreakingTypes, sortBySeverity, } from './severity.js';
+export { generateHint, generateDescription } from './hints.js';
+export { parseUnionMembers, isNarrowing, isWidening } from './props.js';
+/**
+ * Diff a single primitive between two versions.
+ */
+export declare function diffPrimitive(primitiveSlug: string, fromVersion: string, toVersion: string): Promise<RadixChange[]>;
+/**
+ * Diff all primitives (or a subset) between two Radix versions.
+ * Version resolution (fromVersion/toVersion) is based on the first primitive
+ * in the list; all primitives are assumed to share the same Radix version.
+ *
+ * @param fromVersion - Starting version
+ * @param toVersion - Ending version (default: 'latest')
+ * @param primitives - Optional list of primitives to diff (default: all)
+ * @returns RadixDiff with all changes and summary
+ */
+export declare function diffVersions(fromVersion: string, toVersion?: string, primitives?: string[]): Promise<RadixDiff>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/differ/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAe,MAAM,YAAY,CAAC;AAYtE,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACzE,OAAO,EACL,WAAW,EACX,UAAU,EACV,SAAS,EACT,MAAM,EACN,gBAAgB,EAChB,cAAc,GACf,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAyDxE;;GAEG;AACH,wBAAsB,aAAa,CACjC,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,WAAW,EAAE,CAAC,CAOxB;AAED;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,SAAS,GAAE,MAAiB,EAC5B,UAAU,CAAC,EAAE,MAAM,EAAE,GACpB,OAAO,CAAC,SAAS,CAAC,CAgDpB"}

package/dist/differ/index.js

@@ -0,0 +1,115 @@
+/**
+ * Contract differ module for detecting changes between Radix versions.
+ */
+import { diffContracts } from './props.js';
+import { sortBySeverity } from './severity.js';
+import { resolvePackage, fetchTypesWithFallback, } from '../fetcher/index.js';
+import { extractPrimitive } from '../extractor/index.js';
+import { getFromCache, saveToCache } from '../cache/index.js';
+import { listPrimitives } from '../fetcher/npm-registry.js';
+// Re-export types and utilities
+export * from './types.js';
+export { diffContracts, diffProps, diffSubComponents } from './props.js';
+export { getSeverity, isBreaking, isWarning, isInfo, getBreakingTypes, sortBySeverity, } from './severity.js';
+export { generateHint, generateDescription } from './hints.js';
+export { parseUnionMembers, isNarrowing, isWidening } from './props.js';
+/**
+ * Convert primitive name to PascalCase.
+ */
+function toPascalCase(name) {
+    return name
+        .split('-')
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+        .join('');
+}
+/**
+ * Calculate summary counts from changes.
+ */
+function calculateSummary(changes) {
+    return {
+        totalChanges: changes.length,
+        breaking: changes.filter((c) => c.severity === 'breaking').length,
+        warnings: changes.filter((c) => c.severity === 'warning').length,
+        info: changes.filter((c) => c.severity === 'info').length,
+    };
+}
+/**
+ * Fetch or load extracted primitive data for a given version.
+ */
+async function getExtractedPrimitive(primitiveSlug, version) {
+    const primitiveName = toPascalCase(primitiveSlug);
+    // Try cache first
+    const cached = await getFromCache(primitiveName, version, {
+        ignoreExpired: true, // For diffing, we want any cached version
+    });
+    if (cached) {
+        return cached;
+    }
+    // Fetch and extract
+    const resolved = await resolvePackage(primitiveSlug, version);
+    const content = await fetchTypesWithFallback(primitiveSlug, version);
+    const extracted = extractPrimitive(content.content, primitiveName, resolved.version, content.resolved.packageName);
+    // Save to cache
+    await saveToCache(primitiveName, resolved.version, extracted);
+    return extracted;
+}
+/**
+ * Diff a single primitive between two versions.
+ */
+export async function diffPrimitive(primitiveSlug, fromVersion, toVersion) {
+    const [before, after] = await Promise.all([
+        getExtractedPrimitive(primitiveSlug, fromVersion),
+        getExtractedPrimitive(primitiveSlug, toVersion),
+    ]);
+    return diffContracts(before, after);
+}
+/**
+ * Diff all primitives (or a subset) between two Radix versions.
+ * Version resolution (fromVersion/toVersion) is based on the first primitive
+ * in the list; all primitives are assumed to share the same Radix version.
+ *
+ * @param fromVersion - Starting version
+ * @param toVersion - Ending version (default: 'latest')
+ * @param primitives - Optional list of primitives to diff (default: all)
+ * @returns RadixDiff with all changes and summary
+ */
+export async function diffVersions(fromVersion, toVersion = 'latest', primitives) {
+    // Get list of primitives to diff
+    let primitivesToDiff;
+    if (primitives && primitives.length > 0) {
+        primitivesToDiff = primitives.map((p) => p.toLowerCase());
+    }
+    else {
+        const allPrimitives = await listPrimitives();
+        primitivesToDiff = allPrimitives.map((p) => p.name);
+    }
+    if (primitivesToDiff.length === 0) {
+        throw new Error('No primitives to diff (list is empty)');
+    }
+    // Resolve actual versions (using first primitive as reference)
+    const resolvedFrom = await resolvePackage(primitivesToDiff[0], fromVersion);
+    const resolvedTo = await resolvePackage(primitivesToDiff[0], toVersion);
+    // Diff each primitive
+    const allChanges = [];
+    for (const primitiveSlug of primitivesToDiff) {
+        try {
+            const changes = await diffPrimitive(primitiveSlug, resolvedFrom.version, resolvedTo.version);
+            allChanges.push(...changes);
+        }
+        catch (error) {
+            // Skip primitives that fail (might not exist in one version)
+            console.warn(`Failed to diff ${primitiveSlug}: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    // Sort and calculate summary
+    const sortedChanges = sortBySeverity(allChanges);
+    const summary = calculateSummary(sortedChanges);
+    return {
+        fromVersion: resolvedFrom.version,
+        toVersion: resolvedTo.version,
+        hasBreakingChanges: summary.breaking > 0,
+        summary,
+        changes: sortedChanges,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/differ/index.js.map

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

package/dist/differ/props.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Props diffing logic for detecting changes between contract versions.
+ */
+import type { ExtractedPrimitive, PropDefinition, SubComponentDefinition } from '../types/index.js';
+import type { RadixChange } from './types.js';
+/**
+ * Parse a union type string into its member types.
+ * @example 'string | number' -> ['string', 'number']
+ * @example '"left" | "right" | "center"' -> ['"left"', '"right"', '"center"']
+ */
+export declare function parseUnionMembers(typeString: string): string[];
+/**
+ * Check if a type change represents narrowing (breaking).
+ * Narrowing occurs when the new type accepts fewer values than before.
+ * @example 'string | number' -> 'string' is narrowing
+ */
+export declare function isNarrowing(before: string, after: string): boolean;
+/**
+ * Check if a type change represents widening (safe/info).
+ * Widening occurs when the new type accepts more values than before.
+ * @example 'string' -> 'string | number' is widening
+ */
+export declare function isWidening(before: string, after: string): boolean;
+/**
+ * Diff props between two arrays of PropDefinitions.
+ */
+export declare function diffProps(before: PropDefinition[], after: PropDefinition[], primitive: string, subComponent?: string): RadixChange[];
+/**
+ * Diff sub-components between two ExtractedPrimitives.
+ */
+export declare function diffSubComponents(before: SubComponentDefinition[], after: SubComponentDefinition[], primitive: string): RadixChange[];
+/**
+ * Diff two ExtractedPrimitive objects to find all changes.
+ */
+export declare function diffContracts(before: ExtractedPrimitive, after: ExtractedPrimitive): RadixChange[];
+//# sourceMappingURL=props.d.ts.map

package/dist/differ/props.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"props.d.ts","sourceRoot":"","sources":["../../src/differ/props.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,kBAAkB,EAClB,cAAc,EACd,sBAAsB,EACvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,YAAY,CAAC;AAI1D;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAyC9D;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAmBlE;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAejE;AAqCD;;GAEG;AACH,wBAAgB,SAAS,CACvB,MAAM,EAAE,cAAc,EAAE,EACxB,KAAK,EAAE,cAAc,EAAE,EACvB,SAAS,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,MAAM,GACpB,WAAW,EAAE,CAqHf;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,sBAAsB,EAAE,EAChC,KAAK,EAAE,sBAAsB,EAAE,EAC/B,SAAS,EAAE,MAAM,GAChB,WAAW,EAAE,CAkCf;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,kBAAkB,EAC1B,KAAK,EAAE,kBAAkB,GACxB,WAAW,EAAE,CAiBf"}

package/dist/differ/props.js

@@ -0,0 +1,210 @@
+/**
+ * Props diffing logic for detecting changes between contract versions.
+ */
+import { getSeverity } from './severity.js';
+import { generateHint, generateDescription } from './hints.js';
+/**
+ * Parse a union type string into its member types.
+ * @example 'string | number' -> ['string', 'number']
+ * @example '"left" | "right" | "center"' -> ['"left"', '"right"', '"center"']
+ */
+export function parseUnionMembers(typeString) {
+    // Handle simple cases first
+    if (!typeString.includes('|')) {
+        return [typeString.trim()];
+    }
+    // Split by | but respect nested types (generics, parentheses)
+    const members = [];
+    let current = '';
+    let depth = 0;
+    let prevChar = '';
+    for (const char of typeString) {
+        if (char === '<' || char === '(' || char === '{' || char === '[') {
+            depth++;
+            current += char;
+        }
+        else if (char === ')' || char === '}' || char === ']') {
+            depth--;
+            current += char;
+        }
+        else if (char === '>') {
+            // Only treat '>' as a closing bracket if it's not part of '=>' (arrow function)
+            if (prevChar !== '=') {
+                depth--;
+            }
+            current += char;
+        }
+        else if (char === '|' && depth === 0) {
+            if (current.trim()) {
+                members.push(current.trim());
+            }
+            current = '';
+        }
+        else {
+            current += char;
+        }
+        prevChar = char;
+    }
+    if (current.trim()) {
+        members.push(current.trim());
+    }
+    return members;
+}
+/**
+ * Check if a type change represents narrowing (breaking).
+ * Narrowing occurs when the new type accepts fewer values than before.
+ * @example 'string | number' -> 'string' is narrowing
+ */
+export function isNarrowing(before, after) {
+    const beforeMembers = parseUnionMembers(before);
+    const afterMembers = parseUnionMembers(after);
+    // If same members, not narrowing
+    if (beforeMembers.length === afterMembers.length) {
+        const beforeSet = new Set(beforeMembers);
+        const afterSet = new Set(afterMembers);
+        if ([...afterSet].every((m) => beforeSet.has(m))) {
+            return false;
+        }
+    }
+    // Narrowing: all after members exist in before, and fewer members
+    const beforeSet = new Set(beforeMembers);
+    return (afterMembers.every((m) => beforeSet.has(m)) &&
+        afterMembers.length < beforeMembers.length);
+}
+/**
+ * Check if a type change represents widening (safe/info).
+ * Widening occurs when the new type accepts more values than before.
+ * @example 'string' -> 'string | number' is widening
+ */
+export function isWidening(before, after) {
+    const beforeMembers = parseUnionMembers(before);
+    const afterMembers = parseUnionMembers(after);
+    // If same members, not widening
+    if (beforeMembers.length === afterMembers.length) {
+        return false;
+    }
+    // Widening: all before members exist in after, and more members
+    const afterSet = new Set(afterMembers);
+    return (beforeMembers.every((m) => afterSet.has(m)) &&
+        afterMembers.length > beforeMembers.length);
+}
+/**
+ * Normalize a type string for comparison.
+ */
+function normalizeType(type) {
+    return type
+        .replace(/\s+/g, ' ')
+        .replace(/\s*\|\s*/g, ' | ')
+        .trim();
+}
+/**
+ * Create a RadixChange object.
+ */
+function createChange(type, target, primitive, before, after, subComponent) {
+    const context = { target, before, after, primitive, subComponent };
+    return {
+        type,
+        severity: getSeverity(type),
+        primitive,
+        subComponent,
+        target,
+        before,
+        after,
+        description: generateDescription(type, context),
+        migration: generateHint(type, context),
+    };
+}
+/**
+ * Diff props between two arrays of PropDefinitions.
+ */
+export function diffProps(before, after, primitive, subComponent) {
+    const changes = [];
+    const beforeMap = new Map(before.map((p) => [p.name, p]));
+    const afterMap = new Map(after.map((p) => [p.name, p]));
+    // Check for removed props
+    for (const [name, beforeProp] of beforeMap) {
+        if (!afterMap.has(name)) {
+            changes.push(createChange('prop_removed', name, primitive, beforeProp.type, null, subComponent));
+        }
+    }
+    // Check for added props
+    for (const [name, afterProp] of afterMap) {
+        if (!beforeMap.has(name)) {
+            changes.push(createChange('prop_added', name, primitive, null, afterProp.type, subComponent));
+        }
+    }
+    // Check for changed props
+    for (const [name, beforeProp] of beforeMap) {
+        const afterProp = afterMap.get(name);
+        if (!afterProp)
+            continue;
+        // Check for required change (optional -> required is breaking)
+        if (!beforeProp.required && afterProp.required) {
+            changes.push(createChange('prop_required', name, primitive, 'optional', 'required', subComponent));
+        }
+        // Check for type changes
+        const beforeType = normalizeType(beforeProp.type);
+        const afterType = normalizeType(afterProp.type);
+        if (beforeType !== afterType) {
+            if (isNarrowing(beforeType, afterType)) {
+                changes.push(createChange('type_narrowed', name, primitive, beforeType, afterType, subComponent));
+            }
+            else if (isWidening(beforeType, afterType)) {
+                changes.push(createChange('type_widened', name, primitive, beforeType, afterType, subComponent));
+            }
+            else {
+                changes.push(createChange('type_changed', name, primitive, beforeType, afterType, subComponent));
+            }
+        }
+        // Check for default value changes
+        if (beforeProp.defaultValue !== afterProp.defaultValue &&
+            (beforeProp.defaultValue || afterProp.defaultValue)) {
+            changes.push(createChange('default_changed', name, primitive, beforeProp.defaultValue ?? 'undefined', afterProp.defaultValue ?? 'undefined', subComponent));
+        }
+    }
+    return changes;
+}
+/**
+ * Diff sub-components between two ExtractedPrimitives.
+ */
+export function diffSubComponents(before, after, primitive) {
+    const changes = [];
+    const beforeMap = new Map(before.map((sc) => [sc.name, sc]));
+    const afterMap = new Map(after.map((sc) => [sc.name, sc]));
+    // Check for removed sub-components
+    for (const [name] of beforeMap) {
+        if (!afterMap.has(name)) {
+            changes.push(createChange('subcomponent_removed', name, primitive, name, null));
+        }
+    }
+    // Check for added sub-components
+    for (const [name] of afterMap) {
+        if (!beforeMap.has(name)) {
+            changes.push(createChange('subcomponent_added', name, primitive, null, name));
+        }
+    }
+    // Check props within each sub-component
+    for (const [name, beforeSc] of beforeMap) {
+        const afterSc = afterMap.get(name);
+        if (!afterSc)
+            continue;
+        const propChanges = diffProps(beforeSc.props, afterSc.props, primitive, name);
+        changes.push(...propChanges);
+    }
+    return changes;
+}
+/**
+ * Diff two ExtractedPrimitive objects to find all changes.
+ */
+export function diffContracts(before, after) {
+    const changes = [];
+    const primitive = before.name;
+    // Diff root props
+    const rootChanges = diffProps(before.rootProps, after.rootProps, primitive, 'Root');
+    changes.push(...rootChanges);
+    // Diff sub-components
+    const subComponentChanges = diffSubComponents(before.subComponents, after.subComponents, primitive);
+    changes.push(...subComponentChanges);
+    return changes;
+}
+//# sourceMappingURL=props.js.map

package/dist/differ/props.js.map

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

package/dist/differ/severity.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Severity classification for contract changes.
+ */
+import type { ChangeType, ChangeSeverity } from './types.js';
+/**
+ * Get the severity level for a change type.
+ */
+export declare function getSeverity(changeType: ChangeType): ChangeSeverity;
+/**
+ * Check if a change type is breaking.
+ */
+export declare function isBreaking(changeType: ChangeType): boolean;
+/**
+ * Check if a change type is a warning.
+ */
+export declare function isWarning(changeType: ChangeType): boolean;
+/**
+ * Check if a change type is informational.
+ */
+export declare function isInfo(changeType: ChangeType): boolean;
+/**
+ * Get all breaking change types.
+ */
+export declare function getBreakingTypes(): ChangeType[];
+/**
+ * Sort changes by severity (breaking first, then warning, then info).
+ */
+export declare function sortBySeverity<T extends {
+    severity: ChangeSeverity;
+}>(changes: T[]): T[];
+//# sourceMappingURL=severity.d.ts.map

package/dist/differ/severity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"severity.d.ts","sourceRoot":"","sources":["../../src/differ/severity.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAuB7D;;GAEG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,UAAU,GAAG,cAAc,CAElE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAE1D;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAEzD;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAEtD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,UAAU,EAAE,CAI/C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS;IAAE,QAAQ,EAAE,cAAc,CAAA;CAAE,EACnE,OAAO,EAAE,CAAC,EAAE,GACX,CAAC,EAAE,CAUL"}

package/dist/differ/severity.js

@@ -0,0 +1,65 @@
+/**
+ * Severity classification for contract changes.
+ */
+/**
+ * Map change types to their severity levels.
+ */
+const SEVERITY_MAP = {
+    // Breaking changes - will break existing code
+    prop_removed: 'breaking',
+    prop_required: 'breaking',
+    subcomponent_removed: 'breaking',
+    type_narrowed: 'breaking',
+    // Warning changes - might cause issues
+    prop_deprecated: 'warning',
+    type_changed: 'warning',
+    default_changed: 'warning',
+    // Info changes - additive, safe
+    prop_added: 'info',
+    subcomponent_added: 'info',
+    type_widened: 'info',
+};
+/**
+ * Get the severity level for a change type.
+ */
+export function getSeverity(changeType) {
+    return SEVERITY_MAP[changeType];
+}
+/**
+ * Check if a change type is breaking.
+ */
+export function isBreaking(changeType) {
+    return SEVERITY_MAP[changeType] === 'breaking';
+}
+/**
+ * Check if a change type is a warning.
+ */
+export function isWarning(changeType) {
+    return SEVERITY_MAP[changeType] === 'warning';
+}
+/**
+ * Check if a change type is informational.
+ */
+export function isInfo(changeType) {
+    return SEVERITY_MAP[changeType] === 'info';
+}
+/**
+ * Get all breaking change types.
+ */
+export function getBreakingTypes() {
+    return Object.entries(SEVERITY_MAP)
+        .filter(([, severity]) => severity === 'breaking')
+        .map(([type]) => type);
+}
+/**
+ * Sort changes by severity (breaking first, then warning, then info).
+ */
+export function sortBySeverity(changes) {
+    const severityOrder = {
+        breaking: 0,
+        warning: 1,
+        info: 2,
+    };
+    return [...changes].sort((a, b) => severityOrder[a.severity] - severityOrder[b.severity]);
+}
+//# sourceMappingURL=severity.js.map

package/dist/differ/severity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"severity.js","sourceRoot":"","sources":["../../src/differ/severity.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,MAAM,YAAY,GAAuC;IACvD,8CAA8C;IAC9C,YAAY,EAAE,UAAU;IACxB,aAAa,EAAE,UAAU;IACzB,oBAAoB,EAAE,UAAU;IAChC,aAAa,EAAE,UAAU;IAEzB,uCAAuC;IACvC,eAAe,EAAE,SAAS;IAC1B,YAAY,EAAE,SAAS;IACvB,eAAe,EAAE,SAAS;IAE1B,gCAAgC;IAChC,UAAU,EAAE,MAAM;IAClB,kBAAkB,EAAE,MAAM;IAC1B,YAAY,EAAE,MAAM;CACrB,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,UAAsB;IAChD,OAAO,YAAY,CAAC,UAAU,CAAC,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,UAAsB;IAC/C,OAAO,YAAY,CAAC,UAAU,CAAC,KAAK,UAAU,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,UAAsB;IAC9C,OAAO,YAAY,CAAC,UAAU,CAAC,KAAK,SAAS,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,MAAM,CAAC,UAAsB;IAC3C,OAAO,YAAY,CAAC,UAAU,CAAC,KAAK,MAAM,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC;SAChC,MAAM,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,QAAQ,KAAK,UAAU,CAAC;SACjD,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAkB,CAAC,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,OAAY;IAEZ,MAAM,aAAa,GAAmC;QACpD,QAAQ,EAAE,CAAC;QACX,OAAO,EAAE,CAAC;QACV,IAAI,EAAE,CAAC;KACR,CAAC;IAEF,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CACtB,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,CAChE,CAAC;AACJ,CAAC"}

package/dist/differ/types.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Type definitions for the Radix contract differ.
+ */
+/**
+ * Severity levels for contract changes.
+ */
+export type ChangeSeverity = 'breaking' | 'warning' | 'info';
+/**
+ * Types of changes that can occur in a contract.
+ */
+export type ChangeType = 'prop_removed' | 'prop_required' | 'subcomponent_removed' | 'type_narrowed' | 'prop_deprecated' | 'type_changed' | 'default_changed' | 'prop_added' | 'subcomponent_added' | 'type_widened';
+/**
+ * A single change detected between two contract versions.
+ */
+export interface RadixChange {
+    /**
+     * The type of change detected.
+     */
+    type: ChangeType;
+    /**
+     * Severity classification of the change.
+     */
+    severity: ChangeSeverity;
+    /**
+     * The primitive this change affects.
+     */
+    primitive: string;
+    /**
+     * The sub-component this change affects (e.g., "Content", "Trigger").
+     * Undefined for root-level changes.
+     */
+    subComponent?: string;
+    /**
+     * The target of the change (prop name, subcomponent name, etc.).
+     */
+    target: string;
+    /**
+     * The value/type before the change. Null for additions.
+     */
+    before: string | null;
+    /**
+     * The value/type after the change. Null for removals.
+     */
+    after: string | null;
+    /**
+     * Human-readable description of the change.
+     */
+    description: string;
+    /**
+     * Migration hint for addressing the change.
+     */
+    migration?: string;
+}
+/**
+ * Summary counts for a diff operation.
+ */
+export interface DiffSummary {
+    totalChanges: number;
+    breaking: number;
+    warnings: number;
+    info: number;
+}
+/**
+ * Result of diffing two Radix versions.
+ */
+export interface RadixDiff {
+    /**
+     * The starting version.
+     */
+    fromVersion: string;
+    /**
+     * The ending version.
+     */
+    toVersion: string;
+    /**
+     * Whether any breaking changes were detected.
+     */
+    hasBreakingChanges: boolean;
+    /**
+     * Summary counts by severity.
+     */
+    summary: DiffSummary;
+    /**
+     * All detected changes.
+     */
+    changes: RadixChange[];
+}
+/**
+ * Result of checking for updates.
+ */
+export interface UpdateCheckResult {
+    /**
+     * The currently cached/used version.
+     */
+    currentVersion: string;
+    /**
+     * The latest available version.
+     */
+    latestVersion: string;
+    /**
+     * Whether an update is available.
+     */
+    hasUpdate: boolean;
+    /**
+     * Diff details if an update is available.
+     */
+    diff?: RadixDiff;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/differ/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/differ/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,CAAC;AAE7D;;GAEG;AACH,MAAM,MAAM,UAAU,GAElB,cAAc,GACd,eAAe,GACf,sBAAsB,GACtB,eAAe,GAGf,iBAAiB,GACjB,cAAc,GACd,iBAAiB,GAGjB,YAAY,GACZ,oBAAoB,GACpB,cAAc,CAAC;AAEnB;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,IAAI,EAAE,UAAU,CAAC;IAEjB;;OAEG;IACH,QAAQ,EAAE,cAAc,CAAC;IAEzB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtB;;OAEG;IACH,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAErB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,kBAAkB,EAAE,OAAO,CAAC;IAE5B;;OAEG;IACH,OAAO,EAAE,WAAW,CAAC;IAErB;;OAEG;IACH,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,SAAS,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB"}

package/dist/differ/types.js

@@ -0,0 +1,5 @@
+/**
+ * Type definitions for the Radix contract differ.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/differ/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/differ/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}