@fragments-sdk/cli 0.8.1 → 0.9.1

package/dist/{chunk-GOVI6COW.js → chunk-NVSPGSKB.js}

@@ -52,8 +52,8 @@ var fragmentMetaSchema = z.object({
   figmaProps: z.record(figmaPropMappingSchema).optional()
 });
 var fragmentUsageSchema = z.object({
-  when: z.array(z.string()).min(1),
-  whenNot: z.array(z.string()).min(1),
+  when: z.array(z.string()),
+  whenNot: z.array(z.string()),
   guidelines: z.array(z.string()).optional(),
   accessibility: z.array(z.string()).optional()
 });
@@ -172,7 +172,15 @@ var fragmentsConfigSchema = z.object({
         bundleSize: z.number().positive().optional()
       }).optional()
     })
-  ]).optional()
+  ]).optional(),
+  storybook: z.object({
+    exclude: z.array(z.string()).optional(),
+    include: z.array(z.string()).optional(),
+    excludeDeprecated: z.boolean().optional(),
+    excludeTests: z.boolean().optional(),
+    excludeSvgIcons: z.boolean().optional(),
+    excludeSubComponents: z.boolean().optional()
+  }).optional()
 });
 var recipeDefinitionSchema = blockDefinitionSchema;
 
@@ -192,4 +200,4 @@ export {
   fragmentsConfigSchema,
   recipeDefinitionSchema
 };
-//# sourceMappingURL=chunk-GOVI6COW.js.map
+//# sourceMappingURL=chunk-NVSPGSKB.js.map

