@fragments-sdk/context 0.3.1 → 0.3.3

package/LICENSE

@@ -1,21 +1,81 @@
-MIT License
+Functional Source License, Version 1.1, MIT Future License
 
-Copyright (c) 2024 Conan McNicholl
+Licensor:  Conan McNicholl
+Software:  @fragments-sdk/context
 
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
+---
 
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
+## Terms and Conditions
+
+### Licensor ("We")
+
+The individual or entity listed above.
+
+### The Software
+
+The software identified above, including all source code, object code,
+documentation, and other files provided by the Licensor.
+
+### Grant of Rights
+
+Subject to the conditions below, the Licensor grants you a non-exclusive,
+worldwide, royalty-free license to use, copy, modify, create derivative works,
+and redistribute the Software, in each case subject to the limitations below.
+
+### Limitation — Competing Use
+
+You may not use the Software in, or to provide, a Commercial Product or Service
+that competes with the Software or with any product or service that the Licensor
+provides using the Software. A "Commercial Product or Service" is any product or
+service offered to third parties for a fee or other consideration.
+
+For clarity, the following uses are always permitted regardless of this limitation:
+
+  - Using the Software for your own internal business purposes
+  - Using the Software to build and deploy your own applications
+  - Using the Software for personal, educational, or evaluation purposes
+  - Providing professional services (consulting, integration) to your clients
+    that involve configuring or extending the Software
+
+The following are examples of Competing Use that are NOT permitted:
+
+  - Offering a hosted developer tools service that repackages or exposes
+    the functionality of the Software
+  - Selling or distributing a product that is a substitute for any product
+    or service offered by the Licensor
+  - Building and offering an MCP server, CLI tool, or code intelligence
+    platform that is substantially derived from the Software
+
+### Change Date and License
+
+On the second anniversary of each version's release date, the Licensor grants
+you the rights under the terms of the MIT License for that version.
+The "MIT License" means the license identified by SPDX as "MIT" and published
+at https://opensource.org/licenses/MIT.
+
+### No Warranties
 
 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+
+### Limitation of Liability
+
+IN NO EVENT SHALL THE LICENSOR BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+
+### General
+
+If any provision of this License is held to be unenforceable, that provision
+shall be reformed only to the extent necessary to make it enforceable, and the
+remaining provisions shall continue in full force and effect.
+
+This License does not grant permission to use the trade names, trademarks,
+service marks, or product names of the Licensor, except as required for
+reasonable and customary use in describing the origin of the Software.
+
+---
+
+For more information about the Functional Source License, see https://fsl.software/

package/README.md

