@wireweave/core 2.3.1 → 2.5.0-beta.0

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

@@ -169,6 +169,36 @@ interface ColNode extends BaseNode, CommonProps {
     scroll?: boolean;
     children: AnyNode[];
 }
+/**
+ * Stack - Vertical content grouping container
+ *
+ * Unlike Col which fills available space (flex: 1),
+ * Stack only takes up the space needed by its content (flex: 0 0 auto).
+ *
+ * Use cases:
+ * - Grouping form fields vertically
+ * - Card content layout
+ * - Centering content with justify/align
+ */
+interface StackNode extends BaseNode, CommonProps {
+    type: 'Stack';
+    children: AnyNode[];
+}
+/**
+ * Relative - Position children with absolute positioning
+ *
+ * Creates a position: relative container.
+ * First child is the base element, subsequent children are overlaid on top.
+ * Child elements can use `anchor` attribute to specify position:
+ * - top-left, top-center, top-right
+ * - center-left, center, center-right
+ * - bottom-left, bottom-center, bottom-right
+ */
+interface RelativeNode extends BaseNode, CommonProps {
+    type: 'Relative';
+    children: AnyNode[];
+}
+type AnchorPosition = 'top-left' | 'top-center' | 'top-right' | 'center-left' | 'center' | 'center-right' | 'bottom-left' | 'bottom-center' | 'bottom-right';
 type ShadowValue = 'none' | 'sm' | 'md' | 'lg' | 'xl';
 interface CardNode extends BaseNode, CommonProps, InteractiveProps {
     type: 'Card';
@@ -330,6 +360,8 @@ interface BadgeNode extends BaseNode, CommonProps, InteractiveProps {
     pill?: boolean;
     icon?: string;
     size?: BadgeSize;
+    /** Anchor position when inside an overlay container */
+    anchor?: AnchorPosition;
 }
 type IconSizeToken = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
 type IconSize = IconSizeToken | number | ValueWithUnit;
@@ -474,8 +506,75 @@ 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;
+type GridNode = RowNode | ColNode | StackNode | RelativeNode;
 type ContainerComponentNode = CardNode | ModalNode | DrawerNode | AccordionNode;
 type TextContentNode = TextNode | TitleNode | LinkNode;
 type InputComponentNode = InputNode | TextareaNode | SelectNode | CheckboxNode | RadioNode | SwitchNode | SliderNode;
@@ -484,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' | '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, AppearanceProps as a4, AvatarSize as a5, AvatarSizeToken as a6, BadgeSize as a7, BadgeSizeToken as a8, BadgeVariant as a9, SelectOption as aA, ShadowValue as aB, SizeProps as aC, SourceLocation as aD, SpacingProps as aE, SpacingValue as aF, SpinnerSize as aG, SpinnerSizeToken as aH, TabNode as aI, TextAlign as aJ, TextSize as aK, TextSizeToken as aL, TextWeight as aM, TitleLevel as aN, ToastPosition as aO, TooltipPosition as aP, ValueWithUnit as aQ, WidthValue as aR, BaseNode as aa, BreadcrumbItem as ab, ButtonSize as ac, ButtonSizeToken as ad, ButtonVariant as ae, CommonProps as af, DirectionValue as ag, DividerNode as ah, DrawerPosition as ai, DropdownItemNode as aj, FlexProps as ak, GridProps as al, HeightValue as am, IconSize as an, IconSizeToken as ao, InputType as ap, InteractiveProps as aq, JustifyValue as ar, ListItemNode as as, NavBlockItem as at, NavChild as au, NavDivider as av, NavGroupNode as aw, NavItem as ax, Position as ay, PositionProps 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.3.1",
+  "version": "2.5.0-beta.0",
   "description": "Core parser and renderer for wireweave",
   "type": "module",
   "main": "dist/index.js",