@wireweave/core 1.2.0 → 1.3.0

package/dist/index.d.cts

@@ -414,190 +414,6 @@ declare function isValidAst(ast: WireframeDocument): boolean;
  */
 declare function getValidationErrors(ast: WireframeDocument): ValidationError[];
 
-/**
- * UX Rules Type Definitions
- *
- * Types for UX validation rules engine.
- */
-
-/**
- * Severity level of UX issues
- */
-type UXIssueSeverity = 'error' | 'warning' | 'info';
-/**
- * Category of UX rule
- */
-type UXRuleCategory = 'accessibility' | 'usability' | 'consistency' | 'touch-target' | 'contrast' | 'navigation' | 'form' | 'feedback';
-/**
- * UX validation issue
- */
-interface UXIssue {
-    /** Unique rule ID */
-    ruleId: string;
-    /** Rule category */
-    category: UXRuleCategory;
-    /** Issue severity */
-    severity: UXIssueSeverity;
-    /** Human-readable message */
-    message: string;
-    /** Detailed description of the issue */
-    description: string;
-    /** How to fix the issue */
-    suggestion: string;
-    /** Path to the problematic node */
-    path: string;
-    /** Node type where issue occurred */
-    nodeType: string;
-    /** Source location (if available) */
-    location?: {
-        line: number;
-        column: number;
-    };
-}
-/**
- * UX validation result
- */
-interface UXValidationResult {
-    /** Whether all checks passed (no errors) */
-    valid: boolean;
-    /** Total score (0-100) */
-    score: number;
-    /** Issues found */
-    issues: UXIssue[];
-    /** Summary by category */
-    summary: {
-        category: UXRuleCategory;
-        passed: number;
-        failed: number;
-        warnings: number;
-    }[];
-    /** Summary by severity */
-    severityCounts: {
-        errors: number;
-        warnings: number;
-        info: number;
-    };
-}
-/**
- * UX rule definition
- */
-interface UXRule {
-    /** Unique rule ID */
-    id: string;
-    /** Rule category */
-    category: UXRuleCategory;
-    /** Default severity */
-    severity: UXIssueSeverity;
-    /** Rule name */
-    name: string;
-    /** Rule description */
-    description: string;
-    /** Component types this rule applies to (empty = all) */
-    appliesTo: string[];
-    /** Check function */
-    check: (node: AnyNode, context: UXRuleContext) => UXIssue | UXIssue[] | null;
-}
-/**
- * Context provided to rule check functions
- */
-interface UXRuleContext {
-    /** Path to current node */
-    path: string;
-    /** Parent node (if any) */
-    parent: AnyNode | null;
-    /** Root document */
-    root: AnyNode;
-    /** All siblings of current node */
-    siblings: AnyNode[];
-    /** Index in parent's children */
-    index: number;
-    /** Depth in tree */
-    depth: number;
-}
-/**
- * UX validation options
- */
-interface UXValidationOptions {
-    /** Categories to check (empty = all) */
-    categories?: UXRuleCategory[];
-    /** Minimum severity to report */
-    minSeverity?: UXIssueSeverity;
-    /** Maximum issues to collect */
-    maxIssues?: number;
-    /** Custom rules to add */
-    customRules?: UXRule[];
-    /** Rules to disable by ID */
-    disabledRules?: string[];
-}
-
-/**
- * UX Rules Index
- *
- * Exports all UX rules organized by category.
- */
-
-/**
- * All built-in UX rules
- */
-declare const allRules: UXRule[];
-/**
- * Rules organized by category
- */
-declare const rulesByCategory: {
-    accessibility: UXRule[];
-    form: UXRule[];
-    'touch-target': UXRule[];
-    consistency: UXRule[];
-    usability: UXRule[];
-    navigation: UXRule[];
-};
-/**
- * Get rules for specific categories
- */
-declare function getRulesForCategories(categories: string[]): UXRule[];
-
-/**
- * UX Rules Validation Engine
- *
- * Validates wireframe AST against UX best practices.
- * Provides actionable feedback for improving user experience.
- */
-
-/**
- * Validate a wireframe document against UX rules
- *
- * @param ast - The parsed AST document
- * @param options - Validation options
- * @returns Validation result with issues and score
- */
-declare function validateUX(ast: WireframeDocument, options?: UXValidationOptions): UXValidationResult;
-/**
- * Quick UX validation - returns true if no errors
- *
- * @param ast - The parsed AST document
- * @returns true if no UX errors found
- */
-declare function isUXValid(ast: WireframeDocument): boolean;
-/**
- * Get UX issues from an AST
- *
- * @param ast - The parsed AST document
- * @param options - Validation options
- * @returns Array of UX issues
- */
-declare function getUXIssues(ast: WireframeDocument, options?: UXValidationOptions): UXIssue[];
-/**
- * Get UX score for a wireframe (0-100)
- *
- * @param ast - The parsed AST document
- * @returns UX score from 0 to 100
- */
-declare function getUXScore(ast: WireframeDocument): number;
-/**
- * Format UX validation result as human-readable string
- */
-declare function formatUXResult(result: UXValidationResult): string;
-
 /**
  * Diff Types
  *
@@ -1028,4 +844,4 @@ interface AnalysisOptions {
  */
 declare function analyze(doc: WireframeDocument, options?: AnalysisOptions): AnalysisResult;
 