package/dist/chunk-NVSPGSKB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/schema.ts"],"sourcesContent":["import { z } from 'zod';\n\n/**\n * Zod schemas for runtime validation of fragment definitions\n */\n\n// Figma property mapping schemas\nconst figmaStringMappingSchema = z.object({\n  __type: z.literal('figma-string'),\n  figmaProperty: z.string().min(1),\n});\n\nconst figmaBooleanMappingSchema = z.object({\n  __type: z.literal('figma-boolean'),\n  figmaProperty: z.string().min(1),\n  valueMapping: z.object({ true: z.unknown(), false: z.unknown() }).optional(),\n});\n\nconst figmaEnumMappingSchema = z.object({\n  __type: z.literal('figma-enum'),\n  figmaProperty: z.string().min(1),\n  valueMapping: z.record(z.unknown()),\n});\n\nconst figmaInstanceMappingSchema = z.object({\n  __type: z.literal('figma-instance'),\n  figmaProperty: z.string().min(1),\n});\n\nconst figmaChildrenMappingSchema = z.object({\n  __type: z.literal('figma-children'),\n  layers: z.array(z.string().min(1)),\n});\n\nconst figmaTextContentMappingSchema = z.object({\n  __type: z.literal('figma-text-content'),\n  layer: z.string().min(1),\n});\n\nexport const figmaPropMappingSchema = z.discriminatedUnion('__type', [\n  figmaStringMappingSchema,\n  figmaBooleanMappingSchema,\n  figmaEnumMappingSchema,\n  figmaInstanceMappingSchema,\n  figmaChildrenMappingSchema,\n  figmaTextContentMappingSchema,\n]);\n\nexport const fragmentMetaSchema = z.object({\n  name: z.string().min(1),\n  description: z.string().min(1),\n  category: z.string().min(1),\n  tags: z.array(z.string()).optional(),\n  status: z.enum(['stable', 'beta', 'deprecated', 'experimental']).optional(),\n  since: z.string().optional(),\n  dependencies: z.array(z.object({\n    name: z.string().min(1),\n    version: z.string().min(1),\n    reason: z.string().optional(),\n  })).optional(),\n  figma: z.string().url().optional(),\n  figmaProps: z.record(figmaPropMappingSchema).optional(),\n});\n\nexport const fragmentUsageSchema = z.object({\n  when: z.array(z.string()),\n  whenNot: z.array(z.string()),\n  guidelines: z.array(z.string()).optional(),\n  accessibility: z.array(z.string()).optional(),\n});\n\nexport const propTypeSchema: z.ZodType<string> = z.enum([\n  'string',\n  'number',\n  'boolean',\n  'enum',\n  'function',\n  'node',\n  'element',\n  'object',\n  'array',\n  'union',\n  'custom',\n]);\n\nexport const propDefinitionSchema = z.object({\n  type: propTypeSchema,\n  values: z.array(z.string()).readonly().optional(),\n  default: z.unknown().optional(),\n  description: z.string().optional(),\n  required: z.boolean().optional(),\n  constraints: z.array(z.string()).optional(),\n  typeDetails: z.record(z.unknown()).optional(),\n});\n\nexport const relationshipTypeSchema = z.enum([\n  'alternative',\n  'sibling',\n  'parent',\n  'child',\n  'composition',\n  'complementary',\n  'used-by',\n]);\n\nexport const componentRelationSchema = z.object({\n  component: z.string().min(1),\n  relationship: relationshipTypeSchema,\n  note: z.string().min(1),\n});\n\nexport const fragmentVariantSchema = z.object({\n  name: z.string().min(1),\n  description: z.string().min(1),\n  render: z.function().returns(z.unknown()),\n  code: z.string().optional(),\n  figma: z.string().url().optional(),\n});\n\n/**\n * Schema for banned patterns in codebase\n */\nexport const fragmentBanSchema = z.object({\n  pattern: z.string().min(1),\n  message: z.string().min(1),\n});\n\n/**\n * Schema for agent-optimized contract metadata\n */\nexport const fragmentContractSchema = z.object({\n  propsSummary: z.array(z.string()).optional(),\n  a11yRules: z.array(z.string()).optional(),\n  bans: z.array(fragmentBanSchema).optional(),\n  scenarioTags: z.array(z.string()).optional(),\n  performanceBudget: z.number().positive().optional(),\n});\n\n/**\n * Schema for provenance tracking of generated fragments\n */\nexport const fragmentGeneratedSchema = z.object({\n  source: z.enum(['storybook', 'manual', 'ai']),\n  sourceFile: z.string().optional(),\n  confidence: z.number().min(0).max(1).optional(),\n  timestamp: z.string().datetime().optional(),\n});\n\n/**\n * Schema for AI-specific metadata for playground context generation\n */\nexport const aiMetadataSchema = z.object({\n  compositionPattern: z.enum(['compound', 'simple', 'controlled', 'wrapper']).optional(),\n  subComponents: z.array(z.string()).optional(),\n  requiredChildren: z.array(z.string()).optional(),\n  commonPatterns: z.array(z.string()).optional(),\n});\n\n/**\n * Schema for block definitions\n */\nexport const blockDefinitionSchema = z.object({\n  name: z.string().min(1),\n  description: z.string().min(1),\n  category: z.string().min(1),\n  components: z.array(z.string().min(1)).min(1),\n  code: z.string().min(1),\n  tags: z.array(z.string()).optional(),\n});\n\nexport const fragmentDefinitionSchema = z.object({\n  component: z.any(), // Allow any component type (function, class, forwardRef, etc.)\n  meta: fragmentMetaSchema,\n  usage: fragmentUsageSchema,\n  props: z.record(propDefinitionSchema),\n  relations: z.array(componentRelationSchema).optional(),\n  variants: z.array(fragmentVariantSchema), // Allow empty variants array\n  contract: fragmentContractSchema.optional(),\n  ai: aiMetadataSchema.optional(),\n  _generated: fragmentGeneratedSchema.optional(),\n});\n\n/**\n * Config schema - validates required fields, passes through optional config objects.\n * Type definitions are in types.ts - schema just ensures basic structure.\n */\nexport const fragmentsConfigSchema = z.object({\n  include: z.array(z.string()).min(1),\n  exclude: z.array(z.string()).optional(),\n  components: z.array(z.string()).optional(),\n  outFile: z.string().optional(),\n  framework: z.enum(['react', 'vue', 'svelte']).optional(),\n  figmaFile: z.string().url().optional(),\n  figmaToken: z.string().optional(),\n  screenshots: z.object({}).passthrough().optional(),\n  service: z.object({}).passthrough().optional(),\n  registry: z.object({}).passthrough().optional(),\n  tokens: z.object({\n    include: z.array(z.string()).min(1),\n  }).passthrough().optional(),\n  snippets: z.object({\n    mode: z.enum(['warn', 'error']).optional(),\n    scope: z.enum(['snippet', 'snippet+render']).optional(),\n    requireFullSnippet: z.boolean().optional(),\n    allowedExternalModules: z.array(z.string().min(1)).optional(),\n  }).optional(),\n  performance: z.union([\n    z.enum(['strict', 'standard', 'relaxed']),\n    z.object({\n      preset: z.enum(['strict', 'standard', 'relaxed']).optional(),\n      budgets: z.object({\n        bundleSize: z.number().positive().optional(),\n      }).optional(),\n    }),\n  ]).optional(),\n  storybook: z.object({\n    exclude: z.array(z.string()).optional(),\n    include: z.array(z.string()).optional(),\n    excludeDeprecated: z.boolean().optional(),\n    excludeTests: z.boolean().optional(),\n    excludeSvgIcons: z.boolean().optional(),\n    excludeSubComponents: z.boolean().optional(),\n  }).optional(),\n});\n\n/**\n * @deprecated Use blockDefinitionSchema instead\n */\nexport const recipeDefinitionSchema = blockDefinitionSchema;\n"],"mappings":"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","names":[]}

