@wireweave/core 1.1.0 → 1.2.0-beta.0

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-import { A as AnyNode, C as ContainerNode, L as LeafNode, a as LayoutNode, P as PageNode, H as HeaderNode, M as MainNode, F as FooterNode, S as SidebarNode, b as SectionNode, G as GridNode, R as RowNode, c as ColNode, d as ContainerComponentNode, e as CardNode, f as ModalNode, D as DrawerNode, g as AccordionNode, T as TextContentNode, h as TextNode, i as TitleNode, j as LinkNode, I as InputComponentNode, k as InputNode, l as TextareaNode, m as SelectNode, n as CheckboxNode, o as RadioNode, p as SwitchNode, q as SliderNode, B as ButtonNode, r as DisplayNode, s as ImageNode, t as PlaceholderNode, u as AvatarNode, v as BadgeNode, w as IconNode, x as DataNode, y as TableNode, z as ListNode, E as FeedbackNode, J as AlertNode, K as ToastNode, N as ProgressNode, O as SpinnerNode, Q as OverlayNode, U as TooltipNode, V as PopoverNode, W as DropdownNode, X as NavigationNode, Y as NavNode, Z as TabsNode, _ as BreadcrumbNode, $ as DividerComponentNode, a0 as NodeType, a1 as WireframeDocument } from './types-DtovIYS6.js';
-export { ax as AlertVariant, ac as AlignValue, as as AvatarSize, au as BadgeSize, at as BadgeVariant, a4 as BaseNode, aF as BreadcrumbItem, ar as ButtonSize, aq as ButtonVariant, ag as CommonProps, ad as DirectionValue, aC as DividerNode, ai as DrawerPosition, aB as DropdownItemNode, ae as FlexProps, af as GridProps, a9 as HeightValue, av as IconSize, ao as InputType, ab as JustifyValue, aw as ListItemNode, aD as NavItem, a2 as Position, ap as SelectOption, ah as ShadowValue, aa as SizeProps, a3 as SourceLocation, a7 as SpacingProps, a6 as SpacingValue, az as SpinnerSize, aE as TabNode, am as TextAlign, ak as TextSize, aj as TextSizeToken, al as TextWeight, an as TitleLevel, ay as ToastPosition, aA as TooltipPosition, a5 as ValueWithUnit, a8 as WidthValue } from './types-DtovIYS6.js';
+import { A as AnyNode, C as ContainerNode, L as LeafNode, a as LayoutNode, P as PageNode, H as HeaderNode, M as MainNode, F as FooterNode, S as SidebarNode, b as SectionNode, G as GridNode, R as RowNode, c as ColNode, d as ContainerComponentNode, e as CardNode, f as ModalNode, D as DrawerNode, g as AccordionNode, T as TextContentNode, h as TextNode, i as TitleNode, j as LinkNode, I as InputComponentNode, k as InputNode, l as TextareaNode, m as SelectNode, n as CheckboxNode, o as RadioNode, p as SwitchNode, q as SliderNode, B as ButtonNode, r as DisplayNode, s as ImageNode, t as PlaceholderNode, u as AvatarNode, v as BadgeNode, w as IconNode, x as DataNode, y as TableNode, z as ListNode, E as FeedbackNode, J as AlertNode, K as ToastNode, N as ProgressNode, O as SpinnerNode, Q as OverlayNode, U as TooltipNode, V as PopoverNode, W as DropdownNode, X as NavigationNode, Y as NavNode, Z as TabsNode, _ as BreadcrumbNode, $ as DividerComponentNode, a0 as NodeType, a1 as WireframeDocument } from './types-lcJzPcR0.js';
+export { ay as AlertVariant, ac as AlignValue, at as AvatarSize, av as BadgeSize, au as BadgeVariant, a4 as BaseNode, aK as BreadcrumbItem, as as ButtonSize, ar as ButtonVariant, ah as CommonProps, ad as DirectionValue, aD as DividerNode, aj as DrawerPosition, aC as DropdownItemNode, ae as FlexProps, af as GridProps, a9 as HeightValue, aw as IconSize, ap as InputType, ab as JustifyValue, ax as ListItemNode, aF as NavBlockItem, aI as NavChild, aH as NavDivider, aG as NavGroupNode, aE as NavItem, a2 as Position, ag as PositionProps, aq as SelectOption, ai as ShadowValue, aa as SizeProps, a3 as SourceLocation, a7 as SpacingProps, a6 as SpacingValue, aA as SpinnerSize, aJ as TabNode, an as TextAlign, al as TextSize, ak as TextSizeToken, am as TextWeight, ao as TitleLevel, az as ToastPosition, aB as TooltipPosition, a5 as ValueWithUnit, a8 as WidthValue } from './types-lcJzPcR0.js';
 export { ExpectedToken, ParseError, ParseErrorInfo, ParseOptions, ParseResult, getErrors, isValid, parse, tryParse } from './parser.js';
