@wireweave/core 2.3.1 → 2.5.0-beta.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { A as AnyNode, a as AccordionNode, b as AlertNode, c as AvatarNode, B as BadgeNode, d as BreadcrumbNode, e as ButtonNode, C as CardNode, f as CheckboxNode, g as ColNode, h as ContainerComponentNode, i as ContainerNode, D as DataNode, j as DisplayNode, k as DividerComponentNode, l as DrawerNode, m as DropdownNode, F as FeedbackNode, n as FooterNode, G as GridNode, H as HeaderNode, I as IconNode, o as ImageNode, p as InputComponentNode, q as InputNode, L as LayoutNode, r as LeafNode, s as LinkNode, t as ListNode, M as MainNode, u as ModalNode, N as NavNode, v as NavigationNode, w as NodeType, O as OverlayNode, P as PageNode, x as PlaceholderNode, y as PopoverNode, z as ProgressNode, R as RadioNode, E as RowNode, S as SectionNode, J as SelectNode, K as SidebarNode, Q as SliderNode, T as SpinnerNode, U as SwitchNode, V as TableNode, W as TabsNode, X as TextContentNode, Y as TextNode, Z as TextareaNode, _ as TitleNode, $ as ToastNode, a0 as TooltipNode, a1 as WireframeDocument } from './types-D0t4JRY3.cjs';
-export { a2 as AlertVariant, a3 as AlignValue, a4 as AppearanceProps, a5 as AvatarSize, a6 as AvatarSizeToken, a7 as BadgeSize, a8 as BadgeSizeToken, a9 as BadgeVariant, aa as BaseNode, ab as BreadcrumbItem, ac as ButtonSize, ad as ButtonSizeToken, ae as ButtonVariant, af as CommonProps, ag as DirectionValue, ah as DividerNode, ai as DrawerPosition, aj as DropdownItemNode, ak as FlexProps, al as GridProps, am as HeightValue, an as IconSize, ao as IconSizeToken, ap as InputType, aq as InteractiveProps, ar as JustifyValue, as as ListItemNode, at as NavBlockItem, au as NavChild, av as NavDivider, aw as NavGroupNode, ax as NavItem, ay as Position, az as PositionProps, aA as SelectOption, aB as ShadowValue, aC as SizeProps, aD as SourceLocation, aE as SpacingProps, aF as SpacingValue, aG as SpinnerSize, aH as SpinnerSizeToken, aI as TabNode, aJ as TextAlign, aK as TextSize, aL as TextSizeToken, aM as TextWeight, aN as TitleLevel, aO as ToastPosition, aP as TooltipPosition, aQ as ValueWithUnit, aR as WidthValue } from './types-D0t4JRY3.cjs';
+import { A as AnyNode, a as AccordionNode, b as AlertNode, c as AvatarNode, B as BadgeNode, d as BreadcrumbNode, e as ButtonNode, C as CardNode, f as CheckboxNode, g as ColNode, h as ContainerComponentNode, i as ContainerNode, D as DataNode, j as DisplayNode, k as DividerComponentNode, l as DrawerNode, m as DropdownNode, F as FeedbackNode, n as FooterNode, G as GridNode, H as HeaderNode, I as IconNode, o as ImageNode, p as InputComponentNode, q as InputNode, L as LayoutNode, r as LeafNode, s as LinkNode, t as ListNode, M as MainNode, u as ModalNode, N as NavNode, v as NavigationNode, w as NodeType, O as OverlayNode, P as PageNode, x as PlaceholderNode, y as PopoverNode, z as ProgressNode, R as RadioNode, E as RowNode, S as SectionNode, J as SelectNode, K as SidebarNode, Q as SliderNode, T as SpinnerNode, U as SwitchNode, V as TableNode, W as TabsNode, X as TextContentNode, Y as TextNode, Z as TextareaNode, _ as TitleNode, $ as ToastNode, a0 as TooltipNode, a1 as WireframeDocument } from './types-EbEsGNxL.cjs';
+export { a2 as AlertVariant, a3 as AlignValue, a4 as AnchorPosition, a5 as AnnotationItemNode, a6 as AnnotationNode, a7 as AnnotationsNode, a8 as AppearanceProps, a9 as AvatarSize, aa as AvatarSizeToken, ab as BadgeSize, ac as BadgeSizeToken, ad as BadgeVariant, ae as BaseNode, af as BreadcrumbItem, ag as ButtonSize, ah as ButtonSizeToken, ai as ButtonVariant, aj as CommonProps, ak as DirectionValue, al as DividerNode, am as DrawerPosition, an as DropdownItemNode, ao as FlexProps, ap as GridProps, aq as HeightValue, ar as IconSize, as as IconSizeToken, at as InputType, au as InteractiveProps, av as JustifyValue, aw as ListItemNode, ax as MarkerColor, ay as MarkerNode, az as NavBlockItem, aA as NavChild, aB as NavDivider, aC as NavGroupNode, aD as NavItem, aE as Position, aF as PositionProps, aG as RelativeNode, aH as SelectOption, aI as ShadowValue, aJ as SizeProps, aK as SourceLocation, aL as SpacingProps, aM as SpacingValue, aN as SpinnerSize, aO as SpinnerSizeToken, aP as StackNode, aQ as TabNode, aR as TextAlign, aS as TextSize, aT as TextSizeToken, aU as TextWeight, aV as TitleLevel, aW as ToastPosition, aX as TooltipPosition, aY as ValueWithUnit, aZ as WidthValue } from './types-EbEsGNxL.cjs';
 export { ExpectedToken, ParseError, ParseErrorInfo, ParseOptions, ParseResult, getErrors, isValid, parse, tryParse } from './parser.cjs';
 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.cjs';
 