package/dist/core/index.d.ts

@@ -1,5 +1,5 @@
-import { b as FragmentDefinition, c as FigmaStringMapping, e as FigmaBooleanMapping, f as FigmaEnumMapping, g as FigmaInstanceMapping, h as FigmaChildrenMapping, i as FigmaTextContentMapping, R as RelationshipType, V as VariantLoader, j as VariantRenderOptions } from '../defineFragment-D0UTve-I.js';
-export { A as AIMetadata, I as BaselineInfo, B as BlockDefinition, H as BoundingBox, u as CompiledRecipe, o as ComponentRelation, C as ControlType, D as DiffResult, L as FigmaPropMapping, k as FragmentComponent, v as FragmentContract, w as FragmentGenerated, l as FragmentMeta, m as FragmentUsage, r as FragmentVariant, F as FragmentsConfig, X as InferProps, M as Manifest, p as PlayFunction, q as PlayFunctionContext, n as PropDefinition, P as PropType, t as RecipeDefinition, s as RegistryOptions, E as Screenshot, x as ScreenshotConfig, G as ScreenshotMetadata, y as ServiceConfig, S as SnippetPolicyConfig, T as Theme, N as TokenConfig, J as VerifyRequest, K as VerifyResult, z as Viewport, Q as compileBlock, O as compileFragment, W as compileRecipe, a as defineBlock, d as defineFragment, U as defineRecipe } from '../defineFragment-D0UTve-I.js';
+import { b as FragmentDefinition, S as StorybookFilterConfig, c as FigmaStringMapping, e as FigmaBooleanMapping, f as FigmaEnumMapping, g as FigmaInstanceMapping, h as FigmaChildrenMapping, i as FigmaTextContentMapping, R as RelationshipType, V as VariantLoader, j as VariantRenderOptions } from '../defineFragment-CBMS7Bab.js';
+export { A as AIMetadata, J as BaselineInfo, B as BlockDefinition, I as BoundingBox, v as CompiledRecipe, o as ComponentRelation, C as ControlType, D as DiffResult, N as FigmaPropMapping, k as FragmentComponent, w as FragmentContract, x as FragmentGenerated, l as FragmentMeta, m as FragmentUsage, r as FragmentVariant, F as FragmentsConfig, Y as InferProps, M as Manifest, p as PlayFunction, q as PlayFunctionContext, n as PropDefinition, P as PropType, u as RecipeDefinition, t as RegistryOptions, G as Screenshot, y as ScreenshotConfig, H as ScreenshotMetadata, z as ServiceConfig, s as SnippetPolicyConfig, T as Theme, O as TokenConfig, K as VerifyRequest, L as VerifyResult, E as Viewport, U as compileBlock, Q as compileFragment, X as compileRecipe, a as defineBlock, d as defineFragment, W as defineRecipe } from '../defineFragment-CBMS7Bab.js';
 import { z } from 'zod';
 import { ComponentType, ReactNode } from 'react';
 export { ContextOptions, ContextResult, generateContext } from '@fragments-sdk/context/generate';