-export { ATTRIBUTE_MAP, ATTRIBUTE_SPECS, type AccessibilityMetrics, AccordionNode, AlertNode, type AnalysisOptions, type AnalysisResult, AnyNode, type AttributeChange, type AttributeSpec, type AttributeValueType, AvatarNode, BadgeNode, BreadcrumbNode, ButtonNode, COMMON_ATTRIBUTES, COMPONENT_MAP, COMPONENT_SPECS, CardNode, CheckboxNode, ColNode, type ComplexityMetrics, type ComponentCategory, type ComponentSpec, type ComponentStats, ContainerComponentNode, ContainerNode, type ContentAnalysis, DEFAULT_VIEWPORT, DEVICE_PRESETS, DataNode, type DiffChangeType, type DiffOptions, type DiffResult, type DiffSummary, DisplayNode, DividerComponentNode, DrawerNode, DropdownNode, type ExportOptions, FeedbackNode, type FigmaExportResult, type FigmaNode, type FigmaNodeType, FooterNode, GridNode, HeaderNode, IconNode, ImageNode, InputComponentNode, InputNode, type JsonExportResult, type JsonNode, type LayoutAnalysis, LayoutNode, LeafNode, LinkNode, ListNode, MainNode, ModalNode, NODE_TYPE_MAP, NavNode, NavigationNode, type NodeChange, type NodePredicate, NodeType, OverlayNode, PageNode, PlaceholderNode, PopoverNode, type PreviewWrapperOptions, ProgressNode, RadioNode, RowNode, SectionNode, SelectNode, SidebarNode, SliderNode, SpinnerNode, SwitchNode, TableNode, TabsNode, TextContentNode, TextNode, TextareaNode, TitleNode, ToastNode, TooltipNode, type TreeMetrics, type UXIssue, type UXIssueSeverity, type UXRule, type UXRuleCategory, type UXRuleContext, type UXValidationOptions, type UXValidationResult, VALID_ATTRIBUTE_NAMES, VALID_COMPONENT_NAMES, type ValidationError, type ValidationOptions, type ValidationResult, type ViewportSize, type WalkCallback, WireframeDocument, allRules, analyze, areIdentical, calculateViewportScale, cloneNode, contains, countNodes, diff, exportToFigma, exportToFigmaString, exportToJson, exportToJsonString, find, findAll, findByType, formatUXResult, getAncestors, getChangeSummary, getDevicePresets, getMaxDepth, getNodeTypes, getRulesForCategories, getUXIssues, getUXScore, getValidAttributes, getValidationErrors, hasChildren, importFromJson, isAccordionNode, isAlertNode, isAvatarNode, isBadgeNode, isBreadcrumbNode, isButtonNode, isCardNode, isCheckboxNode, isColNode, isContainerComponentNode, isContainerNode, isDataNode, isDisplayNode, isDividerNode, isDrawerNode, isDropdownNode, isFeedbackNode, isFooterNode, isGridNode, isHeaderNode, isIconNode, isImageNode, isInputComponentNode, isInputNode, isLayoutNode, isLeafNode, isLinkNode, isListNode, isMainNode, isModalNode, isNavNode, isNavigationNode, isNodeType, isOverlayNode, isPageNode, isPlaceholderNode, isPopoverNode, isProgressNode, isRadioNode, isRowNode, isSectionNode, isSelectNode, isSidebarNode, isSliderNode, isSpinnerNode, isSwitchNode, isTableNode, isTabsNode, isTextContentNode, isTextNode, isTextareaNode, isTitleNode, isToastNode, isTooltipNode, isUXValid, isValidAst, isValidAttribute, isValidDevicePreset, mapNodes, parseViewportString, resetFigmaIdCounter, resolveViewport, rulesByCategory, validate, validateUX, walk, walkDocument, wrapInPreviewContainer };
+export { ATTRIBUTE_MAP, ATTRIBUTE_SPECS, type AccessibilityMetrics, AccordionNode, AlertNode, type AnalysisOptions, type AnalysisResult, AnyNode, type AttributeChange, type AttributeSpec, type AttributeValueType, AvatarNode, BadgeNode, BreadcrumbNode, ButtonNode, COMMON_ATTRIBUTES, COMPONENT_MAP, COMPONENT_SPECS, CardNode, CheckboxNode, ColNode, type ComplexityMetrics, type ComponentCategory, type ComponentSpec, type ComponentStats, ContainerComponentNode, ContainerNode, type ContentAnalysis, DEFAULT_VIEWPORT, DEVICE_PRESETS, DataNode, type DiffChangeType, type DiffOptions, type DiffResult, type DiffSummary, DisplayNode, DividerComponentNode, DrawerNode, DropdownNode, type ExportOptions, FeedbackNode, type FigmaExportResult, type FigmaNode, type FigmaNodeType, FooterNode, GridNode, HeaderNode, IconNode, ImageNode, InputComponentNode, InputNode, type JsonExportResult, type JsonNode, type LayoutAnalysis, LayoutNode, LeafNode, LinkNode, ListNode, MainNode, ModalNode, NODE_TYPE_MAP, NavNode, NavigationNode, type NodeChange, type NodePredicate, NodeType, OverlayNode, PageNode, PlaceholderNode, PopoverNode, type PreviewWrapperOptions, ProgressNode, RadioNode, RowNode, SectionNode, SelectNode, SidebarNode, SliderNode, SpinnerNode, SwitchNode, TableNode, TabsNode, TextContentNode, TextNode, TextareaNode, TitleNode, ToastNode, TooltipNode, type TreeMetrics, VALID_ATTRIBUTE_NAMES, VALID_COMPONENT_NAMES, type ValidationError, type ValidationOptions, type ValidationResult, type ViewportSize, type WalkCallback, WireframeDocument, analyze, areIdentical, calculateViewportScale, cloneNode, contains, countNodes, diff, exportToFigma, exportToFigmaString, exportToJson, exportToJsonString, find, findAll, findByType, getAncestors, getChangeSummary, getDevicePresets, getMaxDepth, getNodeTypes, getValidAttributes, getValidationErrors, hasChildren, importFromJson, isAccordionNode, isAlertNode, isAvatarNode, isBadgeNode, isBreadcrumbNode, isButtonNode, isCardNode, isCheckboxNode, isColNode, isContainerComponentNode, isContainerNode, isDataNode, isDisplayNode, isDividerNode, isDrawerNode, isDropdownNode, isFeedbackNode, isFooterNode, isGridNode, isHeaderNode, isIconNode, isImageNode, isInputComponentNode, isInputNode, isLayoutNode, isLeafNode, isLinkNode, isListNode, isMainNode, isModalNode, isNavNode, isNavigationNode, isNodeType, isOverlayNode, isPageNode, isPlaceholderNode, isPopoverNode, isProgressNode, isRadioNode, isRowNode, isSectionNode, isSelectNode, isSidebarNode, isSliderNode, isSpinnerNode, isSwitchNode, isTableNode, isTabsNode, isTextContentNode, isTextNode, isTextareaNode, isTitleNode, isToastNode, isTooltipNode, isValidAst, isValidAttribute, isValidDevicePreset, mapNodes, parseViewportString, resetFigmaIdCounter, resolveViewport, validate, walk, walkDocument, wrapInPreviewContainer };