@@ -272,7 +272,7 @@ interface AttributeSpec {
 /**
  * Component category
  */
-type ComponentCategory = 'layout' | 'grid' | 'container' | 'text' | 'input' | 'display' | 'data' | 'feedback' | 'overlay' | 'navigation';
+type ComponentCategory = 'layout' | 'grid' | 'container' | 'text' | 'input' | 'display' | 'data' | 'feedback' | 'overlay' | 'navigation' | 'annotation';
 /**
  * Component definition
  */
@@ -567,9 +567,93 @@ interface JsonExportResult {
         componentTypes: string[];
     };
 }
+/**
+ * Figma node types that we can map to
+ */
+type FigmaNodeType = 'DOCUMENT' | 'CANVAS' | 'FRAME' | 'GROUP' | 'TEXT' | 'RECTANGLE' | 'INSTANCE' | 'COMPONENT';
+/**
+ * Figma Auto Layout mode
+ */
+type FigmaLayoutMode = 'NONE' | 'HORIZONTAL' | 'VERTICAL';
+/**
+ * Figma sizing mode for Auto Layout
+ */
+type FigmaSizingMode = 'FIXED' | 'HUG' | 'FILL';
+/**
+ * Figma primary axis alignment (justify)
+ */
+type FigmaPrimaryAxisAlign = 'MIN' | 'CENTER' | 'MAX' | 'SPACE_BETWEEN';
+/**
+ * Figma counter axis alignment (align)
+ */
+type FigmaCounterAxisAlign = 'MIN' | 'CENTER' | 'MAX' | 'STRETCH' | 'BASELINE';
+/**
+ * Figma text alignment
+ */
+type FigmaTextAlign = 'LEFT' | 'CENTER' | 'RIGHT' | 'JUSTIFIED';
+/**
+ * Figma color (RGBA, 0-1 range)
+ */
+interface FigmaColor {
+    r: number;
+    g: number;
+    b: number;
+    a: number;
+}
+/**
+ * Figma solid fill
+ */
+interface FigmaSolidFill {
+    type: 'SOLID';
+    color: FigmaColor;
+    opacity?: number;
+}
+/**
+ * Figma stroke
+ */
+interface FigmaStroke {
+    type: 'SOLID';
+    color: FigmaColor;
+}
+/**
+ * Figma Auto Layout properties
+ */
+interface FigmaAutoLayout {
+    layoutMode: FigmaLayoutMode;
+    layoutSizingHorizontal: FigmaSizingMode;
+    layoutSizingVertical: FigmaSizingMode;
+    primaryAxisAlignItems: FigmaPrimaryAxisAlign;
+    counterAxisAlignItems: FigmaCounterAxisAlign;
+    paddingTop: number;
+    paddingRight: number;
+    paddingBottom: number;
+    paddingLeft: number;
+    itemSpacing: number;
+    layoutWrap?: 'NO_WRAP' | 'WRAP';
+}
+/**
+ * Figma size properties
+ */
+interface FigmaSize {
+    width: number;
+    height: number;
+    minWidth?: number;
+    maxWidth?: number;
+    minHeight?: number;
+    maxHeight?: number;
+}
+/**
+ * Figma text properties
+ */
+interface FigmaTextStyle {
+    fontSize: number;
+    fontWeight: number;
+    textAlignHorizontal: FigmaTextAlign;
+    characters: string;
+}
 /**
  * Figma-compatible node structure
- * Based on Figma's REST API structure
+ * Based on Figma's Plugin API structure
  */
 interface FigmaNode {
     /** Unique identifier */
@@ -580,13 +664,27 @@ interface FigmaNode {
     type: FigmaNodeType;
     /** Visibility */
     visible: boolean;
-    /** Node-specific properties */
-    [key: string]: unknown;
+    /** Original Wireweave type */
+    wireweaveType?: string;
+    /** Original Wireweave attributes */
+    wireweaveAttributes?: Record<string, unknown>;
+    /** Child nodes */
+    children?: FigmaNode[];
+    /** Auto Layout properties (for FRAME) */
+    autoLayout?: FigmaAutoLayout;
+    /** Size properties */
+    size?: FigmaSize;
+    /** Text properties (for TEXT) */
+    textStyle?: FigmaTextStyle;
+    /** Background fills */
+    fills?: FigmaSolidFill[];
+    /** Border strokes */
+    strokes?: FigmaStroke[];
+    /** Stroke weight */
+    strokeWeight?: number;
+    /** Corner radius */
+    cornerRadius?: number;
 }
-/**
- * Figma node types that we can map to
- */
-type FigmaNodeType = 'DOCUMENT' | 'CANVAS' | 'FRAME' | 'GROUP' | 'TEXT' | 'RECTANGLE' | 'INSTANCE' | 'COMPONENT';
 /**
  * Figma export result
  */
@@ -642,18 +740,21 @@ declare function importFromJson(json: JsonExportResult): JsonNode[];
 
 /**
  * Figma export functionality
+ *
+ * Converts Wireweave AST to Figma Plugin API compatible format.
+ * The output can be directly used by a Figma plugin to create nodes.
  */
 
-/**
- * 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.
+ * The output is designed to be directly usable by a Figma plugin.
+ * Each node includes:
+ * - Auto Layout properties (layoutMode, padding, gap, alignment)
+ * - Size properties (width, height, constraints)
+ * - Text properties (fontSize, fontWeight, alignment)
+ * - Visual properties (fills, strokes, cornerRadius)
  *
  * @param doc - The parsed wireframe document
  * @returns Figma export result
@@ -844,4 +945,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, 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 };
+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 FigmaAutoLayout, type FigmaColor, type FigmaCounterAxisAlign, type FigmaExportResult, type FigmaLayoutMode, type FigmaNode, type FigmaNodeType, type FigmaPrimaryAxisAlign, type FigmaSize, type FigmaSizingMode, type FigmaSolidFill, type FigmaStroke, type FigmaTextAlign, type FigmaTextStyle, 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

@@ -1,5 +1,5 @@
-import { A as AnyNode, a as AccordionNode, b as AlertNode, c as AvatarNode, B as BadgeNode, d as BreadcrumbNode, e as ButtonNode, C as CardNode, f as CheckboxNode, g as ColNode, h as ContainerComponentNode, i as ContainerNode, D as DataNode, j as DisplayNode, k as DividerComponentNode, l as DrawerNode, m as DropdownNode, F as FeedbackNode, n as FooterNode, G as GridNode, H as HeaderNode, I as IconNode, o as ImageNode, p as InputComponentNode, q as InputNode, L as LayoutNode, r as LeafNode, s as LinkNode, t as ListNode, M as MainNode, u as ModalNode, N as NavNode, v as NavigationNode, w as NodeType, O as OverlayNode, P as PageNode, x as PlaceholderNode, y as PopoverNode, z as ProgressNode, R as RadioNode, E as RowNode, S as SectionNode, J as SelectNode, K as SidebarNode, Q as SliderNode, T as SpinnerNode, U as SwitchNode, V as TableNode, W as TabsNode, X as TextContentNode, Y as TextNode, Z as TextareaNode, _ as TitleNode, $ as ToastNode, a0 as TooltipNode, a1 as WireframeDocument } from './types-D0t4JRY3.js';
-export { a2 as AlertVariant, a3 as AlignValue, a4 as AppearanceProps, a5 as AvatarSize, a6 as AvatarSizeToken, a7 as BadgeSize, a8 as BadgeSizeToken, a9 as BadgeVariant, aa as BaseNode, ab as BreadcrumbItem, ac as ButtonSize, ad as ButtonSizeToken, ae as ButtonVariant, af as CommonProps, ag as DirectionValue, ah as DividerNode, ai as DrawerPosition, aj as DropdownItemNode, ak as FlexProps, al as GridProps, am as HeightValue, an as IconSize, ao as IconSizeToken, ap as InputType, aq as InteractiveProps, ar as JustifyValue, as as ListItemNode, at as NavBlockItem, au as NavChild, av as NavDivider, aw as NavGroupNode, ax as NavItem, ay as Position, az as PositionProps, aA as SelectOption, aB as ShadowValue, aC as SizeProps, aD as SourceLocation, aE as SpacingProps, aF as SpacingValue, aG as SpinnerSize, aH as SpinnerSizeToken, aI as TabNode, aJ as TextAlign, aK as TextSize, aL as TextSizeToken, aM as TextWeight, aN as TitleLevel, aO as ToastPosition, aP as TooltipPosition, aQ as ValueWithUnit, aR as WidthValue } from './types-D0t4JRY3.js';
+import { A as AnyNode, a as AccordionNode, b as AlertNode, c as AvatarNode, B as BadgeNode, d as BreadcrumbNode, e as ButtonNode, C as CardNode, f as CheckboxNode, g as ColNode, h as ContainerComponentNode, i as ContainerNode, D as DataNode, j as DisplayNode, k as DividerComponentNode, l as DrawerNode, m as DropdownNode, F as FeedbackNode, n as FooterNode, G as GridNode, H as HeaderNode, I as IconNode, o as ImageNode, p as InputComponentNode, q as InputNode, L as LayoutNode, r as LeafNode, s as LinkNode, t as ListNode, M as MainNode, u as ModalNode, N as NavNode, v as NavigationNode, w as NodeType, O as OverlayNode, P as PageNode, x as PlaceholderNode, y as PopoverNode, z as ProgressNode, R as RadioNode, E as RowNode, S as SectionNode, J as SelectNode, K as SidebarNode, Q as SliderNode, T as SpinnerNode, U as SwitchNode, V as TableNode, W as TabsNode, X as TextContentNode, Y as TextNode, Z as TextareaNode, _ as TitleNode, $ as ToastNode, a0 as TooltipNode, a1 as WireframeDocument } from './types-EbEsGNxL.js';
+export { a2 as AlertVariant, a3 as AlignValue, a4 as AnchorPosition, a5 as AnnotationItemNode, a6 as AnnotationNode, a7 as AnnotationsNode, a8 as AppearanceProps, a9 as AvatarSize, aa as AvatarSizeToken, ab as BadgeSize, ac as BadgeSizeToken, ad as BadgeVariant, ae as BaseNode, af as BreadcrumbItem, ag as ButtonSize, ah as ButtonSizeToken, ai as ButtonVariant, aj as CommonProps, ak as DirectionValue, al as DividerNode, am as DrawerPosition, an as DropdownItemNode, ao as FlexProps, ap as GridProps, aq as HeightValue, ar as IconSize, as as IconSizeToken, at as InputType, au as InteractiveProps, av as JustifyValue, aw as ListItemNode, ax as MarkerColor, ay as MarkerNode, az as NavBlockItem, aA as NavChild, aB as NavDivider, aC as NavGroupNode, aD as NavItem, aE as Position, aF as PositionProps, aG as RelativeNode, aH as SelectOption, aI as ShadowValue, aJ as SizeProps, aK as SourceLocation, aL as SpacingProps, aM as SpacingValue, aN as SpinnerSize, aO as SpinnerSizeToken, aP as StackNode, aQ as TabNode, aR as TextAlign, aS as TextSize, aT as TextSizeToken, aU as TextWeight, aV as TitleLevel, aW as ToastPosition, aX as TooltipPosition, aY as ValueWithUnit, aZ as WidthValue } from './types-EbEsGNxL.js';
 export { ExpectedToken, ParseError, ParseErrorInfo, ParseOptions, ParseResult, getErrors, isValid, parse, tryParse } from './parser.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';
 
@@ -272,7 +272,7 @@ interface AttributeSpec {
 /**
  * Component category
  */
-type ComponentCategory = 'layout' | 'grid' | 'container' | 'text' | 'input' | 'display' | 'data' | 'feedback' | 'overlay' | 'navigation';
+type ComponentCategory = 'layout' | 'grid' | 'container' | 'text' | 'input' | 'display' | 'data' | 'feedback' | 'overlay' | 'navigation' | 'annotation';
 /**
  * Component definition
  */
@@ -567,9 +567,93 @@ interface JsonExportResult {
         componentTypes: string[];
     };
 }
