@fragments-sdk/context 0.3.0 → 0.3.1

package/dist/{chunk-KKABP4K4.js → chunk-2UQY4VNM.js}

@@ -10,7 +10,7 @@ function filterPlaceholders(items) {
     (item) => !PLACEHOLDER_PATTERNS.some((pattern) => pattern.test(item.trim()))
   );
 }
-function generateContext(segments, options = {}, blocks) {
+function generateContext(fragments, options = {}, blocks) {
   const format = options.format ?? "markdown";
   const compact = options.compact ?? false;
   const include = {
@@ -20,7 +20,7 @@ function generateContext(segments, options = {}, blocks) {
     relations: options.include?.relations ?? false,
     code: options.include?.code ?? false
   };
-  const sorted = [...segments].sort((a, b) => {
+  const sorted = [...fragments].sort((a, b) => {
     const catCompare = a.meta.category.localeCompare(b.meta.category);
     if (catCompare !== 0) return catCompare;
     return a.meta.name.localeCompare(b.meta.name);
@@ -30,7 +30,7 @@ function generateContext(segments, options = {}, blocks) {
   }
   return generateMarkdownContext(sorted, include, compact, blocks);
 }
-function generateMarkdownContext(segments, include, compact, blocks) {
+function generateMarkdownContext(fragments, include, compact, blocks) {
   const lines = [];
   lines.push("# Design System Reference");
   lines.push("");
@@ -38,10 +38,10 @@ function generateMarkdownContext(segments, include, compact, blocks) {
   lines.push("");
   lines.push("| Component | Category | Use For |");
   lines.push("|-----------|----------|---------|");
-  for (const segment of segments) {
-    const filteredWhen = filterPlaceholders(segment.usage.when);
-    const useFor = filteredWhen.slice(0, 2).join(", ") || segment.meta.description;
-    lines.push(`| ${segment.meta.name} | ${segment.meta.category} | ${truncate(useFor, 50)} |`);
+  for (const fragment of fragments) {
+    const filteredWhen = filterPlaceholders(fragment.usage.when);
+    const useFor = filteredWhen.slice(0, 2).join(", ") || fragment.meta.description;
+    lines.push(`| ${fragment.meta.name} | ${fragment.meta.category} | ${truncate(useFor, 50)} |`);
   }
   lines.push("");
   if (compact) {
@@ -50,21 +50,21 @@ function generateMarkdownContext(segments, include, compact, blocks) {
   }
   lines.push("## Components");
   lines.push("");
-  for (const segment of segments) {
-    lines.push(`### ${segment.meta.name}`);
+  for (const fragment of fragments) {
+    lines.push(`### ${fragment.meta.name}`);
     lines.push("");
-    const statusParts = [`**Category:** ${segment.meta.category}`];
-    if (segment.meta.status) {
-      statusParts.push(`**Status:** ${segment.meta.status}`);
+    const statusParts = [`**Category:** ${fragment.meta.category}`];
+    if (fragment.meta.status) {
+      statusParts.push(`**Status:** ${fragment.meta.status}`);
     }
     lines.push(statusParts.join(" | "));
     lines.push("");
-    if (segment.meta.description) {
-      lines.push(segment.meta.description);
+    if (fragment.meta.description) {
+      lines.push(fragment.meta.description);
       lines.push("");
     }
-    const whenFiltered = filterPlaceholders(segment.usage.when);
-    const whenNotFiltered = filterPlaceholders(segment.usage.whenNot);
+    const whenFiltered = filterPlaceholders(fragment.usage.when);
+    const whenNotFiltered = filterPlaceholders(fragment.usage.whenNot);
     if (include.usage && (whenFiltered.length > 0 || whenNotFiltered.length > 0)) {
       if (whenFiltered.length > 0) {
         lines.push("**When to use:**");
@@ -81,19 +81,19 @@ function generateMarkdownContext(segments, include, compact, blocks) {
         lines.push("");
       }
     }
-    if (include.props && Object.keys(segment.props).length > 0) {
+    if (include.props && Object.keys(fragment.props).length > 0) {
       lines.push("**Props:**");
-      for (const [name, prop] of Object.entries(segment.props)) {
+      for (const [name, prop] of Object.entries(fragment.props)) {
         lines.push(`- \`${name}\`: ${formatPropType(prop)}${prop.required ? " (required)" : ""}`);
       }
       lines.push("");
     }
-    if (include.variants && segment.variants.length > 0) {
-      const variantNames = segment.variants.map((v) => v.name).join(", ");
+    if (include.variants && fragment.variants.length > 0) {
+      const variantNames = fragment.variants.map((v) => v.name).join(", ");
       lines.push(`**Variants:** ${variantNames}`);
       lines.push("");
       if (include.code) {
-        for (const variant of segment.variants) {
+        for (const variant of fragment.variants) {
           if (variant.code) {
             lines.push(`*${variant.name}:*`);
             lines.push("```tsx");
@@ -104,9 +104,9 @@ function generateMarkdownContext(segments, include, compact, blocks) {
         }
       }
     }
-    if (include.relations && segment.relations && segment.relations.length > 0) {
+    if (include.relations && fragment.relations && fragment.relations.length > 0) {
       lines.push("**Related:**");
-      for (const relation of segment.relations) {
+      for (const relation of fragment.relations) {
         lines.push(`- ${relation.component} (${relation.relationship}): ${relation.note}`);
       }
       lines.push("");
@@ -141,27 +141,27 @@ function generateMarkdownContext(segments, include, compact, blocks) {
   const content = lines.join("\n");
   return { content, tokenEstimate: estimateTokens(content) };
 }
-function generateJsonContext(segments, include, compact, blocks) {
-  const categories = [...new Set(segments.map((s) => s.meta.category))].sort();
+function generateJsonContext(fragments, include, compact, blocks) {
+  const categories = [...new Set(fragments.map((s) => s.meta.category))].sort();
   const components = {};
-  for (const segment of segments) {
+  for (const fragment of fragments) {
     const component = {
-      category: segment.meta.category,
-      description: segment.meta.description
+      category: fragment.meta.category,
+      description: fragment.meta.description
     };
-    if (segment.meta.status) {
-      component.status = segment.meta.status;
+    if (fragment.meta.status) {
+      component.status = fragment.meta.status;
     }
     if (!compact) {
       if (include.usage) {
-        const whenFiltered = filterPlaceholders(segment.usage.when);
-        const whenNotFiltered = filterPlaceholders(segment.usage.whenNot);
+        const whenFiltered = filterPlaceholders(fragment.usage.when);
+        const whenNotFiltered = filterPlaceholders(fragment.usage.whenNot);
         if (whenFiltered.length > 0) component.whenToUse = whenFiltered;
         if (whenNotFiltered.length > 0) component.whenNotToUse = whenNotFiltered;
       }
-      if (include.props && Object.keys(segment.props).length > 0) {
+      if (include.props && Object.keys(fragment.props).length > 0) {
         component.props = {};
-        for (const [name, prop] of Object.entries(segment.props)) {
+        for (const [name, prop] of Object.entries(fragment.props)) {
           component.props[name] = {
             type: formatPropType(prop),
             description: prop.description
@@ -170,18 +170,18 @@ function generateJsonContext(segments, include, compact, blocks) {
           if (prop.default !== void 0) component.props[name].default = prop.default;
         }
       }
-      if (include.variants && segment.variants.length > 0) {
-        component.variants = segment.variants.map((v) => v.name);
+      if (include.variants && fragment.variants.length > 0) {
+        component.variants = fragment.variants.map((v) => v.name);
       }
-      if (include.relations && segment.relations && segment.relations.length > 0) {
-        component.relations = segment.relations.map((r) => ({
+      if (include.relations && fragment.relations && fragment.relations.length > 0) {
+        component.relations = fragment.relations.map((r) => ({
           component: r.component,
           relationship: r.relationship,
           note: r.note
         }));
       }
     }
-    components[segment.meta.name] = component;
+    components[fragment.meta.name] = component;
   }
   const blocksMap = blocks && blocks.length > 0 ? Object.fromEntries(blocks.map((b) => [b.name, {
     description: b.description,
@@ -194,7 +194,7 @@ function generateJsonContext(segments, include, compact, blocks) {
     version: "1.0",
     generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
     summary: {
-      totalComponents: segments.length,
+      totalComponents: fragments.length,
       categories,
       ...blocksMap && { totalBlocks: blocks.length }
     },

package/dist/{chunk-U4V5NX67.js → chunk-IQMVRBVF.js}

@@ -399,7 +399,7 @@ var CLI_COMMANDS = [
     options: [
       { flags: "-c, --config <path>", description: "Path to config file" },
       { flags: "-o, --output <dir>", description: "Output directory", default: ".storybook/generated" },
-      { flags: "--watch", description: "Watch for segment changes and regenerate" },
+      { flags: "--watch", description: "Watch for fragment changes and regenerate" },
       { flags: "--format <format>", description: "Story format (csf3)", default: "csf3" }
     ]
   },

package/dist/cli-commands/index.js

@@ -1,7 +1,7 @@
 import {
   CLI_COMMANDS,
   CLI_COMMAND_CATEGORIES
-} from "../chunk-U4V5NX67.js";
+} from "../chunk-IQMVRBVF.js";
 export {
   CLI_COMMANDS,
   CLI_COMMAND_CATEGORIES

package/dist/generate/index.d.ts

@@ -1,4 +1,4 @@
-import { CompiledSegment, CompiledBlock } from '../types/index.js';
+import { CompiledFragment, CompiledBlock } from '../types/index.js';
 import '../types-DOhSojcf.js';
 
 /**
@@ -37,8 +37,8 @@ interface ContextResult {
     tokenEstimate: number;
 }
 /**
- * Generate AI-ready context from compiled segments and optional blocks
+ * Generate AI-ready context from compiled fragments and optional blocks
  */
-declare function generateContext(segments: CompiledSegment[], options?: ContextOptions, blocks?: CompiledBlock[]): ContextResult;
+declare function generateContext(fragments: CompiledFragment[], options?: ContextOptions, blocks?: CompiledBlock[]): ContextResult;
 
 export { type ContextOptions, type ContextResult, PLACEHOLDER_PATTERNS, filterPlaceholders, generateContext };

package/dist/generate/index.js

@@ -2,7 +2,7 @@ import {
   PLACEHOLDER_PATTERNS,
   filterPlaceholders,
   generateContext
-} from "../chunk-KKABP4K4.js";
+} from "../chunk-2UQY4VNM.js";
 export {
   PLACEHOLDER_PATTERNS,
   filterPlaceholders,

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { AIMetadata, CompiledBlock, CompiledSegment, CompiledSegmentsFile, CompiledTokenData, CompiledTokenEntry, ComponentRelation, PropDefinition, SegmentContract, SegmentGenerated, SegmentMeta, SegmentUsage, Theme, VerifyResult } from './types/index.js';
+export { AIMetadata, CompiledBlock, CompiledFragment, CompiledFragmentsFile, CompiledTokenData, CompiledTokenEntry, ComponentRelation, FragmentContract, FragmentGenerated, FragmentMeta, FragmentUsage, PropDefinition, Theme, VerifyResult } from './types/index.js';
 export { ContextOptions, ContextResult, PLACEHOLDER_PATTERNS, filterPlaceholders, generateContext } from './generate/index.js';
 export { ASTChunkerOptions, ChunkOptions, CodeChunk, chunkByAST, chunkByLines, chunkFile } from './chunking/index.js';
 export { EmbeddingOptions, EmbeddingResult, RerankOptions, RerankResult, generateEmbeddings, rerankResults } from './embeddings/voyage.js';

package/dist/index.js

@@ -7,7 +7,7 @@ import {
 import {
   CLI_COMMANDS,
   CLI_COMMAND_CATEGORIES
-} from "./chunk-U4V5NX67.js";
+} from "./chunk-IQMVRBVF.js";
 import {
   chunkByAST,
   chunkByLines,
@@ -36,7 +36,7 @@ import {
   PLACEHOLDER_PATTERNS,
   filterPlaceholders,
   generateContext
-} from "./chunk-KKABP4K4.js";
+} from "./chunk-2UQY4VNM.js";
 import {
   buildCitationDocuments,
   resolveCitation,

package/dist/types/index.d.ts

@@ -9,7 +9,7 @@ import { S as SerializedComponentGraph } from '../types-DOhSojcf.js';
 /**
  * Component metadata
  */
-interface SegmentMeta {
+interface FragmentMeta {
     name: string;
     description: string;
     category: string;
@@ -22,7 +22,7 @@ interface SegmentMeta {
 /**
  * Usage guidelines for AI agents and developers
  */
-interface SegmentUsage {
+interface FragmentUsage {
     when: string[];
     whenNot: string[];
     guidelines?: string[];
@@ -58,7 +58,7 @@ interface ComponentRelation {
 /**
  * Agent-optimized contract metadata
  */
-interface SegmentContract {
+interface FragmentContract {
     propsSummary?: string[];
     a11yRules?: string[];
     bans?: Array<{
@@ -68,9 +68,9 @@ interface SegmentContract {
     scenarioTags?: string[];
 }
 /**
- * Provenance tracking for generated segments
+ * Provenance tracking for generated fragments
  */
-interface SegmentGenerated {
+interface FragmentGenerated {
     source: "storybook" | "manual" | "ai";
     sourceFile?: string;
     confidence?: number;
@@ -86,12 +86,12 @@ interface AIMetadata {
     commonPatterns?: string[];
 }
 /**
- * Compiled segment data (JSON-serializable for AI consumption)
+ * Compiled fragment data (JSON-serializable for AI consumption)
  */
-interface CompiledSegment {
+interface CompiledFragment {
     filePath: string;
-    meta: SegmentMeta;
-    usage: SegmentUsage;
+    meta: FragmentMeta;
+    usage: FragmentUsage;
     props: Record<string, PropDefinition>;
     relations?: ComponentRelation[];
     variants: Array<{
@@ -101,9 +101,9 @@ interface CompiledSegment {
         figma?: string;
         args?: Record<string, unknown>;
     }>;
-    contract?: SegmentContract;
+    contract?: FragmentContract;
     ai?: AIMetadata;
-    _generated?: SegmentGenerated;
+    _generated?: FragmentGenerated;
 }
 /**
  * Compiled block data (JSON-serializable for AI consumption)
@@ -135,11 +135,11 @@ interface CompiledTokenData {
 /**
  * The compiled fragments.json structure
  */
-interface CompiledSegmentsFile {
+interface CompiledFragmentsFile {
     version: string;
     generatedAt: string;
     packageName?: string;
-    segments: Record<string, CompiledSegment>;
+    fragments: Record<string, CompiledFragment>;
     blocks?: Record<string, CompiledBlock>;
     tokens?: CompiledTokenData;
     /** Component relationship graph for AI structural queries */
@@ -171,4 +171,4 @@ interface VerifyResult {
     };
 }
 
-export type { AIMetadata, CompiledBlock, CompiledSegment, CompiledSegmentsFile, CompiledTokenData, CompiledTokenEntry, ComponentRelation, PropDefinition, SegmentContract, SegmentGenerated, SegmentMeta, SegmentUsage, Theme, VerifyResult };
+export type { AIMetadata, CompiledBlock, CompiledFragment, CompiledFragmentsFile, CompiledTokenData, CompiledTokenEntry, ComponentRelation, FragmentContract, FragmentGenerated, FragmentMeta, FragmentUsage, PropDefinition, Theme, VerifyResult };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fragments-sdk/context",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Code intelligence and RAG primitives for design system and codebase indexing",
   "repository": {
     "type": "git",