package/dist/index.d.ts

@@ -414,190 +414,6 @@ declare function isValidAst(ast: WireframeDocument): boolean;
  */
 declare function getValidationErrors(ast: WireframeDocument): ValidationError[];
 
-/**
- * UX Rules Type Definitions
- *
- * Types for UX validation rules engine.
- */
-
-/**
- * Severity level of UX issues
- */
-type UXIssueSeverity = 'error' | 'warning' | 'info';
-/**
- * Category of UX rule
- */
-type UXRuleCategory = 'accessibility' | 'usability' | 'consistency' | 'touch-target' | 'contrast' | 'navigation' | 'form' | 'feedback';
-/**
- * UX validation issue
- */
-interface UXIssue {
-    /** Unique rule ID */
-    ruleId: string;
-    /** Rule category */
-    category: UXRuleCategory;
-    /** Issue severity */
-    severity: UXIssueSeverity;
-    /** Human-readable message */
-    message: string;
-    /** Detailed description of the issue */
-    description: string;
-    /** How to fix the issue */
-    suggestion: string;
-    /** Path to the problematic node */
-    path: string;
-    /** Node type where issue occurred */
-    nodeType: string;
-    /** Source location (if available) */
-    location?: {
-        line: number;
-        column: number;
-    };
-}
-/**
- * UX validation result
- */
-interface UXValidationResult {
-    /** Whether all checks passed (no errors) */
-    valid: boolean;
-    /** Total score (0-100) */
-    score: number;
-    /** Issues found */
-    issues: UXIssue[];
-    /** Summary by category */
-    summary: {
-        category: UXRuleCategory;
-        passed: number;
-        failed: number;
-        warnings: number;
-    }[];
-    /** Summary by severity */
-    severityCounts: {
-        errors: number;
-        warnings: number;
-        info: number;
-    };
-}
-/**
- * UX rule definition
- */
-interface UXRule {
-    /** Unique rule ID */
-    id: string;
-    /** Rule category */
-    category: UXRuleCategory;
-    /** Default severity */
-    severity: UXIssueSeverity;
-    /** Rule name */
-    name: string;
-    /** Rule description */
-    description: string;
-    /** Component types this rule applies to (empty = all) */
-    appliesTo: string[];
-    /** Check function */
-    check: (node: AnyNode, context: UXRuleContext) => UXIssue | UXIssue[] | null;
-}
-/**
- * Context provided to rule check functions
- */
-interface UXRuleContext {
-    /** Path to current node */
-    path: string;
-    /** Parent node (if any) */
-    parent: AnyNode | null;
-    /** Root document */
-    root: AnyNode;
-    /** All siblings of current node */
-    siblings: AnyNode[];
-    /** Index in parent's children */
-    index: number;
-    /** Depth in tree */
-    depth: number;
-}
-/**
- * UX validation options
- */
-interface UXValidationOptions {
-    /** Categories to check (empty = all) */
-    categories?: UXRuleCategory[];
-    /** Minimum severity to report */
-    minSeverity?: UXIssueSeverity;
-    /** Maximum issues to collect */
-    maxIssues?: number;
-    /** Custom rules to add */
-    customRules?: UXRule[];
-    /** Rules to disable by ID */
-    disabledRules?: string[];
-}
-
-/**
- * UX Rules Index
- *
- * Exports all UX rules organized by category.
- */
-
-/**
- * All built-in UX rules
- */
-declare const allRules: UXRule[];
-/**
- * Rules organized by category
- */
-declare const rulesByCategory: {
-    accessibility: UXRule[];
-    form: UXRule[];
-    'touch-target': UXRule[];
-    consistency: UXRule[];
-    usability: UXRule[];
-    navigation: UXRule[];
-};
-/**
- * Get rules for specific categories
- */
-declare function getRulesForCategories(categories: string[]): UXRule[];
-
-/**
- * UX Rules Validation Engine
- *
- * Validates wireframe AST against UX best practices.
- * Provides actionable feedback for improving user experience.
- */
-
-/**
- * Validate a wireframe document against UX rules
- *
- * @param ast - The parsed AST document
- * @param options - Validation options
- * @returns Validation result with issues and score
- */
-declare function validateUX(ast: WireframeDocument, options?: UXValidationOptions): UXValidationResult;
-/**
- * Quick UX validation - returns true if no errors
- *
- * @param ast - The parsed AST document
- * @returns true if no UX errors found
- */
-declare function isUXValid(ast: WireframeDocument): boolean;
-/**
- * Get UX issues from an AST
- *
- * @param ast - The parsed AST document
- * @param options - Validation options
- * @returns Array of UX issues
- */
-declare function getUXIssues(ast: WireframeDocument, options?: UXValidationOptions): UXIssue[];
-/**
- * Get UX score for a wireframe (0-100)
- *
- * @param ast - The parsed AST document
- * @returns UX score from 0 to 100
- */
-declare function getUXScore(ast: WireframeDocument): number;
-/**
- * Format UX validation result as human-readable string
- */
-declare function formatUXResult(result: UXValidationResult): string;
-
 /**
  * Diff Types
  *
@@ -1028,4 +844,4 @@ interface AnalysisOptions {
  */
 declare function analyze(doc: WireframeDocument, options?: AnalysisOptions): AnalysisResult;
 