+/**
+ * Figma node types that we can map to
+ */
+type FigmaNodeType = 'DOCUMENT' | 'CANVAS' | 'FRAME' | 'GROUP' | 'TEXT' | 'RECTANGLE' | 'INSTANCE' | 'COMPONENT';
+/**
+ * Figma Auto Layout mode
+ */
+type FigmaLayoutMode = 'NONE' | 'HORIZONTAL' | 'VERTICAL';
+/**
+ * Figma sizing mode for Auto Layout
+ */
+type FigmaSizingMode = 'FIXED' | 'HUG' | 'FILL';
+/**
+ * Figma primary axis alignment (justify)
+ */
+type FigmaPrimaryAxisAlign = 'MIN' | 'CENTER' | 'MAX' | 'SPACE_BETWEEN';
+/**
+ * Figma counter axis alignment (align)
+ */
+type FigmaCounterAxisAlign = 'MIN' | 'CENTER' | 'MAX' | 'STRETCH' | 'BASELINE';
+/**
+ * Figma text alignment
+ */
+type FigmaTextAlign = 'LEFT' | 'CENTER' | 'RIGHT' | 'JUSTIFIED';
+/**
+ * Figma color (RGBA, 0-1 range)
+ */
+interface FigmaColor {
+    r: number;
+    g: number;
+    b: number;
+    a: number;
+}
+/**
+ * Figma solid fill
+ */
+interface FigmaSolidFill {
+    type: 'SOLID';
+    color: FigmaColor;
+    opacity?: number;
+}
+/**
+ * Figma stroke
+ */
+interface FigmaStroke {
+    type: 'SOLID';
+    color: FigmaColor;
+}
+/**
+ * Figma Auto Layout properties
+ */
+interface FigmaAutoLayout {
+    layoutMode: FigmaLayoutMode;
+    layoutSizingHorizontal: FigmaSizingMode;
+    layoutSizingVertical: FigmaSizingMode;
+    primaryAxisAlignItems: FigmaPrimaryAxisAlign;
+    counterAxisAlignItems: FigmaCounterAxisAlign;
+    paddingTop: number;
+    paddingRight: number;
+    paddingBottom: number;
+    paddingLeft: number;
+    itemSpacing: number;
+    layoutWrap?: 'NO_WRAP' | 'WRAP';
+}
+/**
+ * Figma size properties
+ */
+interface FigmaSize {
+    width: number;
+    height: number;
+    minWidth?: number;
+    maxWidth?: number;
+    minHeight?: number;
+    maxHeight?: number;
+}
+/**
+ * Figma text properties
+ */
+interface FigmaTextStyle {
+    fontSize: number;
+    fontWeight: number;
+    textAlignHorizontal: FigmaTextAlign;
+    characters: string;
+}
 /**
  * Figma-compatible node structure
- * Based on Figma's REST API structure
+ * Based on Figma's Plugin API structure
  */
 interface FigmaNode {
     /** Unique identifier */
@@ -580,13 +664,27 @@ interface FigmaNode {
     type: FigmaNodeType;
     /** Visibility */
     visible: boolean;
-    /** Node-specific properties */
-    [key: string]: unknown;
+    /** Original Wireweave type */
+    wireweaveType?: string;
+    /** Original Wireweave attributes */
+    wireweaveAttributes?: Record<string, unknown>;
+    /** Child nodes */
+    children?: FigmaNode[];
+    /** Auto Layout properties (for FRAME) */
+    autoLayout?: FigmaAutoLayout;
+    /** Size properties */
+    size?: FigmaSize;
+    /** Text properties (for TEXT) */
+    textStyle?: FigmaTextStyle;
+    /** Background fills */
+    fills?: FigmaSolidFill[];
+    /** Border strokes */
+    strokes?: FigmaStroke[];
+    /** Stroke weight */
+    strokeWeight?: number;
+    /** Corner radius */
+    cornerRadius?: number;
 }
-/**
- * Figma node types that we can map to
- */
-type FigmaNodeType = 'DOCUMENT' | 'CANVAS' | 'FRAME' | 'GROUP' | 'TEXT' | 'RECTANGLE' | 'INSTANCE' | 'COMPONENT';
 /**
  * Figma export result
  */
@@ -642,18 +740,21 @@ declare function importFromJson(json: JsonExportResult): JsonNode[];
 
 /**
  * Figma export functionality
+ *
+ * Converts Wireweave AST to Figma Plugin API compatible format.
+ * The output can be directly used by a Figma plugin to create nodes.
  */
 
-/**
- * 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.
+ * The output is designed to be directly usable by a Figma plugin.
+ * Each node includes:
+ * - Auto Layout properties (layoutMode, padding, gap, alignment)
+ * - Size properties (width, height, constraints)
+ * - Text properties (fontSize, fontWeight, alignment)
+ * - Visual properties (fills, strokes, cornerRadius)
  *
  * @param doc - The parsed wireframe document
  * @returns Figma export result
@@ -844,4 +945,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, 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 };
+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 FigmaAutoLayout, type FigmaColor, type FigmaCounterAxisAlign, type FigmaExportResult, type FigmaLayoutMode, type FigmaNode, type FigmaNodeType, type FigmaPrimaryAxisAlign, type FigmaSize, type FigmaSizingMode, type FigmaSolidFill, type FigmaStroke, type FigmaTextAlign, type FigmaTextStyle, 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 };