@wireweave/core 2.4.0 → 2.5.0

package/dist/{types-D_1QkAXo.d.ts → types-EbEsGNxL.d.ts}

@@ -506,6 +506,73 @@ interface BreadcrumbNode extends BaseNode, CommonProps {
 interface DividerComponentNode extends BaseNode, CommonProps {
     type: 'Divider';
 }
+type MarkerColor = 'blue' | 'red' | 'green' | 'yellow' | 'purple' | 'orange';
+/**
+ * Marker - Number marker for referencing in annotations
+ *
+ * Displays a numbered circle that can be placed on UI elements.
+ * Recommended to use inside `relative` with `anchor` for positioning outside the UI.
+ *
+ * Example:
+ * ```wireframe
+ * relative {
+ *   button "Submit"
+ *   marker 1 anchor=top-right
+ * }
+ * ```
+ */
+interface MarkerNode extends BaseNode, CommonProps {
+    type: 'Marker';
+    /** The marker number (1, 2, 3, ...) */
+    number: number;
+    /** Marker color */
+    color?: MarkerColor;
+    /** Anchor position when inside a relative container */
+    anchor?: AnchorPosition;
+}
+/**
+ * Annotations - Documentation panel for screen specifications
+ *
+ * Container for annotation items that describe UI elements.
+ * Visually distinct from wireframe UI with dashed border and different background.
+ * Rendered with data-role="documentation" for LLM recognition.
+ *
+ * Example:
+ * ```wireframe
+ * annotations title="화면 설명" {
+ *   item 1 "이메일 입력" { text "유효성 검사 적용" }
+ *   item 2 "로그인 버튼" { text "OAuth 연동" }
+ * }
+ * ```
+ */
+interface AnnotationsNode extends BaseNode, CommonProps {
+    type: 'Annotations';
+    /** Panel title (default: "화면 설명" or "Annotations") */
+    title?: string;
+    children: AnnotationItemNode[];
+}
+/**
+ * AnnotationItem - Individual annotation entry
+ *
+ * Represents a single annotation with a marker number, title, and description content.
+ *
+ * Example:
+ * ```wireframe
+ * item 1 "이메일 입력" {
+ *   text "- 유효성 검사 적용"
+ *   text "- 최대 255자"
+ * }
+ * ```
+ */
+interface AnnotationItemNode extends BaseNode {
+    type: 'AnnotationItem';
+    /** The marker number this item references */
+    number: number;
+    /** Item title */
+    title: string;
+    /** Description content (Text nodes) */
+    children: AnyNode[];
+}
 type LayoutNode = PageNode | HeaderNode | MainNode | FooterNode | SidebarNode | SectionNode;
 type GridNode = RowNode | ColNode | StackNode | RelativeNode;
 type ContainerComponentNode = CardNode | ModalNode | DrawerNode | AccordionNode;
@@ -516,9 +583,10 @@ type DataNode = TableNode | ListNode;
 type FeedbackNode = AlertNode | ToastNode | ProgressNode | SpinnerNode;
 type OverlayNode = TooltipNode | PopoverNode | DropdownNode;
 type NavigationNode = NavNode | TabsNode | BreadcrumbNode;
-type ContainerNode = LayoutNode | GridNode | ContainerComponentNode | PopoverNode | TooltipNode;
-type LeafNode = TextContentNode | InputComponentNode | ButtonNode | DisplayNode | DataNode | FeedbackNode | DropdownNode | NavigationNode | DividerComponentNode;
+type AnnotationNode = MarkerNode | AnnotationsNode | AnnotationItemNode;
+type ContainerNode = LayoutNode | GridNode | ContainerComponentNode | PopoverNode | TooltipNode | AnnotationsNode | AnnotationItemNode;
+type LeafNode = TextContentNode | InputComponentNode | ButtonNode | DisplayNode | DataNode | FeedbackNode | DropdownNode | NavigationNode | DividerComponentNode | MarkerNode;
 type AnyNode = ContainerNode | LeafNode;
-type NodeType = 'Document' | 'Page' | 'Header' | 'Main' | 'Footer' | 'Sidebar' | 'Section' | 'Row' | 'Col' | 'Stack' | 'Relative' | 'Card' | 'Modal' | 'Drawer' | 'Accordion' | 'Text' | 'Title' | 'Link' | 'Input' | 'Textarea' | 'Select' | 'Checkbox' | 'Radio' | 'Switch' | 'Slider' | 'Button' | 'Image' | 'Placeholder' | 'Avatar' | 'Badge' | 'Icon' | 'Table' | 'List' | 'Alert' | 'Toast' | 'Progress' | 'Spinner' | 'Tooltip' | 'Popover' | 'Dropdown' | 'Nav' | 'Tabs' | 'Breadcrumb' | 'Divider';
+type NodeType = 'Document' | 'Page' | 'Header' | 'Main' | 'Footer' | 'Sidebar' | 'Section' | 'Row' | 'Col' | 'Stack' | 'Relative' | 'Card' | 'Modal' | 'Drawer' | 'Accordion' | 'Text' | 'Title' | 'Link' | 'Input' | 'Textarea' | 'Select' | 'Checkbox' | 'Radio' | 'Switch' | 'Slider' | 'Button' | 'Image' | 'Placeholder' | 'Avatar' | 'Badge' | 'Icon' | 'Table' | 'List' | 'Alert' | 'Toast' | 'Progress' | 'Spinner' | 'Tooltip' | 'Popover' | 'Dropdown' | 'Nav' | 'Tabs' | 'Breadcrumb' | 'Divider' | 'Marker' | 'Annotations' | 'AnnotationItem';
 
-export type { ToastNode as $, AnyNode as A, BadgeNode as B, CardNode as C, DataNode as D, RowNode as E, FeedbackNode as F, GridNode as G, HeaderNode as H, IconNode as I, SelectNode as J, SidebarNode as K, LayoutNode as L, MainNode as M, NavNode as N, OverlayNode as O, PageNode as P, SliderNode as Q, RadioNode as R, SectionNode as S, SpinnerNode as T, SwitchNode as U, TableNode as V, TabsNode as W, TextContentNode as X, TextNode as Y, TextareaNode as Z, TitleNode as _, AccordionNode as a, TooltipNode as a0, WireframeDocument as a1, AlertVariant as a2, AlignValue as a3, AnchorPosition as a4, AppearanceProps as a5, AvatarSize as a6, AvatarSizeToken as a7, BadgeSize as a8, BadgeSizeToken as a9, PositionProps as aA, RelativeNode as aB, SelectOption as aC, ShadowValue as aD, SizeProps as aE, SourceLocation as aF, SpacingProps as aG, SpacingValue as aH, SpinnerSize as aI, SpinnerSizeToken as aJ, StackNode as aK, TabNode as aL, TextAlign as aM, TextSize as aN, TextSizeToken as aO, TextWeight as aP, TitleLevel as aQ, ToastPosition as aR, TooltipPosition as aS, ValueWithUnit as aT, WidthValue as aU, BadgeVariant as aa, BaseNode as ab, BreadcrumbItem as ac, ButtonSize as ad, ButtonSizeToken as ae, ButtonVariant as af, CommonProps as ag, DirectionValue as ah, DividerNode as ai, DrawerPosition as aj, DropdownItemNode as ak, FlexProps as al, GridProps as am, HeightValue as an, IconSize as ao, IconSizeToken as ap, InputType as aq, InteractiveProps as ar, JustifyValue as as, ListItemNode as at, NavBlockItem as au, NavChild as av, NavDivider as aw, NavGroupNode as ax, NavItem as ay, Position as az, AlertNode as b, AvatarNode as c, BreadcrumbNode as d, ButtonNode as e, CheckboxNode as f, ColNode as g, ContainerComponentNode as h, ContainerNode as i, DisplayNode as j, DividerComponentNode as k, DrawerNode as l, DropdownNode as m, FooterNode as n, ImageNode as o, InputComponentNode as p, InputNode as q, LeafNode as r, LinkNode as s, ListNode as t, ModalNode as u, NavigationNode as v, NodeType as w, PlaceholderNode as x, PopoverNode as y, ProgressNode as z };
+export type { ToastNode as $, AnyNode as A, BadgeNode as B, CardNode as C, DataNode as D, RowNode as E, FeedbackNode as F, GridNode as G, HeaderNode as H, IconNode as I, SelectNode as J, SidebarNode as K, LayoutNode as L, MainNode as M, NavNode as N, OverlayNode as O, PageNode as P, SliderNode as Q, RadioNode as R, SectionNode as S, SpinnerNode as T, SwitchNode as U, TableNode as V, TabsNode as W, TextContentNode as X, TextNode as Y, TextareaNode as Z, TitleNode as _, AccordionNode as a, TooltipNode as a0, WireframeDocument as a1, AlertVariant as a2, AlignValue as a3, AnchorPosition as a4, AnnotationItemNode as a5, AnnotationNode as a6, AnnotationsNode as a7, AppearanceProps as a8, AvatarSize as a9, NavChild as aA, NavDivider as aB, NavGroupNode as aC, NavItem as aD, Position as aE, PositionProps as aF, RelativeNode as aG, SelectOption as aH, ShadowValue as aI, SizeProps as aJ, SourceLocation as aK, SpacingProps as aL, SpacingValue as aM, SpinnerSize as aN, SpinnerSizeToken as aO, StackNode as aP, TabNode as aQ, TextAlign as aR, TextSize as aS, TextSizeToken as aT, TextWeight as aU, TitleLevel as aV, ToastPosition as aW, TooltipPosition as aX, ValueWithUnit as aY, WidthValue as aZ, AvatarSizeToken as aa, BadgeSize as ab, BadgeSizeToken as ac, BadgeVariant as ad, BaseNode as ae, BreadcrumbItem as af, ButtonSize as ag, ButtonSizeToken as ah, ButtonVariant as ai, CommonProps as aj, DirectionValue as ak, DividerNode as al, DrawerPosition as am, DropdownItemNode as an, FlexProps as ao, GridProps as ap, HeightValue as aq, IconSize as ar, IconSizeToken as as, InputType as at, InteractiveProps as au, JustifyValue as av, ListItemNode as aw, MarkerColor as ax, MarkerNode as ay, NavBlockItem as az, AlertNode as b, AvatarNode as c, BreadcrumbNode as d, ButtonNode as e, CheckboxNode as f, ColNode as g, ContainerComponentNode as h, ContainerNode as i, DisplayNode as j, DividerComponentNode as k, DrawerNode as l, DropdownNode as m, FooterNode as n, ImageNode as o, InputComponentNode as p, InputNode as q, LeafNode as r, LinkNode as s, ListNode as t, ModalNode as u, NavigationNode as v, NodeType as w, PlaceholderNode as x, PopoverNode as y, ProgressNode as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wireweave/core",
-  "version": "2.4.0",
+  "version": "2.5.0",
   "description": "Core parser and renderer for wireweave",
   "type": "module",
   "main": "dist/index.js",