@jetstart/shared 1.1.4 → 1.4.0

package/.eslintrc.json

@@ -0,0 +1,6 @@
+{
+  "extends": "../../.eslintrc.json",
+  "parserOptions": {
+    "project": ["./tsconfig.json", "./tsconfig.tests.json"]
+  }
+}

package/dist/protocols/websocket.d.ts

@@ -14,7 +14,7 @@ export interface BaseMessage {
 /**
  * Messages from Client to Core
  */
-export type ClientMessage = ClientConnectMessage | ClientStatusMessage | ClientLogMessage | ClientHeartbeatMessage | ClientDisconnectMessage;
+export type ClientMessage = ClientConnectMessage | ClientStatusMessage | ClientLogMessage | ClientHeartbeatMessage | ClientDisconnectMessage | ClientClickEventMessage;
 export interface ClientConnectMessage extends BaseMessage {
     type: 'client:connect';
     sessionId: string;
@@ -37,6 +37,12 @@ export interface ClientDisconnectMessage extends BaseMessage {
     type: 'client:disconnect';
     reason?: string;
 }
+export interface ClientClickEventMessage extends BaseMessage {
+    type: 'client:click';
+    action: string;
+    elementType: string;
+    elementText?: string;
+}
 /**
  * Messages from Core to Client
  */

package/dist/protocols/websocket.d.ts.map

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

package/dist/protocols/websocket.js.map

@@ -1 +1 @@
-{"version":3,"file":"websocket.js","sourceRoot":"","sources":["../../src/protocols/websocket.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAsHH;;GAEG;AACH,IAAY,OAMX;AAND,WAAY,OAAO;IACjB,oCAAyB,CAAA;IACzB,kCAAuB,CAAA;IACvB,0CAA+B,CAAA;IAC/B,wCAA6B,CAAA;IAC7B,0BAAe,CAAA;AACjB,CAAC,EANW,OAAO,uBAAP,OAAO,QAMlB;AAWD,IAAY,WAOX;AAPD,WAAY,WAAW;IACrB,sDAAuC,CAAA;IACvC,8DAA+C,CAAA;IAC/C,kCAAmB,CAAA;IACnB,kDAAmC,CAAA;IACnC,kDAAmC,CAAA;IACnC,kCAAmB,CAAA;AACrB,CAAC,EAPW,WAAW,2BAAX,WAAW,QAOtB"}
+{"version":3,"file":"websocket.js","sourceRoot":"","sources":["../../src/protocols/websocket.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AA8HH;;GAEG;AACH,IAAY,OAMX;AAND,WAAY,OAAO;IACjB,oCAAyB,CAAA;IACzB,kCAAuB,CAAA;IACvB,0CAA+B,CAAA;IAC/B,wCAA6B,CAAA;IAC7B,0BAAe,CAAA;AACjB,CAAC,EANW,OAAO,uBAAP,OAAO,QAMlB;AAWD,IAAY,WAOX;AAPD,WAAY,WAAW;IACrB,sDAAuC,CAAA;IACvC,8DAA+C,CAAA;IAC/C,kCAAmB,CAAA;IACnB,kDAAmC,CAAA;IACnC,kDAAmC,CAAA;IACnC,kCAAmB,CAAA;AACrB,CAAC,EAPW,WAAW,2BAAX,WAAW,QAOtB"}

package/dist/utils/colors.d.ts

@@ -0,0 +1,38 @@
+/**
+ * JetStart Brand Colors
+ * Official color palette for consistent branding
+ */
+export declare const BRAND_COLORS: {
+    readonly ORANGE: "#FA8F14";
+    readonly RED_ORANGE: "#F04023";
+    readonly DARK_PURPLE: "#160E36";
+    readonly DEEPER_PURPLE: "#120A24";
+    readonly CREAM: "#F8F3F0";
+};
+/**
+ * Terminal color codes for CLI output
+ */
+export declare const TERMINAL_COLORS: {
+    readonly ORANGE: "\u001B[38;2;250;143;20m";
+    readonly RED_ORANGE: "\u001B[38;2;240;64;35m";
+    readonly CREAM: "\u001B[38;2;248;243;240m";
+    readonly BG_DARK_PURPLE: "\u001B[48;2;22;14;54m";
+    readonly BG_DEEPER_PURPLE: "\u001B[48;2;18;10;36m";
+    readonly RESET: "\u001B[0m";
+    readonly BOLD: "\u001B[1m";
+    readonly DIM: "\u001B[2m";
+};
+/**
+ * Helper function to colorize terminal output
+ */
+export declare function colorize(text: string, color: keyof typeof TERMINAL_COLORS): string;
+/**
+ * Commonly used color combinations
+ */
+export declare const COLOR_PRESETS: {
+    readonly success: (text: string) => string;
+    readonly error: (text: string) => string;
+    readonly info: (text: string) => string;
+    readonly highlight: (text: string) => string;
+};
+//# sourceMappingURL=colors.d.ts.map

package/dist/utils/colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../../src/utils/colors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,YAAY;;;;;;CAWf,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;CAclB,CAAC;AAEX;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,OAAO,eAAe,GAAG,MAAM,CAElF;AAED;;GAEG;AACH,eAAO,MAAM,aAAa;6BACR,MAAM;2BACR,MAAM;0BACP,MAAM;+BACD,MAAM;CAChB,CAAC"}

package/dist/utils/colors.js

@@ -0,0 +1,50 @@
+"use strict";
+/**
+ * JetStart Brand Colors
+ * Official color palette for consistent branding
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COLOR_PRESETS = exports.TERMINAL_COLORS = exports.BRAND_COLORS = void 0;
+exports.colorize = colorize;
+exports.BRAND_COLORS = {
+    // Primary Colors
+    ORANGE: '#FA8F14',
+    RED_ORANGE: '#F04023',
+    // Background Colors
+    DARK_PURPLE: '#160E36',
+    DEEPER_PURPLE: '#120A24',
+    // Text/Foreground
+    CREAM: '#F8F3F0',
+};
+/**
+ * Terminal color codes for CLI output
+ */
+exports.TERMINAL_COLORS = {
+    // Foreground colors
+    ORANGE: '\x1b[38;2;250;143;20m',
+    RED_ORANGE: '\x1b[38;2;240;64;35m',
+    CREAM: '\x1b[38;2;248;243;240m',
+    // Background colors
+    BG_DARK_PURPLE: '\x1b[48;2;22;14;54m',
+    BG_DEEPER_PURPLE: '\x1b[48;2;18;10;36m',
+    // Utility
+    RESET: '\x1b[0m',
+    BOLD: '\x1b[1m',
+    DIM: '\x1b[2m',
+};
+/**
+ * Helper function to colorize terminal output
+ */
+function colorize(text, color) {
+    return `${exports.TERMINAL_COLORS[color]}${text}${exports.TERMINAL_COLORS.RESET}`;
+}
+/**
+ * Commonly used color combinations
+ */
+exports.COLOR_PRESETS = {
+    success: (text) => colorize(text, 'ORANGE'),
+    error: (text) => colorize(text, 'RED_ORANGE'),
+    info: (text) => colorize(text, 'CREAM'),
+    highlight: (text) => `${exports.TERMINAL_COLORS.BOLD}${colorize(text, 'ORANGE')}`,
+};
+//# sourceMappingURL=colors.js.map

package/dist/utils/colors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.js","sourceRoot":"","sources":["../../src/utils/colors.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAqCH,4BAEC;AArCY,QAAA,YAAY,GAAG;IAC1B,iBAAiB;IACjB,MAAM,EAAE,SAAS;IACjB,UAAU,EAAE,SAAS;IAErB,oBAAoB;IACpB,WAAW,EAAE,SAAS;IACtB,aAAa,EAAE,SAAS;IAExB,kBAAkB;IAClB,KAAK,EAAE,SAAS;CACR,CAAC;AAEX;;GAEG;AACU,QAAA,eAAe,GAAG;IAC7B,oBAAoB;IACpB,MAAM,EAAE,uBAAuB;IAC/B,UAAU,EAAE,sBAAsB;IAClC,KAAK,EAAE,wBAAwB;IAE/B,oBAAoB;IACpB,cAAc,EAAE,qBAAqB;IACrC,gBAAgB,EAAE,qBAAqB;IAEvC,UAAU;IACV,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,SAAS;IACf,GAAG,EAAE,SAAS;CACN,CAAC;AAEX;;GAEG;AACH,SAAgB,QAAQ,CAAC,IAAY,EAAE,KAAmC;IACxE,OAAO,GAAG,uBAAe,CAAC,KAAK,CAAC,GAAG,IAAI,GAAG,uBAAe,CAAC,KAAK,EAAE,CAAC;AACpE,CAAC;AAED;;GAEG;AACU,QAAA,aAAa,GAAG;IAC3B,OAAO,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACnD,KAAK,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IACrD,IAAI,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAC/C,SAAS,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,GAAG,uBAAe,CAAC,IAAI,GAAG,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE;CACzE,CAAC"}

package/dist/utils/index.d.ts

@@ -1,3 +1,5 @@
 export * from './validation';
 export * from './constants';
+export * from './version-compare';
+export * from './colors';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AACA,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AACA,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,UAAU,CAAC"}

package/dist/utils/index.js

@@ -17,4 +17,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 // Re-export all utilities
 __exportStar(require("./validation"), exports);
 __exportStar(require("./constants"), exports);
+__exportStar(require("./version-compare"), exports);
+__exportStar(require("./colors"), exports);
 //# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0BAA0B;AAC1B,+CAA6B;AAC7B,8CAA4B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0BAA0B;AAC1B,+CAA6B;AAC7B,8CAA4B;AAC5B,oDAAkC;AAClC,2CAAyB"}

package/dist/utils/version-compare.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Version comparison utilities for checking tool compatibility
+ */
+export interface ParsedVersion {
+    major: number;
+    minor: number;
+    patch: number;
+    original: string;
+}
+/**
+ * Parse a version string into its components
+ * Handles versions like "17.0.9", "1.9.21", "34.0.0", "v20.10.0"
+ */
+export declare function parseVersion(version: string): ParsedVersion;
+/**
+ * Compare two version strings
+ * Returns:
+ *  - Negative number if v1 < v2
+ *  - Zero if v1 === v2
+ *  - Positive number if v1 > v2
+ */
+export declare function compareVersions(v1: string, v2: string): number;
+/**
+ * Check if a version satisfies a requirement string
+ * Supports operators: >=, <=, >, <, =, ^, ~
+ *
+ * Examples:
+ *  - isVersionCompatible('17.0.9', '>=17') -> true
+ *  - isVersionCompatible('16.0.0', '>=17') -> false
+ *  - isVersionCompatible('1.9.21', '^1.9.0') -> true (same major, >= minor)
+ *  - isVersionCompatible('1.8.0', '^1.9.0') -> false
+ *  - isVersionCompatible('34.0.1', '~34.0.0') -> true (same major.minor, >= patch)
+ */
+export declare function isVersionCompatible(version: string, requirement: string): boolean;
+/**
+ * Format a version for display
+ */
+export declare function formatVersion(version: ParsedVersion | string): string;
+/**
+ * Check if version is within a range
+ * Range format: ">=min <=max" or "min - max"
+ */
+export declare function isVersionInRange(version: string, range: string): boolean;
+//# sourceMappingURL=version-compare.d.ts.map

package/dist/utils/version-compare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-compare.d.ts","sourceRoot":"","sources":["../../src/utils/version-compare.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAa3D;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAO9D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CA4CjF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,GAAG,MAAM,CAKrE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAgBxE"}

package/dist/utils/version-compare.js

@@ -0,0 +1,121 @@
+"use strict";
+/**
+ * Version comparison utilities for checking tool compatibility
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseVersion = parseVersion;
+exports.compareVersions = compareVersions;
+exports.isVersionCompatible = isVersionCompatible;
+exports.formatVersion = formatVersion;
+exports.isVersionInRange = isVersionInRange;
+/**
+ * Parse a version string into its components
+ * Handles versions like "17.0.9", "1.9.21", "34.0.0", "v20.10.0"
+ */
+function parseVersion(version) {
+    // Remove 'v' prefix and any non-numeric/dot characters at the start
+    const cleaned = version.replace(/^v/, '').replace(/[^\d.].*/g, '');
+    // Split by dots and parse each part
+    const parts = cleaned.split('.');
+    return {
+        major: parseInt(parts[0] || '0', 10),
+        minor: parseInt(parts[1] || '0', 10),
+        patch: parseInt(parts[2] || '0', 10),
+        original: version,
+    };
+}
+/**
+ * Compare two version strings
+ * Returns:
+ *  - Negative number if v1 < v2
+ *  - Zero if v1 === v2
+ *  - Positive number if v1 > v2
+ */
+function compareVersions(v1, v2) {
+    const a = parseVersion(v1);
+    const b = parseVersion(v2);
+    if (a.major !== b.major)
+        return a.major - b.major;
+    if (a.minor !== b.minor)
+        return a.minor - b.minor;
+    return a.patch - b.patch;
+}
+/**
+ * Check if a version satisfies a requirement string
+ * Supports operators: >=, <=, >, <, =, ^, ~
+ *
+ * Examples:
+ *  - isVersionCompatible('17.0.9', '>=17') -> true
+ *  - isVersionCompatible('16.0.0', '>=17') -> false
+ *  - isVersionCompatible('1.9.21', '^1.9.0') -> true (same major, >= minor)
+ *  - isVersionCompatible('1.8.0', '^1.9.0') -> false
+ *  - isVersionCompatible('34.0.1', '~34.0.0') -> true (same major.minor, >= patch)
+ */
+function isVersionCompatible(version, requirement) {
+    // Handle caret (^) - same major version, >= specified version
+    if (requirement.startsWith('^')) {
+        const reqVersion = requirement.slice(1);
+        const v = parseVersion(version);
+        const r = parseVersion(reqVersion);
+        return v.major === r.major && compareVersions(version, reqVersion) >= 0;
+    }
+    // Handle tilde (~) - same major.minor version, >= specified version
+    if (requirement.startsWith('~')) {
+        const reqVersion = requirement.slice(1);
+        const v = parseVersion(version);
+        const r = parseVersion(reqVersion);
+        return v.major === r.major && v.minor === r.minor && compareVersions(version, reqVersion) >= 0;
+    }
+    // Handle >= operator
+    if (requirement.startsWith('>=')) {
+        const reqVersion = requirement.slice(2).trim();
+        return compareVersions(version, reqVersion) >= 0;
+    }
+    // Handle <= operator
+    if (requirement.startsWith('<=')) {
+        const reqVersion = requirement.slice(2).trim();
+        return compareVersions(version, reqVersion) <= 0;
+    }
+    // Handle > operator
+    if (requirement.startsWith('>')) {
+        const reqVersion = requirement.slice(1).trim();
+        return compareVersions(version, reqVersion) > 0;
+    }
+    // Handle < operator
+    if (requirement.startsWith('<')) {
+        const reqVersion = requirement.slice(1).trim();
+        return compareVersions(version, reqVersion) < 0;
+    }
+    // Handle = operator or exact match
+    const reqVersion = requirement.startsWith('=') ? requirement.slice(1).trim() : requirement;
+    return compareVersions(version, reqVersion) === 0;
+}
+/**
+ * Format a version for display
+ */
+function formatVersion(version) {
+    if (typeof version === 'string') {
+        return version;
+    }
+    return `${version.major}.${version.minor}.${version.patch}`;
+}
+/**
+ * Check if version is within a range
+ * Range format: ">=min <=max" or "min - max"
+ */
+function isVersionInRange(version, range) {
+    // Handle "min - max" format
+    if (range.includes(' - ')) {
+        const [min, max] = range.split(' - ').map(v => v.trim());
+        return compareVersions(version, min) >= 0 && compareVersions(version, max) <= 0;
+    }
+    // Handle ">=min <=max" format
+    const parts = range.split(/\s+/);
+    for (const part of parts) {
+        if (!isVersionCompatible(version, part)) {
+            return false;
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=version-compare.js.map

package/dist/utils/version-compare.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jetstart/shared",
-  "version": "1.1.4",
+  "version": "1.4.0",
   "description": "Shared types, protocols, and utilities for JetStart",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/protocols/websocket.ts

@@ -28,7 +28,8 @@ export type ClientMessage =
   | ClientStatusMessage
   | ClientLogMessage
   | ClientHeartbeatMessage
-  | ClientDisconnectMessage;
+  | ClientDisconnectMessage
+  | ClientClickEventMessage;
 
 export interface ClientConnectMessage extends BaseMessage {
   type: 'client:connect';
@@ -57,6 +58,13 @@ export interface ClientDisconnectMessage extends BaseMessage {
   reason?: string;
 }
 
+export interface ClientClickEventMessage extends BaseMessage {
+  type: 'client:click';
+  action: string;
+  elementType: string;
+  elementText?: string;
+}
+
 /**
  * Messages from Core to Client
  */

package/src/utils/colors.ts

@@ -0,0 +1,53 @@
+/**
+ * JetStart Brand Colors
+ * Official color palette for consistent branding
+ */
+
+export const BRAND_COLORS = {
+  // Primary Colors
+  ORANGE: '#FA8F14',
+  RED_ORANGE: '#F04023',
+
+  // Background Colors
+  DARK_PURPLE: '#160E36',
+  DEEPER_PURPLE: '#120A24',
+
+  // Text/Foreground
+  CREAM: '#F8F3F0',
+} as const;
+
+/**
+ * Terminal color codes for CLI output
+ */
+export const TERMINAL_COLORS = {
+  // Foreground colors
+  ORANGE: '\x1b[38;2;250;143;20m',
+  RED_ORANGE: '\x1b[38;2;240;64;35m',
+  CREAM: '\x1b[38;2;248;243;240m',
+
+  // Background colors
+  BG_DARK_PURPLE: '\x1b[48;2;22;14;54m',
+  BG_DEEPER_PURPLE: '\x1b[48;2;18;10;36m',
+
+  // Utility
+  RESET: '\x1b[0m',
+  BOLD: '\x1b[1m',
+  DIM: '\x1b[2m',
+} as const;
+
+/**
+ * Helper function to colorize terminal output
+ */
+export function colorize(text: string, color: keyof typeof TERMINAL_COLORS): string {
+  return `${TERMINAL_COLORS[color]}${text}${TERMINAL_COLORS.RESET}`;
+}
+
+/**
+ * Commonly used color combinations
+ */
+export const COLOR_PRESETS = {
+  success: (text: string) => colorize(text, 'ORANGE'),
+  error: (text: string) => colorize(text, 'RED_ORANGE'),
+  info: (text: string) => colorize(text, 'CREAM'),
+  highlight: (text: string) => `${TERMINAL_COLORS.BOLD}${colorize(text, 'ORANGE')}`,
+} as const;

package/src/utils/index.ts

@@ -1,3 +1,5 @@
 // Re-export all utilities
 export * from './validation';
-export * from './constants';
+export * from './constants';
+export * from './version-compare';
+export * from './colors';

package/src/utils/version-compare.ts

@@ -0,0 +1,134 @@
+/**
+ * Version comparison utilities for checking tool compatibility
+ */
+
+export interface ParsedVersion {
+  major: number;
+  minor: number;
+  patch: number;
+  original: string;
+}
+
+/**
+ * Parse a version string into its components
+ * Handles versions like "17.0.9", "1.9.21", "34.0.0", "v20.10.0"
+ */
+export function parseVersion(version: string): ParsedVersion {
+  // Remove 'v' prefix and any non-numeric/dot characters at the start
+  const cleaned = version.replace(/^v/, '').replace(/[^\d.].*/g, '');
+
+  // Split by dots and parse each part
+  const parts = cleaned.split('.');
+
+  return {
+    major: parseInt(parts[0] || '0', 10),
+    minor: parseInt(parts[1] || '0', 10),
+    patch: parseInt(parts[2] || '0', 10),
+    original: version,
+  };
+}
+
+/**
+ * Compare two version strings
+ * Returns:
+ *  - Negative number if v1 < v2
+ *  - Zero if v1 === v2
+ *  - Positive number if v1 > v2
+ */
+export function compareVersions(v1: string, v2: string): number {
+  const a = parseVersion(v1);
+  const b = parseVersion(v2);
+
+  if (a.major !== b.major) return a.major - b.major;
+  if (a.minor !== b.minor) return a.minor - b.minor;
+  return a.patch - b.patch;
+}
+
+/**
+ * Check if a version satisfies a requirement string
+ * Supports operators: >=, <=, >, <, =, ^, ~
+ *
+ * Examples:
+ *  - isVersionCompatible('17.0.9', '>=17') -> true
+ *  - isVersionCompatible('16.0.0', '>=17') -> false
+ *  - isVersionCompatible('1.9.21', '^1.9.0') -> true (same major, >= minor)
+ *  - isVersionCompatible('1.8.0', '^1.9.0') -> false
+ *  - isVersionCompatible('34.0.1', '~34.0.0') -> true (same major.minor, >= patch)
+ */
+export function isVersionCompatible(version: string, requirement: string): boolean {
+  // Handle caret (^) - same major version, >= specified version
+  if (requirement.startsWith('^')) {
+    const reqVersion = requirement.slice(1);
+    const v = parseVersion(version);
+    const r = parseVersion(reqVersion);
+    return v.major === r.major && compareVersions(version, reqVersion) >= 0;
+  }
+
+  // Handle tilde (~) - same major.minor version, >= specified version
+  if (requirement.startsWith('~')) {
+    const reqVersion = requirement.slice(1);
+    const v = parseVersion(version);
+    const r = parseVersion(reqVersion);
+    return v.major === r.major && v.minor === r.minor && compareVersions(version, reqVersion) >= 0;
+  }
+
+  // Handle >= operator
+  if (requirement.startsWith('>=')) {
+    const reqVersion = requirement.slice(2).trim();
+    return compareVersions(version, reqVersion) >= 0;
+  }
+
+  // Handle <= operator
+  if (requirement.startsWith('<=')) {
+    const reqVersion = requirement.slice(2).trim();
+    return compareVersions(version, reqVersion) <= 0;
+  }
+
+  // Handle > operator
+  if (requirement.startsWith('>')) {
+    const reqVersion = requirement.slice(1).trim();
+    return compareVersions(version, reqVersion) > 0;
+  }
+
+  // Handle < operator
+  if (requirement.startsWith('<')) {
+    const reqVersion = requirement.slice(1).trim();
+    return compareVersions(version, reqVersion) < 0;
+  }
+
+  // Handle = operator or exact match
+  const reqVersion = requirement.startsWith('=') ? requirement.slice(1).trim() : requirement;
+  return compareVersions(version, reqVersion) === 0;
+}
+
+/**
+ * Format a version for display
+ */
+export function formatVersion(version: ParsedVersion | string): string {
+  if (typeof version === 'string') {
+    return version;
+  }
+  return `${version.major}.${version.minor}.${version.patch}`;
+}
+
+/**
+ * Check if version is within a range
+ * Range format: ">=min <=max" or "min - max"
+ */
+export function isVersionInRange(version: string, range: string): boolean {
+  // Handle "min - max" format
+  if (range.includes(' - ')) {
+    const [min, max] = range.split(' - ').map(v => v.trim());
+    return compareVersions(version, min) >= 0 && compareVersions(version, max) <= 0;
+  }
+
+  // Handle ">=min <=max" format
+  const parts = range.split(/\s+/);
+  for (const part of parts) {
+    if (!isVersionCompatible(version, part)) {
+      return false;
+    }
+  }
+
+  return true;
+}