@@ -1719,10 +1719,40 @@ declare const fragmentsConfigSchema: z.ZodObject<{
             bundleSize?: number | undefined;
         } | undefined;
     }>]>>;
+    storybook: z.ZodOptional<z.ZodObject<{
+        exclude: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        include: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        excludeDeprecated: z.ZodOptional<z.ZodBoolean>;
+        excludeTests: z.ZodOptional<z.ZodBoolean>;
+        excludeSvgIcons: z.ZodOptional<z.ZodBoolean>;
+        excludeSubComponents: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        include?: string[] | undefined;
+        exclude?: string[] | undefined;
+        excludeDeprecated?: boolean | undefined;
+        excludeTests?: boolean | undefined;
+        excludeSvgIcons?: boolean | undefined;
+        excludeSubComponents?: boolean | undefined;
+    }, {
+        include?: string[] | undefined;
+        exclude?: string[] | undefined;
+        excludeDeprecated?: boolean | undefined;
+        excludeTests?: boolean | undefined;
+        excludeSvgIcons?: boolean | undefined;
+        excludeSubComponents?: boolean | undefined;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     include: string[];
     components?: string[] | undefined;
     screenshots?: z.objectOutputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
+    storybook?: {
+        include?: string[] | undefined;
+        exclude?: string[] | undefined;
+        excludeDeprecated?: boolean | undefined;
+        excludeTests?: boolean | undefined;
+        excludeSvgIcons?: boolean | undefined;
+        excludeSubComponents?: boolean | undefined;
+    } | undefined;
     tokens?: z.objectOutputType<{
         include: z.ZodArray<z.ZodString, "many">;
     }, z.ZodTypeAny, "passthrough"> | undefined;
@@ -1749,6 +1779,14 @@ declare const fragmentsConfigSchema: z.ZodObject<{
     include: string[];
     components?: string[] | undefined;
     screenshots?: z.objectInputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
+    storybook?: {
+        include?: string[] | undefined;
+        exclude?: string[] | undefined;
+        excludeDeprecated?: boolean | undefined;
+        excludeTests?: boolean | undefined;
+        excludeSvgIcons?: boolean | undefined;
+        excludeSubComponents?: boolean | undefined;
+    } | undefined;
     tokens?: z.objectInputType<{
         include: z.ZodArray<z.ZodString, "many">;
     }, z.ZodTypeAny, "passthrough"> | undefined;
@@ -1798,6 +1836,70 @@ declare const recipeDefinitionSchema: z.ZodObject<{
     tags?: string[] | undefined;
 }>;
 
+/**
+ * Smart filtering for Storybook adapter.
+ *
+ * Two layers:
+ * 1. Per-file heuristics — checkStoryExclusion() checks title, tags, component name, etc.
+ * 2. Cross-file sub-component detection — detectSubComponentPaths() uses directory structure.
+ *
+ * All functions are pure (no I/O, no side effects) for easy testing.
+ */
+
+type ExclusionReason = 'deprecated' | 'test-story' | 'svg-icon' | 'tag-excluded' | 'empty-variants' | 'sub-component' | 'config-excluded';
+interface ExclusionResult {
+    excluded: boolean;
+    reason?: ExclusionReason;
+    detail?: string;
+}
+interface CheckStoryExclusionOpts {
+    storybookTitle?: string;
+    componentName: string;
+    componentDisplayName?: string;
+    componentFunctionName?: string;
+    tags?: string[];
+    variantCount: number;
+    filePath: string;
+    config: StorybookFilterConfig;
+}
+/**
+ * Per-file exclusion check. Returns `{ excluded: true, reason, detail }` when
+ * the fragment should be filtered out, or `{ excluded: false }` when it should
+ * be kept.
+ *
+ * Config `include` trumps everything — if a name matches `include`, it is
+ * never excluded by heuristics.
+ */
+declare function checkStoryExclusion(opts: CheckStoryExclusionOpts): ExclusionResult;
+/**
+ * Given all story file relative paths, detect which ones are sub-components
+ * based on directory structure.
+ *
+ * Heuristic: within a directory, if one story file's base name matches the
+ * directory name, it is the "primary" component. All other story files in
+ * the same directory are considered sub-components.
+ *
+ * Example:
+ *   src/components/Form/Form.stories.tsx        → primary ("Form")
+ *   src/components/Form/Checkbox.stories.tsx     → sub-component of "Form"
+ *   src/components/Form/RadioGroup.stories.tsx   → sub-component of "Form"
+ *
+ * Returns a Map from relative path → parent component name.
+ * Paths NOT in the map are standalone components.
+ */
+declare function detectSubComponentPaths(storyFiles: Array<{
+    relativePath: string;
+}>): Map<string, string>;
+/**
+ * Check if a component name matches the `storybook.include` patterns.
+ * Include is a force-include that bypasses all heuristic filters.
+ */
+declare function isForceIncluded(name: string, config: StorybookFilterConfig): boolean;
+/**
+ * Check if a component name matches the `storybook.exclude` patterns.
+ */
+declare function isConfigExcluded(name: string, config: StorybookFilterConfig): boolean;
+
 /**
  * Figma property mapping DSL
  *
@@ -2089,4 +2191,4 @@ interface PreviewVariantRuntimeProps extends PreviewRuntimeOptions {
  */
 declare function PreviewVariantRuntime({ variant, loadedData, children, }: PreviewVariantRuntimeProps): react_jsx_runtime.JSX.Element;
 
-export { BRAND, type Brand, type CSF2Story, type ComplexityTier, type CompositionAnalysis, type CompositionGuideline, type CompositionSuggestion, type CompositionWarning, DEFAULTS, type Decorator, type Defaults, type DesignToken, type EnhancedStyleDiffItem, FigmaBooleanMapping, FigmaChildrenMapping, FigmaEnumMapping, FigmaInstanceMapping, FigmaStringMapping, FigmaTextContentMapping, type Fragment, type FragmentAccessibility, type FragmentContextOptions, FragmentDefinition, type FragmentDoNotItem, type FragmentFigma, type FragmentIndex, type FragmentMeta as FragmentJsonMeta, type FragmentUsage as FragmentJsonUsage, type FragmentPattern, type FragmentRegistry, type FragmentRelated, type Loader, PRESET_NAMES, type ParsedToken, type PerformanceData as PerfData, type PerformanceSummary as PerfSummary, type PerformanceBudgets, type PerformanceConfig, type PreviewConfig, type PreviewRuntimeOptions, type PreviewRuntimeState, type PreviewVariantLike, PreviewVariantRuntime, type RegistryComponentEntry, type RegistryPropEntry, RelationshipType, type Story, type StoryArgType, type StoryContext, type StoryMeta, type StoryModule, type TokenCategory, type TokenFix, type TokenMatchRequest, type TokenMatchResult, type TokenParseError, type TokenParseOutput, type TokenParseResult, type TokenRegistry, type TokenRegistryMeta, type TokenUsageSummary, VariantLoader, aiMetadataSchema, analyzeComposition, blockDefinitionSchema, budgetBar, classifyComplexity, componentRelationSchema, executeVariantLoaders, figma, figmaPropMappingSchema, formatBytes, fragmentBanSchema, fragmentContractSchema, fragmentDefinitionSchema, fragmentGeneratedSchema, fragmentMetaSchema, fragmentUsageSchema, fragmentVariantSchema, fragmentsConfigSchema, getPreviewConfig, isExportStory, isFigmaPropMapping, parseTokenFile, propDefinitionSchema, recipeDefinitionSchema, resolveFigmaMapping, resolvePerformanceConfig, resolvePreviewRuntimeState, setPreviewConfig, storyModuleToFragment, storyNameFromExport, toId, usePreviewVariantRuntime };
+export { BRAND, type Brand, type CSF2Story, type CheckStoryExclusionOpts, type ComplexityTier, type CompositionAnalysis, type CompositionGuideline, type CompositionSuggestion, type CompositionWarning, DEFAULTS, type Decorator, type Defaults, type DesignToken, type EnhancedStyleDiffItem, type ExclusionReason, type ExclusionResult, FigmaBooleanMapping, FigmaChildrenMapping, FigmaEnumMapping, FigmaInstanceMapping, FigmaStringMapping, FigmaTextContentMapping, type Fragment, type FragmentAccessibility, type FragmentContextOptions, FragmentDefinition, type FragmentDoNotItem, type FragmentFigma, type FragmentIndex, type FragmentMeta as FragmentJsonMeta, type FragmentUsage as FragmentJsonUsage, type FragmentPattern, type FragmentRegistry, type FragmentRelated, type Loader, PRESET_NAMES, type ParsedToken, type PerformanceData as PerfData, type PerformanceSummary as PerfSummary, type PerformanceBudgets, type PerformanceConfig, type PreviewConfig, type PreviewRuntimeOptions, type PreviewRuntimeState, type PreviewVariantLike, PreviewVariantRuntime, type RegistryComponentEntry, type RegistryPropEntry, RelationshipType, type Story, type StoryArgType, type StoryContext, type StoryMeta, type StoryModule, StorybookFilterConfig, type TokenCategory, type TokenFix, type TokenMatchRequest, type TokenMatchResult, type TokenParseError, type TokenParseOutput, type TokenParseResult, type TokenRegistry, type TokenRegistryMeta, type TokenUsageSummary, VariantLoader, aiMetadataSchema, analyzeComposition, blockDefinitionSchema, budgetBar, checkStoryExclusion, classifyComplexity, componentRelationSchema, detectSubComponentPaths, executeVariantLoaders, figma, figmaPropMappingSchema, formatBytes, fragmentBanSchema, fragmentContractSchema, fragmentDefinitionSchema, fragmentGeneratedSchema, fragmentMetaSchema, fragmentUsageSchema, fragmentVariantSchema, fragmentsConfigSchema, getPreviewConfig, isConfigExcluded, isExportStory, isFigmaPropMapping, isForceIncluded, parseTokenFile, propDefinitionSchema, recipeDefinitionSchema, resolveFigmaMapping, resolvePerformanceConfig, resolvePreviewRuntimeState, setPreviewConfig, storyModuleToFragment, storyNameFromExport, toId, usePreviewVariantRuntime };

package/dist/core/index.js

@@ -27,7 +27,7 @@ import {
   storyNameFromExport,
   toId,
   usePreviewVariantRuntime
-} from "../chunk-NGIMCIK2.js";
+} from "../chunk-GF6OVPIN.js";
 import {
   aiMetadataSchema,
   blockDefinitionSchema,
@@ -43,7 +43,13 @@ import {
   fragmentsConfigSchema,
   propDefinitionSchema,
   recipeDefinitionSchema
-} from "../chunk-GOVI6COW.js";
+} from "../chunk-NVSPGSKB.js";
+import {
+  checkStoryExclusion,
+  detectSubComponentPaths,
+  isConfigExcluded,
+  isForceIncluded
+} from "../chunk-EZYXYWNF.js";
 import {
   BRAND,
   DEFAULTS
@@ -58,6 +64,7 @@ export {
   analyzeComposition,
   blockDefinitionSchema,
   budgetBar,
+  checkStoryExclusion,
   classifyComplexity,
   compileBlock,
   compileFragment,
@@ -66,6 +73,7 @@ export {
   defineBlock,
   defineFragment,
   defineRecipe,
+  detectSubComponentPaths,
   executeVariantLoaders,
   figma,
   figmaPropMappingSchema,
@@ -80,8 +88,10 @@ export {
   fragmentsConfigSchema,
   generateContext,
   getPreviewConfig,
+  isConfigExcluded,
   isExportStory,
   isFigmaPropMapping,
+  isForceIncluded,
   parseTokenFile,
   propDefinitionSchema,
   recipeDefinitionSchema,

package/dist/{defineFragment-D0UTve-I.d.ts → defineFragment-CBMS7Bab.d.ts}

@@ -359,6 +359,24 @@ interface SnippetPolicyConfig {
     /** Allow these external modules for JSX components in snippets/renders. */
     allowedExternalModules?: string[];
 }
+/**
+ * Storybook adapter filtering configuration.
+ * Controls which Storybook stories are included when generating fragments.
+ */
+interface StorybookFilterConfig {
+    /** Glob-style patterns for component names to explicitly exclude */
+    exclude?: string[];
+    /** Glob-style patterns for component names to force-include (bypasses all heuristic filters) */
+    include?: string[];
+    /** Exclude stories with "Deprecated" in the title (default: true) */
+    excludeDeprecated?: boolean;
+    /** Exclude test stories (title ending /test(s) or *.test.stories.* files) (default: true) */
+    excludeTests?: boolean;
+    /** Exclude SVG icon components (names matching Svg[A-Z]*) (default: true) */
+    excludeSvgIcons?: boolean;
+    /** Exclude sub-components detected by directory structure (default: true) */
+    excludeSubComponents?: boolean;
+}
 /**
  * Config file structure
  */
@@ -396,6 +414,8 @@ interface FragmentsConfig {
             bundleSize?: number;
         };
     };
+    /** Storybook adapter filtering configuration */
+    storybook?: StorybookFilterConfig;
 }
 /**
  * Screenshot capture configuration
@@ -662,4 +682,4 @@ declare const compileRecipe: typeof compileBlock;
  */
 type InferProps<T> = T extends FragmentComponent<infer P> ? P : never;
 
-export { type AIMetadata as A, type BlockDefinition as B, type ControlType as C, type DiffResult as D, type Screenshot as E, type FragmentsConfig as F, type ScreenshotMetadata as G, type BoundingBox as H, type BaselineInfo as I, type VerifyRequest as J, type VerifyResult as K, type FigmaPropMapping as L, type Manifest as M, type TokenConfig as N, compileFragment as O, type PropType as P, compileBlock as Q, type RelationshipType as R, type SnippetPolicyConfig as S, type Theme as T, defineRecipe as U, type VariantLoader as V, compileRecipe as W, type InferProps as X, defineBlock as a, type FragmentDefinition as b, type FigmaStringMapping as c, defineFragment as d, type FigmaBooleanMapping as e, type FigmaEnumMapping as f, type FigmaInstanceMapping as g, type FigmaChildrenMapping as h, type FigmaTextContentMapping as i, type VariantRenderOptions as j, type FragmentComponent as k, type FragmentMeta as l, type FragmentUsage as m, type PropDefinition as n, type ComponentRelation as o, type PlayFunction as p, type PlayFunctionContext as q, type FragmentVariant as r, type RegistryOptions as s, type RecipeDefinition as t, type CompiledRecipe as u, type FragmentContract as v, type FragmentGenerated as w, type ScreenshotConfig as x, type ServiceConfig as y, type Viewport as z };
+export { type AIMetadata as A, type BlockDefinition as B, type ControlType as C, type DiffResult as D, type Viewport as E, type FragmentsConfig as F, type Screenshot as G, type ScreenshotMetadata as H, type BoundingBox as I, type BaselineInfo as J, type VerifyRequest as K, type VerifyResult as L, type Manifest as M, type FigmaPropMapping as N, type TokenConfig as O, type PropType as P, compileFragment as Q, type RelationshipType as R, type StorybookFilterConfig as S, type Theme as T, compileBlock as U, type VariantLoader as V, defineRecipe as W, compileRecipe as X, type InferProps as Y, defineBlock as a, type FragmentDefinition as b, type FigmaStringMapping as c, defineFragment as d, type FigmaBooleanMapping as e, type FigmaEnumMapping as f, type FigmaInstanceMapping as g, type FigmaChildrenMapping as h, type FigmaTextContentMapping as i, type VariantRenderOptions as j, type FragmentComponent as k, type FragmentMeta as l, type FragmentUsage as m, type PropDefinition as n, type ComponentRelation as o, type PlayFunction as p, type PlayFunctionContext as q, type FragmentVariant as r, type SnippetPolicyConfig as s, type RegistryOptions as t, type RecipeDefinition as u, type CompiledRecipe as v, type FragmentContract as w, type FragmentGenerated as x, type ScreenshotConfig as y, type ServiceConfig as z };