@buoy-design/scanners 0.2.1 → 0.2.26

package/dist/signals/types.d.ts

@@ -2,7 +2,7 @@ import { z } from 'zod';
 /**
  * Signal types representing atomic facts extracted from code
  */
-export declare const SignalTypeSchema: z.ZodEnum<["color-value", "spacing-value", "font-size", "font-family", "font-weight", "radius-value", "shadow-value", "breakpoint", "token-definition", "token-usage", "component-def", "component-usage", "prop-pattern", "class-pattern"]>;
+export declare const SignalTypeSchema: z.ZodEnum<["color-value", "spacing-value", "font-size", "font-family", "font-weight", "radius-value", "shadow-value", "breakpoint", "z-index", "sizing-value", "inline-style", "arbitrary-value", "token-definition", "token-usage", "component-def", "component-usage", "prop-pattern", "class-pattern"]>;
 export type SignalType = z.infer<typeof SignalTypeSchema>;
 /**
  * Source location for a signal
@@ -64,7 +64,7 @@ export type SignalContext = z.infer<typeof SignalContextSchema>;
  */
 export declare const RawSignalSchema: z.ZodObject<{
     id: z.ZodString;
-    type: z.ZodEnum<["color-value", "spacing-value", "font-size", "font-family", "font-weight", "radius-value", "shadow-value", "breakpoint", "token-definition", "token-usage", "component-def", "component-usage", "prop-pattern", "class-pattern"]>;
+    type: z.ZodEnum<["color-value", "spacing-value", "font-size", "font-family", "font-weight", "radius-value", "shadow-value", "breakpoint", "z-index", "sizing-value", "inline-style", "arbitrary-value", "token-definition", "token-usage", "component-def", "component-usage", "prop-pattern", "class-pattern"]>;
     value: z.ZodUnknown;
     location: z.ZodObject<{
         path: z.ZodString;
@@ -100,7 +100,7 @@ export declare const RawSignalSchema: z.ZodObject<{
     }>;
     metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
 }, "strip", z.ZodTypeAny, {
-    type: "color-value" | "spacing-value" | "font-size" | "font-family" | "font-weight" | "radius-value" | "shadow-value" | "breakpoint" | "token-definition" | "token-usage" | "component-def" | "component-usage" | "prop-pattern" | "class-pattern";
+    type: "color-value" | "spacing-value" | "font-size" | "font-family" | "font-weight" | "radius-value" | "shadow-value" | "breakpoint" | "z-index" | "sizing-value" | "inline-style" | "arbitrary-value" | "token-definition" | "token-usage" | "component-def" | "component-usage" | "prop-pattern" | "class-pattern";
     id: string;
     location: {
         path: string;
@@ -117,7 +117,7 @@ export declare const RawSignalSchema: z.ZodObject<{
     metadata: Record<string, unknown>;
     value?: unknown;
 }, {
-    type: "color-value" | "spacing-value" | "font-size" | "font-family" | "font-weight" | "radius-value" | "shadow-value" | "breakpoint" | "token-definition" | "token-usage" | "component-def" | "component-usage" | "prop-pattern" | "class-pattern";
+    type: "color-value" | "spacing-value" | "font-size" | "font-family" | "font-weight" | "radius-value" | "shadow-value" | "breakpoint" | "z-index" | "sizing-value" | "inline-style" | "arbitrary-value" | "token-definition" | "token-usage" | "component-def" | "component-usage" | "prop-pattern" | "class-pattern";
     id: string;
     location: {
         path: string;

package/dist/signals/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/signals/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,gBAAgB,8OAmB3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;EAK/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;GAEG;AACH,eAAO,MAAM,cAAc,qHAczB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,eAAe,+FAQf,CAAC;AAEd,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,WAAW,8CAItB,CAAC;AAEH,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEhD;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;EAK9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAO1B,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD;;GAEG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,GACb,MAAM,CAKR"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/signals/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,gBAAgB,4SAuB3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;EAK/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;GAEG;AACH,eAAO,MAAM,cAAc,qHAczB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,eAAe,+FAQf,CAAC;AAEd,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,WAAW,8CAItB,CAAC;AAEH,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEhD;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;EAK9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAO1B,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD;;GAEG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,GACb,MAAM,CAKR"}

package/dist/signals/types.js

@@ -12,6 +12,10 @@ export const SignalTypeSchema = z.enum([
     'radius-value',
     'shadow-value',
     'breakpoint',
+    'z-index',
+    'sizing-value',
+    'inline-style',
+    'arbitrary-value',
     // Token signals
     'token-definition',
     'token-usage',

package/dist/signals/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/signals/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,IAAI,CAAC;IACrC,sBAAsB;IACtB,aAAa;IACb,eAAe;IACf,WAAW;IACX,aAAa;IACb,aAAa;IACb,cAAc;IACd,cAAc;IACd,YAAY;IACZ,gBAAgB;IAChB,kBAAkB;IAClB,aAAa;IACb,oBAAoB;IACpB,eAAe;IACf,iBAAiB;IACjB,kBAAkB;IAClB,cAAc;IACd,eAAe;CAChB,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC;IACnC,KAAK;IACL,KAAK;IACL,IAAI;IACJ,IAAI;IACJ,KAAK;IACL,QAAQ;IACR,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;IACN,QAAQ;IACR,MAAM;IACN,UAAU;CACX,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,IAAI,CAAC;IACpC,OAAO;IACP,KAAK;IACL,QAAQ;IACR,SAAS;IACT,UAAU;IACV,SAAS;IACT,KAAK;CACN,CAAC,CAAC,QAAQ,EAAE,CAAC;AAId;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,IAAI,CAAC;IAChC,QAAQ;IACR,WAAW;IACX,QAAQ;CACT,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,QAAQ,EAAE,cAAc;IACxB,SAAS,EAAE,eAAe;IAC1B,KAAK,EAAE,WAAW;IAClB,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE;CACzB,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,gBAAgB;IACtB,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE;IAClB,QAAQ,EAAE,oBAAoB;IAC9B,OAAO,EAAE,mBAAmB;IAC5B,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;CAChC,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAgB,EAChB,IAAY,EACZ,IAAY,EACZ,KAAc;IAEd,MAAM,SAAS,GAAG,OAAO,KAAK,KAAK,QAAQ;QACzC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;QACpB,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC/B,OAAO,GAAG,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,SAAS,EAAE,CAAC;AAChD,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/signals/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,IAAI,CAAC;IACrC,sBAAsB;IACtB,aAAa;IACb,eAAe;IACf,WAAW;IACX,aAAa;IACb,aAAa;IACb,cAAc;IACd,cAAc;IACd,YAAY;IACZ,SAAS;IACT,cAAc;IACd,cAAc;IACd,iBAAiB;IACjB,gBAAgB;IAChB,kBAAkB;IAClB,aAAa;IACb,oBAAoB;IACpB,eAAe;IACf,iBAAiB;IACjB,kBAAkB;IAClB,cAAc;IACd,eAAe;CAChB,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC;IACnC,KAAK;IACL,KAAK;IACL,IAAI;IACJ,IAAI;IACJ,KAAK;IACL,QAAQ;IACR,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;IACN,QAAQ;IACR,MAAM;IACN,UAAU;CACX,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,IAAI,CAAC;IACpC,OAAO;IACP,KAAK;IACL,QAAQ;IACR,SAAS;IACT,UAAU;IACV,SAAS;IACT,KAAK;CACN,CAAC,CAAC,QAAQ,EAAE,CAAC;AAId;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,IAAI,CAAC;IAChC,QAAQ;IACR,WAAW;IACX,QAAQ;CACT,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,QAAQ,EAAE,cAAc;IACxB,SAAS,EAAE,eAAe;IAC1B,KAAK,EAAE,WAAW;IAClB,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE;CACzB,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,gBAAgB;IACtB,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE;IAClB,QAAQ,EAAE,oBAAoB;IAC9B,OAAO,EAAE,mBAAmB;IAC5B,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;CAChC,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAgB,EAChB,IAAY,EACZ,IAAY,EACZ,KAAc;IAEd,MAAM,SAAS,GAAG,OAAO,KAAK,KAAK,QAAQ;QACzC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;QACpB,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC/B,OAAO,GAAG,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,SAAS,EAAE,CAAC;AAChD,CAAC"}

package/dist/storybook/extractor.d.ts

@@ -13,22 +13,103 @@ export interface StoryFileScannerConfig extends ScannerConfig {
     include?: string[];
     /** Patterns to exclude */
     exclude?: string[];
+    /** Whether to scan MDX files (default: true) */
+    scanMdx?: boolean;
+    /** Whether to validate story args against prop types (default: false) */
+    validateArgs?: boolean;
+}
+/**
+ * MDX story information
+ */
+export interface MdxStoryInfo {
+    /** File path */
+    file: string;
+    /** Title extracted from Meta */
+    title?: string;
+    /** Component referenced in Meta */
+    component?: string;
+    /** Story names found in the MDX */
+    stories: string[];
+    /** Whether it uses Canvas blocks */
+    hasCanvas: boolean;
+    /** Whether it uses Story blocks */
+    hasStoryBlocks: boolean;
+    /** Whether it has prose documentation */
+    hasDocumentation: boolean;
+}
+/**
+ * Args validation issue found in a story
+ */
+export interface ArgsValidationIssue {
+    /** Story name where the issue was found */
+    storyName: string;
+    /** Property name with the issue */
+    propName: string;
+    /** Type of validation issue */
+    issueType: 'type-mismatch' | 'missing-required' | 'unknown-prop' | 'invalid-option';
+    /** Description of the issue */
+    message: string;
+    /** Expected type (for type mismatches) */
+    expectedType?: string;
+    /** Actual type found */
+    actualType?: string;
+    /** Value that caused the issue */
+    actualValue?: unknown;
+}
+/**
+ * Validation result for a story file
+ */
+export interface StoryArgsValidation {
+    /** File path of the story */
+    file: string;
+    /** Component name */
+    componentName: string;
+    /** Issues found */
+    issues: ArgsValidationIssue[];
+    /** Total args validated */
+    argsValidated: number;
+    /** Whether all args are valid */
+    isValid: boolean;
 }
 /**
  * Scans .stories.{ts,tsx,js,jsx} files to extract component metadata.
  * This scanner parses Component Story Format (CSF) files directly from source code.
  */
+/**
+ * Extended scan result with MDX info
+ */
+export interface StoryFileScanResult extends ScanResult<Component> {
+    /** MDX story files found */
+    mdxStories: MdxStoryInfo[];
+    /** Components with stories */
+    documentedComponents: string[];
+    /** Total story count */
+    storyCount: number;
+    /** Args validation results (when validateArgs is enabled) */
+    argsValidation?: StoryArgsValidation[];
+}
 export declare class StoryFileScanner extends Scanner<Component, StoryFileScannerConfig> {
     /** Default file patterns for story files */
     private static readonly DEFAULT_PATTERNS;
+    /** MDX file patterns */
+    private static readonly MDX_PATTERNS;
     constructor(config: StoryFileScannerConfig);
-    scan(): Promise<ScanResult<Component>>;
+    private parsedMetas;
+    scan(): Promise<StoryFileScanResult>;
     getSourceType(): string;
     /**
      * Get story patterns from .storybook/main.ts config file
      */
     getStoryPatternsFromConfig(): Promise<string[]>;
     private extractStoriesPatterns;
+    /**
+     * Scan MDX story files
+     */
+    private scanMdxFiles;
+    /**
+     * Parse an MDX file for story information
+     */
+    private parseMdxFile;
     private parseStoryFile;
     private extractMeta;
     /**
@@ -85,6 +166,30 @@ export declare class StoryFileScanner extends Scanner<Component, StoryFileScanne
     private extractComponentName;
     private getComponentNameFromTitle;
     private createStoryId;
+    /**
+     * Validate all story args against their argTypes
+     */
+    private validateAllStoryArgs;
+    /**
+     * Validate args for a single story file
+     */
+    private validateStoryArgs;
+    /**
+     * Get the expected type string from an argType
+     */
+    private getExpectedType;
+    /**
+     * Map Storybook control types to basic types
+     */
+    private controlToType;
+    /**
+     * Get the actual type of a value
+     */
+    private getActualType;
+    /**
+     * Check if a value is compatible with an expected type
+     */
+    private isTypeCompatible;
 }
 /**
  * Scans Storybook static builds (index.json/stories.json) or running servers.

package/dist/storybook/extractor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extractor.d.ts","sourceRoot":"","sources":["../../src/storybook/extractor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,aAAa,EAAwB,MAAM,oBAAoB,CAAC;AAC9F,OAAO,KAAK,EAAE,SAAS,EAAmC,MAAM,mBAAmB,CAAC;AAOpF,MAAM,WAAW,sBAAuB,SAAQ,aAAa;IAC3D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAiBD,MAAM,WAAW,sBAAuB,SAAQ,aAAa;IAC3D,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,0BAA0B;IAC1B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAwCD;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,OAAO,CAAC,SAAS,EAAE,sBAAsB,CAAC;IAC9E,4CAA4C;IAC5C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAKtC;gBAEU,MAAM,EAAE,sBAAsB;IAQpC,IAAI,IAAI,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IAO5C,aAAa,IAAI,MAAM;IAIvB;;OAEG;IACG,0BAA0B,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAqBrD,OAAO,CAAC,sBAAsB;YA+BhB,cAAc;IA+H5B,OAAO,CAAC,WAAW;IA2CnB;;;;;OAKG;IACH,OAAO,CAAC,UAAU;IAwClB;;OAEG;IACH,OAAO,CAAC,eAAe;IAiBvB;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAuCjC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA8E9B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IA+ChC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA4D5B;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAmB1B,OAAO,CAAC,eAAe;IA8FvB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA0B9B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAsC/B,OAAO,CAAC,aAAa;IA8CrB,OAAO,CAAC,oBAAoB;IAuG5B,OAAO,CAAC,iBAAiB;IAsEzB,OAAO,CAAC,eAAe;IAmBvB,OAAO,CAAC,eAAe;IAoBvB,OAAO,CAAC,wBAAwB;IA0BhC;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IA4B5B,OAAO,CAAC,yBAAyB;IAKjC,OAAO,CAAC,aAAa;CAKtB;AAED;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,OAAO,CAAC,SAAS,EAAE,sBAAsB,CAAC;IACxE,IAAI,IAAI,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IA0B5C,aAAa,IAAI,MAAM;IAIvB,OAAO,CAAC,eAAe;YAiBT,iBAAiB;IA8C/B,OAAO,CAAC,mBAAmB;IAiB3B,OAAO,CAAC,iBAAiB;IAsDzB,OAAO,CAAC,eAAe;CAIxB"}
+{"version":3,"file":"extractor.d.ts","sourceRoot":"","sources":["../../src/storybook/extractor.ts"],"names":[],"mappings":"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"}

package/dist/storybook/extractor.js

@@ -12,10 +12,6 @@ const STORY_SCANNER_EXCLUDES = [
     '**/.next/**',
     '**/coverage/**',
 ];
-/**
- * Scans .stories.{ts,tsx,js,jsx} files to extract component metadata.
- * This scanner parses Component Story Format (CSF) files directly from source code.
- */
 export class StoryFileScanner extends Scanner {
     /** Default file patterns for story files */
     static DEFAULT_PATTERNS = [
@@ -24,15 +20,46 @@ export class StoryFileScanner extends Scanner {
         '**/*.stories.jsx',
         '**/*.stories.js',
     ];
+    /** MDX file patterns */
+    static MDX_PATTERNS = [
+        '**/*.stories.mdx',
+        '**/*.mdx',
+    ];
     constructor(config) {
         // Override exclude patterns to not exclude story files
         super({
             ...config,
+            scanMdx: config.scanMdx !== false,
             exclude: config.exclude ?? STORY_SCANNER_EXCLUDES,
         });
     }
+    // Store parsed meta for validation
+    parsedMetas = new Map();
     async scan() {
-        return this.runScan((file) => this.parseStoryFile(file), StoryFileScanner.DEFAULT_PATTERNS);
+        // Clear the metas map for each scan
+        this.parsedMetas.clear();
+        const baseResult = await this.runScan((file) => this.parseStoryFile(file), StoryFileScanner.DEFAULT_PATTERNS);
+        // Scan MDX files if enabled
+        let mdxStories = [];
+        if (this.config.scanMdx !== false) {
+            mdxStories = await this.scanMdxFiles();
+        }
+        // Calculate documented components
+        const documentedComponents = baseResult.items.map(c => c.name);
+        // Calculate total story count
+        const storyCount = baseResult.items.reduce((sum, c) => sum + c.variants.length, 0) + mdxStories.reduce((sum, m) => sum + m.stories.length, 0);
+        // Validate args if enabled
+        let argsValidation;
+        if (this.config.validateArgs) {
+            argsValidation = this.validateAllStoryArgs();
+        }
+        return {
+            ...baseResult,
+            mdxStories,
+            documentedComponents,
+            storyCount,
+            argsValidation,
+        };
     }
     getSourceType() {
         return 'storybook';
@@ -80,6 +107,102 @@ export class StoryFileScanner extends Scanner {
         ts.forEachChild(sourceFile, visit);
         return patterns;
     }
+    /**
+     * Scan MDX story files
+     */
+    async scanMdxFiles() {
+        const mdxStories = [];
+        const { glob } = await import('glob');
+        for (const pattern of StoryFileScanner.MDX_PATTERNS) {
+            try {
+                const files = await glob(pattern, {
+                    cwd: this.config.projectRoot,
+                    ignore: this.config.exclude || STORY_SCANNER_EXCLUDES,
+                    absolute: true,
+                });
+                for (const file of files) {
+                    try {
+                        const content = await readFile(file, 'utf-8');
+                        const relativePath = relative(this.config.projectRoot, file);
+                        const mdxInfo = this.parseMdxFile(content, relativePath);
+                        if (mdxInfo) {
+                            mdxStories.push(mdxInfo);
+                        }
+                    }
+                    catch {
+                        // Continue on read errors
+                    }
+                }
+            }
+            catch {
+                // Continue to next pattern
+            }
+        }
+        return mdxStories;
+    }
+    /**
+     * Parse an MDX file for story information
+     */
+    parseMdxFile(content, filePath) {
+        const info = {
+            file: filePath,
+            stories: [],
+            hasCanvas: false,
+            hasStoryBlocks: false,
+            hasDocumentation: false,
+        };
+        // Check for Meta component (required for story MDX)
+        const metaMatch = content.match(/<Meta\s+([^>]+)>/);
+        if (metaMatch) {
+            const metaProps = metaMatch[1];
+            // Extract title
+            const titleMatch = metaProps.match(/title\s*=\s*["']([^"']+)["']/);
+            if (titleMatch) {
+                info.title = titleMatch[1];
+            }
+            // Extract component (either as string or JSX reference)
+            const componentMatch = metaProps.match(/component\s*=\s*\{?([A-Za-z]+)\}?/);
+            if (componentMatch) {
+                info.component = componentMatch[1];
+            }
+        }
+        // Check for Canvas blocks
+        if (/<Canvas\s*[^>]*>/.test(content)) {
+            info.hasCanvas = true;
+        }
+        // Check for Story blocks and extract names
+        const storyRegex = /<Story\s+(?:[^>]*?)name\s*=\s*["']([^"']+)["'](?:[^>]*?)>/g;
+        let storyMatch;
+        while ((storyMatch = storyRegex.exec(content)) !== null) {
+            info.stories.push(storyMatch[1]);
+            info.hasStoryBlocks = true;
+        }
+        // Also check for export const story pattern in MDX2
+        const exportStoryRegex = /export\s+const\s+([A-Z][a-zA-Z0-9]*)\s*=/g;
+        while ((storyMatch = exportStoryRegex.exec(content)) !== null) {
+            const storyName = storyMatch[1];
+            if (!info.stories.includes(storyName)) {
+                info.stories.push(storyName);
+            }
+        }
+        // Check for prose documentation (markdown content outside of code blocks)
+        // Simple heuristic: if there's text content that's not in JSX or code blocks
+        const proseContent = content
+            .replace(/<[^>]+>/g, '') // Remove JSX tags
+            .replace(/```[\s\S]*?```/g, '') // Remove code blocks
+            .replace(/`[^`]+`/g, '') // Remove inline code
+            .replace(/import\s+.+;?/g, '') // Remove imports
+            .replace(/export\s+.+;?/g, '') // Remove exports
+            .trim();
+        if (proseContent.length > 50) {
+            info.hasDocumentation = true;
+        }
+        // Only return if this looks like a story MDX (has Meta, Canvas, or Story blocks)
+        if (info.title || info.component || info.hasCanvas || info.hasStoryBlocks || info.stories.length > 0) {
+            return info;
+        }
+        return null;
+    }
     async parseStoryFile(filePath) {
         const content = await readFile(filePath, 'utf-8');
         const isTypeScript = filePath.endsWith('.tsx') || filePath.endsWith('.ts');
@@ -185,6 +308,13 @@ export class StoryFileScanner extends Scanner {
             },
             scannedAt: new Date(),
         };
+        // Store meta for validation
+        this.parsedMetas.set(relativePath, {
+            meta,
+            variants,
+            file: relativePath,
+            componentName,
+        });
         return [component];
     }
     extractMeta(sourceFile, relativePath) {
@@ -687,6 +817,26 @@ export class StoryFileScanner extends Scanner {
                             }
                         }
                     }
+                    // Parse type: { name: 'string', required: true }
+                    if (argPropName === 'type' && ts.isObjectLiteralExpression(argProp.initializer)) {
+                        argInfo.type = { name: '' };
+                        for (const typeProp of argProp.initializer.properties) {
+                            if (!ts.isPropertyAssignment(typeProp) || !typeProp.name)
+                                continue;
+                            const typePropName = typeProp.name.getText(sourceFile);
+                            if (typePropName === 'name' && ts.isStringLiteral(typeProp.initializer)) {
+                                argInfo.type.name = typeProp.initializer.text;
+                            }
+                            if (typePropName === 'required') {
+                                if (typeProp.initializer.kind === ts.SyntaxKind.TrueKeyword) {
+                                    argInfo.type.required = true;
+                                }
+                                else if (typeProp.initializer.kind === ts.SyntaxKind.FalseKeyword) {
+                                    argInfo.type.required = false;
+                                }
+                            }
+                        }
+                    }
                 }
             }
             argTypes[argName] = argInfo;
@@ -938,6 +1088,176 @@ export class StoryFileScanner extends Scanner {
         const normalizedName = storyName.toLowerCase().replace(/[^a-z0-9]+/g, '-');
         return `${normalizedTitle}--${normalizedName}`;
     }
+    /**
+     * Validate all story args against their argTypes
+     */
+    validateAllStoryArgs() {
+        const validations = [];
+        for (const [, data] of this.parsedMetas) {
+            const validation = this.validateStoryArgs(data);
+            validations.push(validation);
+        }
+        return validations;
+    }
+    /**
+     * Validate args for a single story file
+     */
+    validateStoryArgs(data) {
+        const issues = [];
+        let argsValidated = 0;
+        const { meta, variants, file, componentName } = data;
+        const argTypes = meta.argTypes || {};
+        for (const variant of variants) {
+            if (!variant.args)
+                continue;
+            for (const [propName, value] of Object.entries(variant.args)) {
+                argsValidated++;
+                // Check if prop is defined in argTypes
+                const argType = argTypes[propName];
+                if (!argType) {
+                    // Unknown prop - might be intentional but worth noting
+                    issues.push({
+                        storyName: variant.name,
+                        propName,
+                        issueType: 'unknown-prop',
+                        message: `Prop '${propName}' is not defined in argTypes`,
+                        actualValue: value,
+                    });
+                    continue;
+                }
+                // Check type if defined
+                const expectedType = this.getExpectedType(argType);
+                if (expectedType) {
+                    const actualType = this.getActualType(value);
+                    const isValid = this.isTypeCompatible(expectedType, actualType, value);
+                    if (!isValid) {
+                        issues.push({
+                            storyName: variant.name,
+                            propName,
+                            issueType: 'type-mismatch',
+                            message: `Type mismatch for '${propName}': expected ${expectedType}, got ${actualType}`,
+                            expectedType,
+                            actualType,
+                            actualValue: value,
+                        });
+                    }
+                }
+                // Check options constraint
+                if (argType.options && argType.options.length > 0) {
+                    if (typeof value === 'string' && !argType.options.includes(value)) {
+                        issues.push({
+                            storyName: variant.name,
+                            propName,
+                            issueType: 'invalid-option',
+                            message: `Invalid option for '${propName}': '${value}' is not in [${argType.options.join(', ')}]`,
+                            actualValue: value,
+                        });
+                    }
+                }
+            }
+            // Check for missing required props
+            for (const [propName, argType] of Object.entries(argTypes)) {
+                if (argType.type?.required && (!variant.args || !(propName in variant.args))) {
+                    issues.push({
+                        storyName: variant.name,
+                        propName,
+                        issueType: 'missing-required',
+                        message: `Required prop '${propName}' is missing in story '${variant.name}'`,
+                    });
+                }
+            }
+        }
+        return {
+            file,
+            componentName,
+            issues,
+            argsValidated,
+            isValid: issues.length === 0,
+        };
+    }
+    /**
+     * Get the expected type string from an argType
+     */
+    getExpectedType(argType) {
+        // Check explicit type
+        if (argType.type?.name) {
+            return argType.type.name;
+        }
+        // Infer from control
+        if (argType.control) {
+            if (typeof argType.control === 'string') {
+                return this.controlToType(argType.control);
+            }
+            if (typeof argType.control === 'object' && argType.control.type) {
+                return this.controlToType(argType.control.type);
+            }
+        }
+        // Infer from options
+        if (argType.options && argType.options.length > 0) {
+            return 'string';
+        }
+        return undefined;
+    }
+    /**
+     * Map Storybook control types to basic types
+     */
+    controlToType(control) {
+        switch (control) {
+            case 'text':
+            case 'color':
+            case 'date':
+            case 'select':
+            case 'radio':
+                return 'string';
+            case 'number':
+            case 'range':
+                return 'number';
+            case 'boolean':
+                return 'boolean';
+            case 'object':
+                return 'object';
+            case 'array':
+                return 'array';
+            case 'file':
+                return 'object';
+            default:
+                return control;
+        }
+    }
+    /**
+     * Get the actual type of a value
+     */
+    getActualType(value) {
+        if (value === null)
+            return 'null';
+        if (value === undefined)
+            return 'undefined';
+        if (Array.isArray(value))
+            return 'array';
+        return typeof value;
+    }
+    /**
+     * Check if a value is compatible with an expected type
+     */
+    isTypeCompatible(expectedType, actualType, value) {
+        // Direct type match
+        if (expectedType === actualType)
+            return true;
+        // Allow string for enum types (quoted union types)
+        if (expectedType.includes("'") && actualType === 'string')
+            return true;
+        // Allow number coercion
+        if (expectedType === 'number' && actualType === 'string') {
+            return !isNaN(Number(value));
+        }
+        // Allow any for object types
+        if (expectedType === 'object' && actualType === 'object')
+            return true;
+        // Allow function references (string in AST parsed form)
+        if (expectedType === 'function' && actualType === 'string')
+            return true;
+        return false;
+    }
 }
 /**
  * Scans Storybook static builds (index.json/stories.json) or running servers.