@fragments-sdk/cli 0.2.2

package/src/shared/segment-loader.ts

@@ -0,0 +1,59 @@
+/**
+ * Segment Loader
+ *
+ * Utilities for loading segment data from the dev server or segments.json
+ */
+
+import type { SegmentInfo } from './types.js';
+import { DevServerClient, createDevServerClient } from './dev-server-client.js';
+
+/**
+ * Options for loading segments
+ */
+export interface LoadSegmentsOptions {
+  /** Dev server port */
+  port?: number | string;
+  /** Filter by component name */
+  component?: string;
+}
+
+/**
+ * Load segments from the dev server
+ */
+export async function loadSegments(options: LoadSegmentsOptions = {}): Promise<SegmentInfo[]> {
+  const { port = 6006, component } = options;
+
+  const client = createDevServerClient(port);
+  let segments = await client.getSegments();
+
+  // Filter by component if specified
+  if (component) {
+    segments = segments.filter(
+      s => s.name.toLowerCase() === component.toLowerCase()
+    );
+  }
+
+  return segments;
+}
+
+/**
+ * Load a single segment by name
+ */
+export async function loadSegment(
+  name: string,
+  options: { port?: number | string } = {}
+): Promise<SegmentInfo | null> {
+  const segments = await loadSegments({ ...options, component: name });
+  return segments.length > 0 ? segments[0] : null;
+}
+
+/**
+ * Check if a segment exists
+ */
+export async function segmentExists(
+  name: string,
+  options: { port?: number | string } = {}
+): Promise<boolean> {
+  const segment = await loadSegment(name, options);
+  return segment !== null;
+}

package/src/shared/types.ts

@@ -0,0 +1,147 @@
+/**
+ * Shared types for CLI commands
+ */
+
+/**
+ * Violation item from compliance checks
+ */
+export interface ViolationItem {
+  /** CSS property that has the issue */
+  property: string;
+  /** Description of the issue */
+  issue: string;
+  /** Severity level */
+  severity: 'error' | 'warning';
+  /** Suggested fix */
+  suggestion?: string;
+  /** Expected value (e.g., token name) */
+  expected?: string;
+  /** Actual value found */
+  actual?: string;
+}
+
+/**
+ * Result from verify command
+ */
+export interface VerifyResult {
+  /** Component name */
+  component: string;
+  /** Compliance percentage (0-100) */
+  compliance: number;
+  /** Whether it passed the threshold */
+  passed: boolean;
+  /** List of violations found */
+  violations: ViolationItem[];
+  /** Total properties checked */
+  totalProperties: number;
+  /** Number of hardcoded values */
+  hardcoded: number;
+  /** Number of properties using tokens */
+  usingTokens: number;
+}
+
+/**
+ * Result from audit command
+ */
+export interface AuditResult {
+  /** Component name */
+  name: string;
+  /** Component category */
+  category: string;
+  /** Compliance percentage (0-100) */
+  compliance: number;
+  /** Number of hardcoded values */
+  hardcoded: number;
+  /** Number of token mismatches */
+  tokenMismatches: number;
+  /** Total properties checked */
+  totalProperties: number;
+}
+
+/**
+ * Compliance data from the server
+ */
+export interface ComplianceResult {
+  /** Component name */
+  component: string;
+  /** Variant name (if specified) */
+  variant?: string;
+  /** Compliance percentage (0-100) */
+  compliance: number;
+  /** Total properties analyzed */
+  totalProperties: number;
+  /** Number of hardcoded values */
+  hardcoded: number;
+  /** Number of properties using tokens */
+  usingTokens: number;
+  /** List of violations */
+  violations: ViolationItem[];
+  /** Whether compliance meets threshold */
+  passed?: boolean;
+}
+
+/**
+ * Segment information from context endpoint
+ */
+export interface SegmentInfo {
+  /** Component name */
+  name: string;
+  /** Component category */
+  category: string;
+  /** Figma URL if linked */
+  figma?: string;
+  /** Description */
+  description?: string;
+  /** Component status */
+  status?: string;
+}
+
+/**
+ * Generic command result
+ */
+export interface CommandResult {
+  /** Whether the command succeeded */
+  success: boolean;
+  /** Error messages */
+  errors: string[];
+}
+
+/**
+ * Context data from the /segments/context endpoint
+ */
+export interface ContextData {
+  /** List of components */
+  components: SegmentInfo[];
+}
+
+/**
+ * A11y variant result from the server
+ */
+export interface A11yVariantResult {
+  /** Variant name */
+  variant: string;
+  /** Number of violations */
+  violations: number;
+  /** Number of passes */
+  passes: number;
+  /** Number of incomplete checks */
+  incomplete: number;
+  /** Summary by severity */
+  summary: {
+    total: number;
+    critical: number;
+    serious: number;
+    moderate: number;
+    minor: number;
+  };
+}
+
+/**
+ * A11y result from the /fragments/a11y endpoint
+ */
+export interface A11yResult {
+  /** Component name */
+  component: string;
+  /** Results for each variant */
+  results: A11yVariantResult[];
+}