@aiready/components 0.13.1 → 0.13.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiready/components",
-  "version": "0.13.1",
+  "version": "0.13.3",
   "description": "Unified shared components library (UI, charts, hooks, utilities) for AIReady",
   "type": "module",
   "main": "./dist/index.js",
@@ -65,7 +65,7 @@
     "framer-motion": "^12.35.0",
     "lucide-react": "^0.577.0",
     "tailwind-merge": "^3.0.0",
-    "@aiready/core": "0.23.1"
+    "@aiready/core": "0.23.3"
   },
   "devDependencies": {
     "@testing-library/jest-dom": "^6.6.5",

package/src/charts/ForceDirectedGraph.tsx

@@ -11,30 +11,8 @@ import { cn } from '../utils/cn';
 import NodeItem from './NodeItem';
 import LinkItem from './LinkItem';
 
-export interface GraphNode {
-  id: string;
-  label?: string;
-  color?: string;
-  size?: number;
-  group?: string;
-  kind?: 'file' | 'package';
-  packageGroup?: string;
-  x?: number;
-  y?: number;
-  fx?: number | null;
-  fy?: number | null;
-}
-
-export interface GraphLink {
-  source: string | GraphNode;
-  target: string | GraphNode;
-  color?: string;
-  width?: number;
-  label?: string;
-  type?: string;
-}
-
-export type LayoutType = 'force' | 'hierarchical' | 'circular';
+import { GraphNode, GraphLink, LayoutType } from './types';
+export type { GraphNode, GraphLink, LayoutType };
 
 export interface ForceDirectedGraphHandle {
   pinAll: () => void;
@@ -42,6 +20,10 @@ export interface ForceDirectedGraphHandle {
   resetLayout: () => void;
   fitView: () => void;
   getPinnedNodes: () => string[];
+  /**
+   * Enable or disable drag mode for nodes.
+   * @param enabled - When true, nodes can be dragged; when false, dragging is disabled
+   */
   setDragMode: (enabled: boolean) => void;
   setLayout: (layout: LayoutType) => void;
   getLayout: () => LayoutType;
@@ -67,6 +49,10 @@ export interface ForceDirectedGraphProps {
   showLinkLabels?: boolean;
   className?: string;
   manualLayout?: boolean;
+  /**
+   * Callback fired when manual layout mode changes.
+   * @param enabled - True when manual layout mode is enabled, false when disabled
+   */
   onManualLayoutChange?: (enabled: boolean) => void;
   packageBounds?: Record<string, { x: number; y: number; r: number }>;
   layout?: LayoutType;

package/src/charts/GraphControls.tsx

@@ -9,6 +9,7 @@ export interface GraphControlsProps {
 
   /**
    * Callback to toggle drag mode
+   * @param enabled - True when drag mode should be enabled, false when disabled
    */
   onDragToggle?: (enabled: boolean) => void;
 
@@ -19,6 +20,7 @@ export interface GraphControlsProps {
 
   /**
    * Callback to toggle manual layout mode
+   * @param enabled - True when manual layout should be enabled, false when disabled
    */
   onManualLayoutToggle?: (enabled: boolean) => void;
 

package/src/charts/LinkItem.tsx

@@ -1,5 +1,5 @@
 import React from 'react';
-import type { GraphLink, GraphNode } from './ForceDirectedGraph';
+import type { GraphLink, GraphNode } from './types';
 
 export interface LinkItemProps {
   link: GraphLink;

package/src/charts/NodeItem.tsx

@@ -1,5 +1,5 @@
 import React from 'react';
-import type { GraphNode } from './ForceDirectedGraph';
+import type { GraphNode } from './types';
 
 export interface NodeItemProps {
   node: GraphNode;

package/src/charts/types.ts

@@ -0,0 +1,24 @@
+export interface GraphNode {
+  id: string;
+  label?: string;
+  color?: string;
+  size?: number;
+  group?: string;
+  kind?: 'file' | 'package';
+  packageGroup?: string;
+  x?: number;
+  y?: number;
+  fx?: number | null;
+  fy?: number | null;
+}
+
+export interface GraphLink {
+  source: string | GraphNode;
+  target: string | GraphNode;
+  color?: string;
+  width?: number;
+  label?: string;
+  type?: string;
+}
+
+export type LayoutType = 'force' | 'hierarchical' | 'circular';

package/src/components/radio-group.tsx

@@ -1,11 +1,8 @@
 import * as React from 'react';
 import { cn } from '../utils/cn';
+import { ComponentOption } from '../types';
 
-export interface RadioOption {
-  value: string;
-  label: string;
-  disabled?: boolean;
-}
+export type RadioOption = ComponentOption;
 
 export interface RadioGroupProps extends Omit<
   React.HTMLAttributes<HTMLDivElement>,

package/src/components/select.tsx

@@ -1,11 +1,8 @@
 import * as React from 'react';
 import { cn } from '../utils/cn';
+import { ComponentOption } from '../types';
 
-export interface SelectOption {
-  value: string;
-  label: string;
-  disabled?: boolean;
-}
+export type SelectOption = ComponentOption;
 
 export interface SelectProps extends Omit<
   React.SelectHTMLAttributes<HTMLSelectElement>,

package/src/hooks/useForceSimulation.ts

@@ -223,6 +223,11 @@ export function useForceSimulation(
   initialLinks: SimulationLink[],
   options: ForceSimulationOptions
 ): UseForceSimulationReturn & { setForcesEnabled: (enabled: boolean) => void } {
+  /**
+   * Enable or disable the simulation forces (charge and link forces).
+   * When disabled, nodes can still be dragged but won't be affected by forces.
+   * @param enabled - When true, simulation forces are active; when false, forces are disabled
+   */
   const {
     chargeStrength = -300,
     linkDistance = 100,

package/src/types/index.ts

@@ -0,0 +1,9 @@
+/**
+ * Shared types for UI components
+ */
+
+export interface ComponentOption {
+  value: string;
+  label: string;
+  disabled?: boolean;
+}

package/src/utils/__tests__/score.test.ts

@@ -1,11 +1,5 @@
 import { describe, it, expect } from 'vitest';
-import {
-  scoreColor,
-  scoreBg,
-  scoreLabel,
-  scoreGlow,
-  getScoreRating,
-} from '../score';
+import { scoreColor, scoreBg, scoreLabel, getScoreRating } from '../score';
 
 describe('Score Utilities', () => {
   it('should return correct color for scores', () => {

package/src/utils/score.ts

@@ -43,6 +43,8 @@ export function scoreGlow(score: number | null | undefined): string {
   return 'shadow-red-500/20';
 }
 
+import { getRatingSlug } from '@aiready/core/client';
+
 /**
  * Get rating from score (for use with ScoreBar component)
  */
@@ -50,9 +52,6 @@ export function getScoreRating(
   score: number | null | undefined
 ): 'excellent' | 'good' | 'fair' | 'needs-work' | 'critical' {
   if (score == null) return 'critical';
-  if (score >= 90) return 'excellent';
-  if (score >= 75) return 'good';
-  if (score >= 60) return 'fair';
-  if (score >= 40) return 'needs-work';
-  return 'critical';
+  // Use core implementation to resolve duplication
+  return getRatingSlug(score) as any;
 }