@fragments-sdk/context 0.2.0 → 0.3.1

package/dist/types-DOhSojcf.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Component Graph data model — types for the design-system-semantic relationship graph.
+ *
+ * These types describe nodes (components), edges (relationships), and health
+ * metrics that together give AI agents structural understanding of a design system.
+ */
+type GraphEdgeType = 'imports' | 'hook-depends' | 'renders' | 'composes' | 'parent-of' | 'alternative-to' | 'sibling-of';
+declare const GRAPH_EDGE_TYPES: readonly GraphEdgeType[];
+/** Default weight for each edge type */
+declare const EDGE_TYPE_WEIGHTS: Record<GraphEdgeType, number>;
+interface ComponentNode {
+    name: string;
+    category: string;
+    status: string;
+    compositionPattern?: 'compound' | 'simple' | 'controlled';
+    subComponents?: string[];
+}
+interface GraphEdge {
+    source: string;
+    target: string;
+    type: GraphEdgeType;
+    weight: number;
+    note?: string;
+    /** Where this edge was detected from */
+    provenance: string;
+}
+interface GraphHealth {
+    /** Components with zero edges */
+    orphans: string[];
+    /** Top components by total degree (in + out) */
+    hubs: Array<{
+        name: string;
+        degree: number;
+    }>;
+    /** Percentage of components appearing in at least one block */
+    compositionCoverage: number;
+    /** Disconnected groups (BFS on undirected projection) */
+    connectedComponents: string[][];
+    /** Average degree across all nodes */
+    averageDegree: number;
+    /** Total node and edge counts */
+    nodeCount: number;
+    edgeCount: number;
+}
+interface ComponentGraph {
+    nodes: ComponentNode[];
+    edges: GraphEdge[];
+    health: GraphHealth;
+}
+interface ImpactResult {
+    /** The component that was changed */
+    component: string;
+    /** Components affected at each depth level */
+    affected: Array<{
+        component: string;
+        depth: number;
+        path: string[];
+        edgeType: GraphEdgeType;
+    }>;
+    /** Blocks that use the changed component or any affected component */
+    affectedBlocks: string[];
+    /** Total count of affected components */
+    totalAffected: number;
+}
+interface PathResult {
+    /** Whether a path exists */
+    found: boolean;
+    /** Nodes along the shortest path (including source and target) */
+    path: string[];
+    /** Edges along the shortest path */
+    edges: GraphEdge[];
+}
+interface NeighborResult {
+    /** The center component */
+    component: string;
+    /** All components reachable within maxHops */
+    neighbors: Array<{
+        component: string;
+        hops: number;
+        edgeType: GraphEdgeType;
+    }>;
+}
+interface CompositionTree {
+    /** The root component */
+    component: string;
+    /** Composition pattern */
+    compositionPattern?: 'compound' | 'simple' | 'controlled';
+    /** Direct sub-components */
+    subComponents: string[];
+    /** Sub-components that must be present */
+    requiredChildren: string[];
+    /** Parent component (if this is a sub-component) */
+    parent?: string;
+    /** Sibling components at the same level */
+    siblings: string[];
+    /** Blocks that use this component */
+    blocks: string[];
+}
+interface SerializedEdge {
+    /** source */
+    s: string;
+    /** target */
+    t: string;
+    /** type */
+    ty: GraphEdgeType;
+    /** weight */
+    w: number;
+    /** note (optional) */
+    no?: string;
+    /** provenance */
+    p: string;
+}
+interface SerializedComponentGraph {
+    nodes: ComponentNode[];
+    edges: SerializedEdge[];
+    health: GraphHealth;
+}
+
+export { type ComponentGraph as C, EDGE_TYPE_WEIGHTS as E, type GraphEdgeType as G, type ImpactResult as I, type NeighborResult as N, type PathResult as P, type SerializedComponentGraph as S, type GraphEdge as a, type CompositionTree as b, type GraphHealth as c, type ComponentNode as d, type SerializedEdge as e, GRAPH_EDGE_TYPES as f };

package/package.json

@@ -1,7 +1,11 @@
 {
   "name": "@fragments-sdk/context",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "Code intelligence and RAG primitives for design system and codebase indexing",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ConanMcN/fragments"
+  },
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -38,6 +42,18 @@
     "./citations": {
       "types": "./dist/citations/index.d.ts",
       "import": "./dist/citations/index.js"
+    },
+    "./mcp-tools": {
+      "types": "./dist/mcp-tools/index.d.ts",
+      "import": "./dist/mcp-tools/index.js"
+    },
+    "./cli-commands": {
+      "types": "./dist/cli-commands/index.d.ts",
+      "import": "./dist/cli-commands/index.js"
+    },
+    "./graph": {
+      "types": "./dist/graph/index.d.ts",
+      "import": "./dist/graph/index.js"
     }
   },
   "publishConfig": {