-export { HtmlRenderer, IconData, IconElement, RenderContext, RenderOptions, RenderResult, SvgRenderOptions, SvgRenderResult, SvgRenderer, ThemeColors, ThemeConfig, createHtmlRenderer, createSvgRenderer, darkTheme, defaultTheme, generateComponentStyles, generateStyles, getIconData, getTheme, lucideIcons, render, renderIconSvg, renderToHtml, renderToPureSvg, renderToSvg } from './renderer.js';
+export { HtmlRenderer, IconData, IconElement, RenderContext, RenderOptions, RenderResult, SvgRenderOptions, SvgRenderResult, ThemeColors, ThemeConfig, createHtmlRenderer, darkTheme, defaultTheme, generateComponentStyles, generateStyles, getIconData, getTheme, lucideIcons, render, renderIconSvg, renderToHtml, renderToSvg } from './renderer.js';
 
 /**
  * Type guards for wireweave AST
@@ -249,4 +249,783 @@ interface PreviewWrapperOptions {
  */
 declare function wrapInPreviewContainer(html: string, viewport: ViewportSize, options?: PreviewWrapperOptions): string;
 
-export { AccordionNode, AlertNode, AnyNode, AvatarNode, BadgeNode, BreadcrumbNode, ButtonNode, CardNode, CheckboxNode, ColNode, ContainerComponentNode, ContainerNode, DEFAULT_VIEWPORT, DEVICE_PRESETS, DataNode, DisplayNode, DividerComponentNode, DrawerNode, DropdownNode, FeedbackNode, FooterNode, GridNode, HeaderNode, IconNode, ImageNode, InputComponentNode, InputNode, LayoutNode, LeafNode, LinkNode, ListNode, MainNode, ModalNode, NavNode, NavigationNode, 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 ViewportSize, type WalkCallback, WireframeDocument, calculateViewportScale, cloneNode, contains, countNodes, find, findAll, findByType, getAncestors, getDevicePresets, getMaxDepth, getNodeTypes, hasChildren, 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, isValidDevicePreset, mapNodes, parseViewportString, resolveViewport, walk, walkDocument, wrapInPreviewContainer };
+/**
+ * Types for Wireweave DSL Specification
+ */
+/**
+ * Attribute value type
+ */
+type AttributeValueType = 'boolean' | 'number' | 'string' | 'string[]' | 'enum';
+/**
+ * Attribute definition
+ */
+interface AttributeSpec {
+    /** Attribute name */
+    name: string;
+    /** Value type */
+    type: AttributeValueType;
+    /** Enum values (if type is 'enum') */
+    values?: readonly string[];
+    /** Description for documentation */
+    description?: string;
+}
+/**
+ * Component category
+ */
+type ComponentCategory = 'layout' | 'grid' | 'container' | 'text' | 'input' | 'display' | 'data' | 'feedback' | 'overlay' | 'navigation';
+/**
+ * Component definition
+ */
+interface ComponentSpec {
+    /** Component name (lowercase, as used in DSL) */
+    name: string;
+    /** AST node type (PascalCase) */
+    nodeType: string;
+    /** Component category */
+    category: ComponentCategory;
+    /** Valid attributes for this component (names only, definitions in ATTRIBUTES) */
+    attributes: readonly string[];
+    /** Whether this component can have children */
+    hasChildren: boolean;
+    /** Description for documentation */
+    description?: string;
+}
+
+/**
+ * Wireweave DSL Component Definitions
+ *
+ * Complete list of all valid components in Wireweave DSL.
+ * Each component specifies its valid attributes.
+ */
+
+/**
+ * All valid components in Wireweave DSL
+ */
+declare const COMPONENT_SPECS: readonly ComponentSpec[];
+/**
+ * Set of all valid component names for quick lookup
+ */
+declare const VALID_COMPONENT_NAMES: ReadonlySet<string>;
+/**
+ * Map of component name to spec for quick lookup
+ */
+declare const COMPONENT_MAP: ReadonlyMap<string, ComponentSpec>;
+/**
+ * Map of AST node type to spec for quick lookup
+ */
+declare const NODE_TYPE_MAP: ReadonlyMap<string, ComponentSpec>;
+/**
+ * Get valid attributes for a component (by name or node type)
+ */
+declare function getValidAttributes(componentNameOrType: string): readonly string[] | undefined;
+/**
+ * Check if an attribute is valid for a component
+ */
+declare function isValidAttribute(componentNameOrType: string, attributeName: string): boolean;
+
+/**
+ * Wireweave DSL Attribute Definitions
+ *
+ * Complete list of all valid attributes in Wireweave DSL.
+ */
+
+/**
+ * All valid attributes in Wireweave DSL
+ */
+declare const ATTRIBUTE_SPECS: readonly AttributeSpec[];
+/**
+ * Set of all valid attribute names for quick lookup
+ */
+declare const VALID_ATTRIBUTE_NAMES: ReadonlySet<string>;
+/**
+ * Map of attribute name to spec for quick lookup
+ */
+declare const ATTRIBUTE_MAP: ReadonlyMap<string, AttributeSpec>;
+/**
+ * Common attributes available to most components
+ */
+declare const COMMON_ATTRIBUTES: readonly string[];
+
+/**
+ * Wireweave DSL Validation
+ *
+ * Validates AST nodes against the DSL specification.
+ * Checks that all attributes are valid for their respective components.
+ */
+
+/**
+ * Validation error details
+ */
+interface ValidationError {
+    /** Error message */
+    message: string;
+    /** Path to the invalid node (e.g., "pages[0].children[1]") */
+    path: string;
+    /** Node type where error occurred */
+    nodeType: string;
+    /** Invalid attribute name (if applicable) */
+    attribute?: string;
+    /** Source location (if available) */
+    location?: {
+        line: number;
+        column: number;
+    };
+}
+/**
+ * Validation result
+ */
+interface ValidationResult {
+    /** Whether the AST is valid */
+    valid: boolean;
+    /** List of validation errors */
+    errors: ValidationError[];
+    /** Summary error message (if invalid) */
+    errorSummary?: string;
+}
+/**
+ * Validation options
+ */
+interface ValidationOptions {
+    /** If true, stop at first error */
+    stopOnFirstError?: boolean;
+    /** Maximum number of errors to collect */
+    maxErrors?: number;
+}
+/**
+ * Validate a Wireweave AST document
+ *
+ * @param ast - The parsed AST document
+ * @param options - Validation options
+ * @returns Validation result with errors if invalid
+ */
+declare function validate(ast: WireframeDocument, options?: ValidationOptions): ValidationResult;
+/**
+ * Quick validation check - returns true if AST has valid attributes
+ *
+ * @param ast - The parsed AST document
+ * @returns true if all attributes are valid
+ */
+declare function isValidAst(ast: WireframeDocument): boolean;
+/**
+ * Get all validation errors from an AST
+ *
+ * @param ast - The parsed AST document
+ * @returns Array of validation errors
+ */
+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
+ *
+ * Types for comparing two wireframe ASTs.
+ */
+
+/**
+ * Type of change
+ */
+type DiffChangeType = 'added' | 'removed' | 'changed' | 'moved' | 'unchanged';
+/**
+ * Change to a specific attribute
+ */
+interface AttributeChange {
+    name: string;
+    oldValue: unknown;
+    newValue: unknown;
+    type: 'added' | 'removed' | 'changed';
+}
+/**
+ * Change to a node
+ */
+interface NodeChange {
+    /** Type of change */
+    type: DiffChangeType;
+    /** Path in the old tree */
+    oldPath?: string;
+    /** Path in the new tree */
+    newPath?: string;
+    /** Node type */
+    nodeType: string;
+    /** Content/label of the node (for identification) */
+    label?: string;
+    /** Changed attributes (if type is 'changed') */
+    attributeChanges?: AttributeChange[];
+    /** Child changes (nested) */
+    childChanges?: NodeChange[];
+    /** Old node (if removed or changed) */
+    oldNode?: AnyNode;
+    /** New node (if added or changed) */
+    newNode?: AnyNode;
+}
+/**
+ * Diff result summary
+ */
+interface DiffSummary {
+    /** Total nodes in old tree */
+    oldNodeCount: number;
+    /** Total nodes in new tree */
+    newNodeCount: number;
+    /** Number of added nodes */
+    addedCount: number;
+    /** Number of removed nodes */
+    removedCount: number;
+    /** Number of changed nodes */
+    changedCount: number;
+    /** Number of moved nodes */
+    movedCount: number;
+    /** Number of unchanged nodes */
+    unchangedCount: number;
+}
+/**
+ * Complete diff result
+ */
+interface DiffResult {
+    /** Whether the trees are identical */
+    identical: boolean;
+    /** Summary statistics */
+    summary: DiffSummary;
+    /** List of all changes */
+    changes: NodeChange[];
+    /** Human-readable description of changes */
+    description: string;
+}
+/**
+ * Diff options
+ */
+interface DiffOptions {
+    /** Ignore attribute changes */
+    ignoreAttributes?: boolean;
+    /** Specific attributes to ignore */
+    ignoreAttributeNames?: string[];
+    /** Ignore node order changes */
+    ignoreOrder?: boolean;
+    /** Maximum depth to compare */
+    maxDepth?: number;
+}
+
+/**
+ * Wireframe Diff Engine
+ *
+ * Compares two wireframe ASTs and identifies differences.
+ */
+
+/**
+ * Compare two wireframe documents
+ *
+ * @param oldDoc - The original document
+ * @param newDoc - The modified document
+ * @param options - Comparison options
+ * @returns Diff result with all changes
+ */
+declare function diff(oldDoc: WireframeDocument, newDoc: WireframeDocument, options?: DiffOptions): DiffResult;
+/**
+ * Quick check if two documents are identical
+ */
+declare function areIdentical(oldDoc: WireframeDocument, newDoc: WireframeDocument): boolean;
+/**
+ * Get a simple change summary string
+ */
+declare function getChangeSummary(oldDoc: WireframeDocument, newDoc: WireframeDocument): string;
+
+/**
+ * Export Types
+ *
+ * Types for exporting wireframes to various formats.
+ */
+/**
+ * Simplified JSON node structure
+ */
+interface JsonNode {
+    /** Node type (e.g., 'page', 'button', 'input') */
+    type: string;
+    /** Node content or label */
+    content?: string;
+    /** Node attributes */
+    attributes: Record<string, unknown>;
+    /** Child nodes */
+    children: JsonNode[];
+    /** Source location (optional) */
+    location?: {
+        line: number;
+        column: number;
+    };
+}
+/**
+ * JSON export result
+ */
+interface JsonExportResult {
+    /** Export format version */
+    version: string;
+    /** Export format */
+    format: 'json';
+    /** Exported pages */
+    pages: JsonNode[];
+    /** Metadata */
+    metadata: {
+        exportedAt: string;
+        sourceFormat: 'wireweave';
+        nodeCount: number;
+        componentTypes: string[];
+    };
+}
+/**
+ * Figma-compatible node structure
+ * Based on Figma's REST API structure
+ */
+interface FigmaNode {
+    /** Unique identifier */
+    id: string;
+    /** Node name */
+    name: string;
+    /** Node type */
+    type: FigmaNodeType;
+    /** Visibility */
+    visible: boolean;
+    /** Node-specific properties */
+    [key: string]: unknown;
+}
+/**
+ * Figma node types that we can map to
+ */
+type FigmaNodeType = 'DOCUMENT' | 'CANVAS' | 'FRAME' | 'GROUP' | 'TEXT' | 'RECTANGLE' | 'INSTANCE' | 'COMPONENT';
+/**
+ * Figma export result
+ */
+interface FigmaExportResult {
+    /** Export format version */
+    version: string;
+    /** Export format */
+    format: 'figma';
+    /** Document structure */
+    document: FigmaNode;
+    /** Component mappings for reference */
+    componentMappings: Record<string, string>;
+}
+/**
+ * Export options
+ */
+interface ExportOptions {
+    /** Include source locations */
+    includeLocations?: boolean;
+    /** Pretty print JSON (with indentation) */
+    prettyPrint?: boolean;
+    /** Include empty attributes */
+    includeEmptyAttributes?: boolean;
+}
+
+/**
+ * JSON export functionality
+ */
+
+/**
+ * Export wireframe to JSON format
+ *
+ * @param doc - The parsed wireframe document
+ * @param options - Export options
+ * @returns JSON export result
+ */
+declare function exportToJson(doc: WireframeDocument, options?: ExportOptions): JsonExportResult;
+/**
+ * Export wireframe to JSON string
+ *
+ * @param doc - The parsed wireframe document
+ * @param options - Export options
+ * @returns JSON string
+ */
+declare function exportToJsonString(doc: WireframeDocument, options?: ExportOptions): string;
+/**
+ * Import from JSON format back to simplified structure
+ *
+ * @param json - JSON export result
+ * @returns Simplified page array
+ */
+declare function importFromJson(json: JsonExportResult): JsonNode[];
+
+/**
+ * Figma export functionality
+ */
+
+/**
+ * Reset Figma ID counter
+ */
+declare function resetFigmaIdCounter(): void;
+/**
+ * Export wireframe to Figma-compatible format
+ *
+ * Note: This creates a structure inspired by Figma's format,
+ * but is not directly importable to Figma. It's designed to be
+ * used with Figma plugins or as a reference for manual recreation.
+ *
+ * @param doc - The parsed wireframe document
+ * @returns Figma export result
+ */
+declare function exportToFigma(doc: WireframeDocument): FigmaExportResult;
+/**
+ * Export wireframe to Figma-compatible JSON string
+ *
+ * @param doc - The parsed wireframe document
+ * @param prettyPrint - Whether to pretty print the output
+ * @returns JSON string
+ */
+declare function exportToFigmaString(doc: WireframeDocument, prettyPrint?: boolean): string;
+
+/**
+ * Analysis Types for wireweave
+ *
+ * Type definitions for wireframe analysis and statistics
+ */
+/**
+ * Component usage statistics
+ */
+interface ComponentStats {
+    /** Component type name */
+    type: string;
+    /** Number of occurrences */
+    count: number;
+    /** Percentage of total components */
+    percentage: number;
+}
+/**
+ * Tree structure metrics
+ */
+interface TreeMetrics {
+    /** Total number of nodes */
+    totalNodes: number;
+    /** Maximum nesting depth */
+    maxDepth: number;
+    /** Average nesting depth */
+    avgDepth: number;
+    /** Number of leaf nodes (no children) */
+    leafNodes: number;
+    /** Number of container nodes (have children) */
+    containerNodes: number;
+}
+/**
+ * Accessibility metrics
+ */
+interface AccessibilityMetrics {
+    /** Overall accessibility score (0-100) */
+    score: number;
+    /** Number of images with alt text */
+    imagesWithAlt: number;
+    /** Total number of images */
+    totalImages: number;
+    /** Number of form inputs with labels */
+    inputsWithLabels: number;
+    /** Total number of form inputs */
+    totalInputs: number;
+    /** Number of buttons with accessible text */
+    buttonsWithText: number;
+    /** Total number of buttons */
+    totalButtons: number;
+    /** Has proper heading hierarchy */
+    hasProperHeadingHierarchy: boolean;
+    /** List of accessibility issues found */
+    issues: string[];
+}
+/**
+ * Complexity metrics
+ */
+interface ComplexityMetrics {
+    /** Overall complexity score (1-10, higher = more complex) */
+    score: number;
+    /** Complexity level description */
+    level: 'simple' | 'moderate' | 'complex' | 'very-complex';
+    /** Number of interactive elements */
+    interactiveElements: number;
+    /** Number of form elements */
+    formElements: number;
+    /** Number of navigation elements */
+    navigationElements: number;
+    /** Number of data display elements (tables, lists) */
+    dataDisplayElements: number;
+    /** Number of feedback elements (alerts, toasts, progress) */
+    feedbackElements: number;
+    /** Number of layout containers */
+    layoutContainers: number;
+}
+/**
+ * Layout analysis
+ */
+interface LayoutAnalysis {
+    /** Has header */
+    hasHeader: boolean;
+    /** Has footer */
+    hasFooter: boolean;
+    /** Has sidebar */
+    hasSidebar: boolean;
+    /** Has main content area */
+    hasMain: boolean;
+    /** Has navigation */
+    hasNavigation: boolean;
+    /** Number of pages */
+    pageCount: number;
+    /** Number of modals */
+    modalCount: number;
+    /** Number of sections */
+    sectionCount: number;
+    /** Layout pattern detected */
+    layoutPattern: string;
+}
+/**
+ * Content analysis
+ */
+interface ContentAnalysis {
+    /** Total text elements */
+    textElements: number;
+    /** Total title elements */
+    titleElements: number;
+    /** Total link elements */
+    linkElements: number;
+    /** Total image elements */
+    imageElements: number;
+    /** Has placeholder content */
+    hasPlaceholders: boolean;
+    /** Number of placeholder elements */
+    placeholderCount: number;
+}
+/**
+ * Complete analysis result
+ */
+interface AnalysisResult {
+    /** Whether analysis was successful */
+    success: boolean;
+    /** Error message if failed */
+    error?: string;
+    /** Summary statistics */
+    summary: {
+        /** Total component count */
+        totalComponents: number;
+        /** Number of unique component types */
+        uniqueTypes: number;
+        /** Most used component type */
+        mostUsedType: string;
+        /** Complexity level */
+        complexityLevel: string;
+        /** Accessibility score */
+        accessibilityScore: number;
+    };
+    /** Component usage breakdown */
+    components: ComponentStats[];
+    /** Tree structure metrics */
+    tree: TreeMetrics;
+    /** Accessibility metrics */
+    accessibility: AccessibilityMetrics;
+    /** Complexity metrics */
+    complexity: ComplexityMetrics;
+    /** Layout analysis */
+    layout: LayoutAnalysis;
+    /** Content analysis */
+    content: ContentAnalysis;
+}
+/**
+ * Analysis options
+ */
+interface AnalysisOptions {
+    /** Include detailed component breakdown */
+    includeComponentBreakdown?: boolean;
+    /** Include accessibility analysis */
+    includeAccessibility?: boolean;
+    /** Include complexity analysis */
+    includeComplexity?: boolean;
+    /** Include layout analysis */
+    includeLayout?: boolean;
+    /** Include content analysis */
+    includeContent?: boolean;
+}
+
+/**
+ * Analysis Engine for wireweave
+ *
+ * Provides comprehensive analysis and statistics for wireframe documents
+ */
+
+/**
+ * Analyze a wireframe document
+ */
+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 };