-export { ATTRIBUTE_MAP, ATTRIBUTE_SPECS, type AccessibilityMetrics, AccordionNode, AlertNode, type AnalysisOptions, type AnalysisResult, AnyNode, type AttributeChange, type AttributeSpec, type AttributeValueType, AvatarNode, BadgeNode, BreadcrumbNode, ButtonNode, COMMON_ATTRIBUTES, COMPONENT_MAP, COMPONENT_SPECS, CardNode, CheckboxNode, ColNode, type ComplexityMetrics, type ComponentCategory, type ComponentSpec, type ComponentStats, ContainerComponentNode, ContainerNode, type ContentAnalysis, DEFAULT_VIEWPORT, DEVICE_PRESETS, DataNode, type DiffChangeType, type DiffOptions, type DiffResult, type DiffSummary, DisplayNode, DividerComponentNode, DrawerNode, DropdownNode, type ExportOptions, FeedbackNode, type FigmaExportResult, type FigmaNode, type FigmaNodeType, FooterNode, GridNode, HeaderNode, IconNode, ImageNode, InputComponentNode, InputNode, type JsonExportResult, type JsonNode, type LayoutAnalysis, LayoutNode, LeafNode, LinkNode, ListNode, MainNode, ModalNode, NODE_TYPE_MAP, NavNode, NavigationNode, type NodeChange, type NodePredicate, NodeType, OverlayNode, PageNode, PlaceholderNode, PopoverNode, type PreviewWrapperOptions, ProgressNode, RadioNode, RowNode, SectionNode, SelectNode, SidebarNode, SliderNode, SpinnerNode, SwitchNode, TableNode, TabsNode, TextContentNode, TextNode, TextareaNode, TitleNode, ToastNode, TooltipNode, type TreeMetrics, type UXIssue, type UXIssueSeverity, type UXRule, type UXRuleCategory, type UXRuleContext, type UXValidationOptions, type UXValidationResult, VALID_ATTRIBUTE_NAMES, VALID_COMPONENT_NAMES, type ValidationError, type ValidationOptions, type ValidationResult, type ViewportSize, type WalkCallback, WireframeDocument, allRules, analyze, areIdentical, calculateViewportScale, cloneNode, contains, countNodes, diff, exportToFigma, exportToFigmaString, exportToJson, exportToJsonString, find, findAll, findByType, formatUXResult, getAncestors, getChangeSummary, getDevicePresets, getMaxDepth, getNodeTypes, getRulesForCategories, getUXIssues, getUXScore, getValidAttributes, getValidationErrors, hasChildren, importFromJson, isAccordionNode, isAlertNode, isAvatarNode, isBadgeNode, isBreadcrumbNode, isButtonNode, isCardNode, isCheckboxNode, isColNode, isContainerComponentNode, isContainerNode, isDataNode, isDisplayNode, isDividerNode, isDrawerNode, isDropdownNode, isFeedbackNode, isFooterNode, isGridNode, isHeaderNode, isIconNode, isImageNode, isInputComponentNode, isInputNode, isLayoutNode, isLeafNode, isLinkNode, isListNode, isMainNode, isModalNode, isNavNode, isNavigationNode, isNodeType, isOverlayNode, isPageNode, isPlaceholderNode, isPopoverNode, isProgressNode, isRadioNode, isRowNode, isSectionNode, isSelectNode, isSidebarNode, isSliderNode, isSpinnerNode, isSwitchNode, isTableNode, isTabsNode, isTextContentNode, isTextNode, isTextareaNode, isTitleNode, isToastNode, isTooltipNode, isUXValid, isValidAst, isValidAttribute, isValidDevicePreset, mapNodes, parseViewportString, resetFigmaIdCounter, resolveViewport, rulesByCategory, validate, validateUX, walk, walkDocument, wrapInPreviewContainer };
+export { ATTRIBUTE_MAP, ATTRIBUTE_SPECS, type AccessibilityMetrics, AccordionNode, AlertNode, type AnalysisOptions, type AnalysisResult, AnyNode, type AttributeChange, type AttributeSpec, type AttributeValueType, AvatarNode, BadgeNode, BreadcrumbNode, ButtonNode, COMMON_ATTRIBUTES, COMPONENT_MAP, COMPONENT_SPECS, CardNode, CheckboxNode, ColNode, type ComplexityMetrics, type ComponentCategory, type ComponentSpec, type ComponentStats, ContainerComponentNode, ContainerNode, type ContentAnalysis, DEFAULT_VIEWPORT, DEVICE_PRESETS, DataNode, type DiffChangeType, type DiffOptions, type DiffResult, type DiffSummary, DisplayNode, DividerComponentNode, DrawerNode, DropdownNode, type ExportOptions, FeedbackNode, type FigmaExportResult, type FigmaNode, type FigmaNodeType, FooterNode, GridNode, HeaderNode, IconNode, ImageNode, InputComponentNode, InputNode, type JsonExportResult, type JsonNode, type LayoutAnalysis, LayoutNode, LeafNode, LinkNode, ListNode, MainNode, ModalNode, NODE_TYPE_MAP, NavNode, NavigationNode, type NodeChange, type NodePredicate, NodeType, OverlayNode, PageNode, PlaceholderNode, PopoverNode, type PreviewWrapperOptions, ProgressNode, RadioNode, RowNode, SectionNode, SelectNode, SidebarNode, SliderNode, SpinnerNode, SwitchNode, TableNode, TabsNode, TextContentNode, TextNode, TextareaNode, TitleNode, ToastNode, TooltipNode, type TreeMetrics, VALID_ATTRIBUTE_NAMES, VALID_COMPONENT_NAMES, type ValidationError, type ValidationOptions, type ValidationResult, type ViewportSize, type WalkCallback, WireframeDocument, analyze, areIdentical, calculateViewportScale, cloneNode, contains, countNodes, diff, exportToFigma, exportToFigmaString, exportToJson, exportToJsonString, find, findAll, findByType, getAncestors, getChangeSummary, getDevicePresets, getMaxDepth, getNodeTypes, getValidAttributes, getValidationErrors, hasChildren, importFromJson, isAccordionNode, isAlertNode, isAvatarNode, isBadgeNode, isBreadcrumbNode, isButtonNode, isCardNode, isCheckboxNode, isColNode, isContainerComponentNode, isContainerNode, isDataNode, isDisplayNode, isDividerNode, isDrawerNode, isDropdownNode, isFeedbackNode, isFooterNode, isGridNode, isHeaderNode, isIconNode, isImageNode, isInputComponentNode, isInputNode, isLayoutNode, isLeafNode, isLinkNode, isListNode, isMainNode, isModalNode, isNavNode, isNavigationNode, isNodeType, isOverlayNode, isPageNode, isPlaceholderNode, isPopoverNode, isProgressNode, isRadioNode, isRowNode, isSectionNode, isSelectNode, isSidebarNode, isSliderNode, isSpinnerNode, isSwitchNode, isTableNode, isTabsNode, isTextContentNode, isTextNode, isTextareaNode, isTitleNode, isToastNode, isTooltipNode, isValidAst, isValidAttribute, isValidDevicePreset, mapNodes, parseViewportString, resetFigmaIdCounter, resolveViewport, validate, walk, walkDocument, wrapInPreviewContainer };