@@ -60,3 +60,5 @@ pnpm add @fragments-sdk/context
 ```
 
 Requires Node.js 18+. Tree-sitter WASM grammars are included as dependencies.
+
+<img referrerpolicy="no-referrer-when-downgrade" src="https://static.scarf.sh/a.png?x-pxid=a02beb71-df11-498d-8e1f-39de2e64ce5b" />

package/dist/{chunk-HAJWPNLU.js → chunk-NECSN43I.js}

@@ -38,9 +38,18 @@ var MCP_TOOL_DEFINITIONS = [
         type: "boolean",
         description: "If true, includes code examples for each variant"
       },
+      limit: {
+        type: "number",
+        description: "Maximum number of results to return (default: 10 for useCase mode)"
+      },
       includeRelations: {
         type: "boolean",
         description: "If true, includes component relationships"
+      },
+      verbosity: {
+        type: "string",
+        enum: ["compact", "standard", "full"],
+        description: 'Response detail level: "compact" (names only), "standard" (default), "full" (everything including code)'
       }
     }
   },
@@ -55,7 +64,7 @@ var MCP_TOOL_DEFINITIONS = [
       fields: {
         type: "array",
         items: { type: "string" },
-        description: 'Specific fields to return (e.g., ["meta", "usage.when", "contract.propsSummary", "props", "examples", "guidelines"]). If omitted, returns everything. Supports dot notation.'
+        description: 'Specific fields to return (e.g., ["meta", "guidelines.when", "contract.propsSummary", "props", "examples"]). If omitted, returns everything. Supports dot notation. Aliases: "usage" \u2192 "guidelines".'
       },
       variant: {
         type: "string",
@@ -68,6 +77,11 @@ var MCP_TOOL_DEFINITIONS = [
       maxLines: {
         type: "number",
         description: "Maximum lines per code example (truncates longer examples)"
+      },
+      verbosity: {
+        type: "string",
+        enum: ["compact", "standard", "full"],
+        description: 'Response detail level: "compact" (meta + prop names), "standard" (default), "full" (everything)'
       }
     },
     required: ["component"]
@@ -91,6 +105,15 @@ var MCP_TOOL_DEFINITIONS = [
       category: {
         type: "string",
         description: 'Filter by category (e.g., "authentication", "marketing", "dashboard", "settings", "ecommerce", "ai")'
+      },
+      limit: {
+        type: "number",
+        description: "Maximum number of blocks to return (default: all matching)"
+      },
+      verbosity: {
+        type: "string",
+        enum: ["compact", "standard", "full"],
+        description: 'Response detail level: "compact" (no code), "standard" (default, code preview for long blocks), "full" (full code)'
       }
     }
   },
@@ -105,6 +128,10 @@ var MCP_TOOL_DEFINITIONS = [
       search: {
         type: "string",
         description: 'Search token names (e.g., "accent", "hover", "padding")'
+      },
+      limit: {
+        type: "number",
+        description: "Maximum number of tokens to return per category (default: 25 for search, unlimited for category browsing)"
       }
     }
   },
@@ -115,6 +142,15 @@ var MCP_TOOL_DEFINITIONS = [
       useCase: {
         type: "string",
         description: 'What you want to implement (e.g., "login form", "data table with sorting", "streaming chat messages")'
+      },
+      limit: {
+        type: "number",
+        description: "Maximum number of components to return (default: 5)"
+      },
+      verbosity: {
+        type: "string",
+        enum: ["compact", "standard", "full"],
+        description: 'Response detail level: "compact" (names only), "standard" (default), "full" (all props + examples + full block code)'
       }
     },
     required: ["useCase"]
@@ -151,7 +187,7 @@ var MCP_TOOL_DEFINITIONS = [
       },
       variant: {
         type: "string",
-        description: "Variant name for compare mode"
+        description: "Variant name to render (uses the variant's render function from the fragment definition). Works in both render and compare modes."
       },
       threshold: {
         type: "number",
@@ -182,7 +218,7 @@ var MCP_TOOL_DEFINITIONS = [
   },
   {
     key: "graph",
-    description: 'Query the component relationship graph. Understand dependencies, impact analysis, composition trees, alternatives, and design system health. Use "health" for an overview, "dependencies"/"dependents" for direct relationships, "impact" for change analysis, "composition" for compound component trees.',
+    description: 'Query the component relationship graph. Understand dependencies, impact analysis, composition trees, alternatives, and design system health. Use "health" for an overview, "dependencies"/"dependents" for composition and declared relationships (not code-level imports), "impact" for change analysis, "composition" for compound component trees.',
     params: {
       mode: {
         type: "string",

package/dist/generate/index.d.ts

@@ -1,5 +1,5 @@
 import { CompiledFragment, CompiledBlock } from '../types/index.js';
-import '../types-DOhSojcf.js';
+import '../types-RAbbckR4.js';
 
 /**
  * Context generation for AI agents.

package/dist/graph/index.d.ts

@@ -1,5 +1,5 @@
-import { C as ComponentGraph, G as GraphEdgeType, a as GraphEdge, I as ImpactResult, P as PathResult, N as NeighborResult, b as CompositionTree, c as GraphHealth, d as ComponentNode, S as SerializedComponentGraph } from '../types-DOhSojcf.js';
-export { E as EDGE_TYPE_WEIGHTS, f as GRAPH_EDGE_TYPES, e as SerializedEdge } from '../types-DOhSojcf.js';
+import { C as ComponentGraph, G as GraphEdgeType, a as GraphEdge, I as ImpactResult, P as PathResult, N as NeighborResult, b as CompositionTree, c as GraphHealth, d as ComponentNode, S as SerializedComponentGraph } from '../types-RAbbckR4.js';
+export { E as EDGE_TYPE_WEIGHTS, f as GRAPH_EDGE_TYPES, e as SerializedEdge } from '../types-RAbbckR4.js';
 
 /**
  * ComponentGraphEngine — query engine for the design-system relationship graph.
@@ -33,7 +33,7 @@ declare class ComponentGraphEngine {
     neighbors(component: string, maxHops?: number): NeighborResult;
     /** Get the composition tree for a compound component */
     composition(component: string): CompositionTree;
-    /** Get alternative components */
+    /** Get alternative components (deduplicated for bidirectional edges) */
     alternatives(component: string): Array<{
         component: string;
         note?: string;

package/dist/graph/index.js

@@ -203,7 +203,7 @@ var ComponentGraphEngine = class {
     const node = this.nodes.get(component);
     const subComponents = node?.subComponents ?? [];
     const parentEdges = (this.outgoing.get(component) ?? []).filter((e) => e.type === "parent-of");
-    const requiredChildren = parentEdges.map((e) => e.target);
+    const children = parentEdges.map((e) => e.target);
     const childEdges = (this.incoming.get(component) ?? []).filter((e) => e.type === "parent-of");
     const parent = childEdges.length > 0 ? childEdges[0].source : void 0;
     const siblings = [];
@@ -227,22 +227,25 @@ var ComponentGraphEngine = class {
       component,
       compositionPattern: node?.compositionPattern,
       subComponents,
-      requiredChildren,
+      children,
       parent,
       siblings,
       blocks: this.blockIndex.get(component) ?? []
     };
   }
-  /** Get alternative components */
+  /** Get alternative components (deduplicated for bidirectional edges) */
   alternatives(component) {
+    const seen = /* @__PURE__ */ new Set();
     const alts = [];
     for (const edge of this.outgoing.get(component) ?? []) {
-      if (edge.type === "alternative-to") {
+      if (edge.type === "alternative-to" && !seen.has(edge.target)) {
+        seen.add(edge.target);
         alts.push({ component: edge.target, note: edge.note });
       }
     }
     for (const edge of this.incoming.get(component) ?? []) {
-      if (edge.type === "alternative-to") {
+      if (edge.type === "alternative-to" && !seen.has(edge.source)) {
+        seen.add(edge.source);
         alts.push({ component: edge.source, note: edge.note });
       }
     }

package/dist/index.d.ts

@@ -8,4 +8,4 @@ export { AST_SUPPORTED_LANGUAGES, ChangedFiles, FileEntry, GrammarMapping, INDEX
 export { ChunkMapping, CitationDocumentBlock, CitationDocumentOptions, DocumentMapping, RawCitation, ResolvedCitation, buildCitationDocuments, resolveCitation, resolveCitations } from './citations/index.js';
 export { CLI_TOOL_EXTENSIONS, CliToolExtension, MCP_TOOL_DEFINITIONS, McpToolDefinition, McpToolParam, buildMcpTools, buildToolNames } from './mcp-tools/index.js';
 export { CLI_COMMANDS, CLI_COMMAND_CATEGORIES, CliCategoryInfo, CliCommandCategory, CliCommandDef, CliOptionDef } from './cli-commands/index.js';
-import './types-DOhSojcf.js';
+import './types-RAbbckR4.js';

package/dist/index.js

@@ -3,7 +3,7 @@ import {
   MCP_TOOL_DEFINITIONS,
   buildMcpTools,
   buildToolNames
-} from "./chunk-HAJWPNLU.js";
+} from "./chunk-NECSN43I.js";
 import {
   CLI_COMMANDS,
   CLI_COMMAND_CATEGORIES

package/dist/mcp-tools/index.js

@@ -3,7 +3,7 @@ import {
   MCP_TOOL_DEFINITIONS,
   buildMcpTools,
   buildToolNames
-} from "../chunk-HAJWPNLU.js";
+} from "../chunk-NECSN43I.js";
 export {
   CLI_TOOL_EXTENSIONS,
   MCP_TOOL_DEFINITIONS,

package/dist/types/index.d.ts

@@ -1,4 +1,4 @@
-import { S as SerializedComponentGraph } from '../types-DOhSojcf.js';
+import { S as SerializedComponentGraph } from '../types-RAbbckR4.js';
 
 /**
  * Compiled fragment types — shared between CLI and MCP packages.
@@ -122,6 +122,7 @@ interface CompiledBlock {
  */
 interface CompiledTokenEntry {
     name: string;
+    value?: string;
     description?: string;
 }
 /**

package/dist/{types-DOhSojcf.d.ts → types-RAbbckR4.d.ts}

@@ -87,8 +87,8 @@ interface CompositionTree {
     compositionPattern?: 'compound' | 'simple' | 'controlled';
     /** Direct sub-components */
     subComponents: string[];
-    /** Sub-components that must be present */
-    requiredChildren: string[];
+    /** Components that declare this component as their parent */
+    children: string[];
     /** Parent component (if this is a sub-component) */
     parent?: string;
     /** Sibling components at the same level */

package/package.json

@@ -1,7 +1,10 @@
 {
   "name": "@fragments-sdk/context",
-  "version": "0.3.1",
+  "version": "0.3.3",
+  "license": "FSL-1.1-MIT",
   "description": "Code intelligence and RAG primitives for design system and codebase indexing",
+  "author": "Conan McNicholl",
+  "homepage": "https://usefragments.com",
   "repository": {
     "type": "git",
     "url": "https://github.com/ConanMcN/fragments"
@@ -56,13 +59,27 @@
       "import": "./dist/graph/index.js"
     }
   },
+  "keywords": [
+    "rag",
+    "embeddings",
+    "code-intelligence",
+    "chunking",
+    "search",
+    "indexing",
+    "ai",
+    "context"
+  ],
   "publishConfig": {
     "access": "public"
   },
   "files": [
     "dist"
   ],
+  "scarfSettings": {
+    "defaultOptIn": true
+  },
   "dependencies": {
+    "@scarf/scarf": "^1.4.0",
     "tree-sitter-go": "^0.25.0",
     "tree-sitter-java": "^0.23.5",
     "tree-sitter-javascript": "^0.25.0",