@wireweave/core 1.0.0-beta.20260107130839 → 1.0.0-beta.20260107132939

package/src/ast/types.ts

@@ -1,661 +0,0 @@
-/**
- * AST Type definitions for wireweave
- *
- * Comprehensive type definitions for all AST nodes
- */
-
-// ===========================================
-// Source Location
-// ===========================================
-
-export interface Position {
-  line: number;
-  column: number;
-  offset: number;
-}
-
-export interface SourceLocation {
-  start: Position;
-  end: Position;
-}
-
-// ===========================================
-// Base Node
-// ===========================================
-
-export interface BaseNode {
-  type: string;
-  loc?: SourceLocation;
-}
-
-// ===========================================
-// Common Props
-// ===========================================
-
-/**
- * Value with CSS unit (e.g., 16px, 100%, 2em)
- * Used when explicit unit is specified in DSL
- */
-export interface ValueWithUnit {
-  value: number;
-  unit: 'px' | '%' | 'em' | 'rem' | 'vh' | 'vw';
-}
-
-/**
- * Spacing value:
- * - number: spacing token (0=0px, 1=4px, 2=8px, 4=16px, 6=24px, 8=32px, etc.)
- * - ValueWithUnit: direct CSS value (e.g., { value: 16, unit: 'px' })
- */
-export type SpacingValue = number | ValueWithUnit;
-
-export interface SpacingProps {
-  p?: SpacingValue;
-  px?: SpacingValue;
-  py?: SpacingValue;
-  pt?: SpacingValue;
-  pr?: SpacingValue;
-  pb?: SpacingValue;
-  pl?: SpacingValue;
-  m?: SpacingValue;
-  mx?: SpacingValue | 'auto';
-  my?: SpacingValue;
-  mt?: SpacingValue;
-  mr?: SpacingValue;
-  mb?: SpacingValue;
-  ml?: SpacingValue;
-}
-
-/**
- * Width/Height value:
- * - number: size token or direct px
- * - ValueWithUnit: direct CSS value with unit
- * - string keywords: 'full', 'auto', 'screen', 'fit'
- */
-export type WidthValue = number | ValueWithUnit | 'full' | 'auto' | 'screen' | 'fit';
-export type HeightValue = number | ValueWithUnit | 'full' | 'auto' | 'screen';
-
-export interface SizeProps {
-  w?: WidthValue;
-  h?: HeightValue;
-  minW?: number | ValueWithUnit;
-  maxW?: number | ValueWithUnit;
-  minH?: number | ValueWithUnit;
-  maxH?: number | ValueWithUnit;
-}
-
-export type JustifyValue = 'start' | 'center' | 'end' | 'between' | 'around' | 'evenly';
-export type AlignValue = 'start' | 'center' | 'end' | 'stretch' | 'baseline';
-export type DirectionValue = 'row' | 'column' | 'row-reverse' | 'column-reverse';
-
-export interface FlexProps {
-  flex?: boolean | number;
-  direction?: DirectionValue;
-  justify?: JustifyValue;
-  align?: AlignValue;
-  wrap?: boolean | 'nowrap';
-  gap?: SpacingValue;
-}
-
-export interface GridProps {
-  span?: number;
-}
-
-export interface CommonProps extends SpacingProps, SizeProps, FlexProps, GridProps {}
-
-// ===========================================
-// Document Node
-// ===========================================
-
-export interface WireframeDocument extends BaseNode {
-  type: 'Document';
-  children: PageNode[];
-}
-
-// ===========================================
-// Layout Nodes
-// ===========================================
-
-export interface PageNode extends BaseNode, CommonProps {
-  type: 'Page';
-  title?: string | null;
-  /** Center content both horizontally and vertically */
-  centered?: boolean;
-  /** Viewport size (e.g., "1440x900", "1440", or number for width only) */
-  viewport?: string | number;
-  /** Device preset (e.g., "iphone14", "desktop") */
-  device?: string;
-  children: AnyNode[];
-}
-
-export interface HeaderNode extends BaseNode, CommonProps {
-  type: 'Header';
-  border?: boolean;
-  children: AnyNode[];
-}
-
-export interface MainNode extends BaseNode, CommonProps {
-  type: 'Main';
-  children: AnyNode[];
-}
-
-export interface FooterNode extends BaseNode, CommonProps {
-  type: 'Footer';
-  border?: boolean;
-  children: AnyNode[];
-}
-
-export interface SidebarNode extends BaseNode, CommonProps {
-  type: 'Sidebar';
-  position?: 'left' | 'right';
-  children: AnyNode[];
-}
-
-export interface SectionNode extends BaseNode, CommonProps {
-  type: 'Section';
-  title?: string | null;
-  expanded?: boolean;
-  children: AnyNode[];
-}
-
-// ===========================================
-// Grid Nodes
-// ===========================================
-
-export interface RowNode extends BaseNode, CommonProps {
-  type: 'Row';
-  children: AnyNode[];
-}
-
-export interface ColNode extends BaseNode, CommonProps {
-  type: 'Col';
-  /** Responsive breakpoint spans (sm: 576px+, md: 768px+, lg: 992px+, xl: 1200px+) */
-  sm?: number;
-  md?: number;
-  lg?: number;
-  xl?: number;
-  /** Column order in flex container */
-  order?: number;
-  children: AnyNode[];
-}
-
-// ===========================================
-// Container Nodes
-// ===========================================
-
-export type ShadowValue = 'none' | 'sm' | 'md' | 'lg' | 'xl';
-
-export interface CardNode extends BaseNode, CommonProps {
-  type: 'Card';
-  title?: string | null;
-  shadow?: ShadowValue;
-  border?: boolean;
-  children: AnyNode[];
-}
-
-export interface ModalNode extends BaseNode, CommonProps {
-  type: 'Modal';
-  title?: string | null;
-  children: AnyNode[];
-}
-
-export type DrawerPosition = 'left' | 'right' | 'top' | 'bottom';
-
-export interface DrawerNode extends BaseNode, CommonProps {
-  type: 'Drawer';
-  title?: string | null;
-  position?: DrawerPosition;
-  children: AnyNode[];
-}
-
-export interface AccordionNode extends BaseNode, CommonProps {
-  type: 'Accordion';
-  title?: string | null;
-  children: AnyNode[];
-}
-
-// ===========================================
-// Text Nodes
-// ===========================================
-
-export type TextSizeToken = 'xs' | 'sm' | 'base' | 'md' | 'lg' | 'xl' | '2xl' | '3xl';
-export type TextSize = TextSizeToken | ValueWithUnit;
-export type TextWeight = 'normal' | 'medium' | 'semibold' | 'bold';
-export type TextAlign = 'left' | 'center' | 'right' | 'justify';
-
-export interface TextNode extends BaseNode, Omit<CommonProps, 'align'> {
-  type: 'Text';
-  content: string;
-  size?: TextSize;
-  weight?: TextWeight;
-  align?: TextAlign;
-  muted?: boolean;
-}
-
-export type TitleLevel = 1 | 2 | 3 | 4 | 5 | 6;
-
-export interface TitleNode extends BaseNode, Omit<CommonProps, 'align'> {
-  type: 'Title';
-  content: string;
-  level?: TitleLevel;
-  size?: TextSize;
-  align?: TextAlign;
-}
-
-export interface LinkNode extends BaseNode, CommonProps {
-  type: 'Link';
-  content: string;
-  href?: string;
-  external?: boolean;
-}
-
-// ===========================================
-// Input Nodes
-// ===========================================
-
-export type InputType = 'text' | 'email' | 'password' | 'number' | 'tel' | 'url' | 'search' | 'date';
-
-export interface InputNode extends BaseNode, CommonProps {
-  type: 'Input';
-  label?: string | null;
-  inputType?: InputType;
-  placeholder?: string;
-  value?: string;
-  disabled?: boolean;
-  required?: boolean;
-  readonly?: boolean;
-  icon?: string;
-}
-
-export interface TextareaNode extends BaseNode, CommonProps {
-  type: 'Textarea';
-  label?: string | null;
-  placeholder?: string;
-  value?: string;
-  rows?: number;
-  disabled?: boolean;
-  required?: boolean;
-}
-
-export interface SelectNode extends BaseNode, CommonProps {
-  type: 'Select';
-  label?: string | null;
-  options: (string | SelectOption)[];
-  value?: string;
-  placeholder?: string;
-  disabled?: boolean;
-  required?: boolean;
-}
-
-export interface SelectOption {
-  label: string;
-  value: string;
-}
-
-export interface CheckboxNode extends BaseNode, CommonProps {
-  type: 'Checkbox';
-  label?: string | null;
-  checked?: boolean;
-  disabled?: boolean;
-}
-
-export interface RadioNode extends BaseNode, CommonProps {
-  type: 'Radio';
-  label?: string | null;
-  name?: string;
-  checked?: boolean;
-  disabled?: boolean;
-}
-
-export interface SwitchNode extends BaseNode, CommonProps {
-  type: 'Switch';
-  label?: string | null;
-  checked?: boolean;
-  disabled?: boolean;
-}
-
-export interface SliderNode extends BaseNode, CommonProps {
-  type: 'Slider';
-  label?: string | null;
-  min?: number;
-  max?: number;
-  value?: number;
-  step?: number;
-  disabled?: boolean;
-}
-
-// ===========================================
-// Button Node
-// ===========================================
-
-export type ButtonVariant = 'primary' | 'secondary' | 'outline' | 'ghost' | 'danger';
-export type ButtonSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
-
-export interface ButtonNode extends BaseNode, CommonProps {
-  type: 'Button';
-  content: string;
-  primary?: boolean;
-  secondary?: boolean;
-  outline?: boolean;
-  ghost?: boolean;
-  danger?: boolean;
-  size?: ButtonSize;
-  icon?: string;
-  disabled?: boolean;
-  loading?: boolean;
-}
-
-// ===========================================
-// Display Nodes
-// ===========================================
-
-export interface ImageNode extends BaseNode, CommonProps {
-  type: 'Image';
-  src?: string | null;
-  alt?: string;
-}
-
-export interface PlaceholderNode extends BaseNode, CommonProps {
-  type: 'Placeholder';
-  label?: string | null;
-}
-
-export type AvatarSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
-
-export interface AvatarNode extends BaseNode, CommonProps {
-  type: 'Avatar';
-  name?: string | null;
-  src?: boolean;
-  size?: AvatarSize | number;  // Token string or custom px number
-}
-
-export type BadgeVariant = 'default' | 'primary' | 'secondary' | 'success' | 'warning' | 'danger' | 'info';
-
-export type BadgeSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
-
-export interface BadgeNode extends BaseNode, CommonProps {
-  type: 'Badge';
-  content: string;
-  variant?: BadgeVariant;
-  pill?: boolean;
-  icon?: string;
-  size?: BadgeSize;
-}
-
-export type IconSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
-
-export interface IconNode extends BaseNode, CommonProps {
-  type: 'Icon';
-  name: string;
-  size?: IconSize | number;  // Token string or custom px number
-  muted?: boolean;
-}
-
-// ===========================================
-// Data Nodes
-// ===========================================
-
-export interface TableNode extends BaseNode, CommonProps {
-  type: 'Table';
-  columns: string[];
-  rows: (string | AnyNode)[][];
-  striped?: boolean;
-  bordered?: boolean;
-  hover?: boolean;
-}
-
-export interface ListItemNode {
-  content: string;
-  icon?: string;
-  children?: ListItemNode[];
-}
-
-export interface ListNode extends BaseNode, CommonProps {
-  type: 'List';
-  items: (string | ListItemNode)[];
-  ordered?: boolean;
-  none?: boolean;
-}
-
-// ===========================================
-// Feedback Nodes
-// ===========================================
-
-export type AlertVariant = 'success' | 'warning' | 'danger' | 'info';
-
-export interface AlertNode extends BaseNode, CommonProps {
-  type: 'Alert';
-  content: string;
-  variant?: AlertVariant;
-  dismissible?: boolean;
-  icon?: string;
-}
-
-export type ToastPosition =
-  | 'top-left'
-  | 'top-center'
-  | 'top-right'
-  | 'bottom-left'
-  | 'bottom-center'
-  | 'bottom-right';
-
-export interface ToastNode extends BaseNode, CommonProps {
-  type: 'Toast';
-  content: string;
-  position?: ToastPosition;
-  variant?: AlertVariant;
-}
-
-export interface ProgressNode extends BaseNode, CommonProps {
-  type: 'Progress';
-  value?: number;
-  max?: number;
-  label?: string;
-  indeterminate?: boolean;
-}
-
-export type SpinnerSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
-
-export interface SpinnerNode extends BaseNode, CommonProps {
-  type: 'Spinner';
-  label?: string | null;
-  size?: SpinnerSize | number;  // Token string or custom px number
-}
-
-// ===========================================
-// Overlay Nodes
-// ===========================================
-
-export type TooltipPosition = 'top' | 'right' | 'bottom' | 'left';
-
-export interface TooltipNode extends BaseNode, CommonProps {
-  type: 'Tooltip';
-  content: string;
-  position?: TooltipPosition;
-  children: AnyNode[];
-}
-
-export interface PopoverNode extends BaseNode, CommonProps {
-  type: 'Popover';
-  title?: string | null;
-  children: AnyNode[];
-}
-
-export interface DropdownItemNode {
-  label: string;
-  icon?: string;
-  danger?: boolean;
-  disabled?: boolean;
-}
-
-export interface DividerNode {
-  type: 'divider';
-}
-
-export interface DropdownNode extends BaseNode, CommonProps {
-  type: 'Dropdown';
-  items: (DropdownItemNode | DividerNode)[];
-}
-
-// ===========================================
-// Navigation Nodes
-// ===========================================
-
-export interface NavItem {
-  label: string;
-  icon?: string;
-  href?: string;
-  active?: boolean;
-  disabled?: boolean;
-}
-
-export interface NavNode extends BaseNode, CommonProps {
-  type: 'Nav';
-  items: (string | NavItem)[];
-  vertical?: boolean;
-}
-
-export interface TabNode {
-  label: string;
-  active?: boolean;
-  disabled?: boolean;
-  children: AnyNode[];
-}
-
-export interface TabsNode extends BaseNode, CommonProps {
-  type: 'Tabs';
-  items: string[];
-  active?: number;
-  children: TabNode[];
-}
-
-export interface BreadcrumbItem {
-  label: string;
-  href?: string;
-}
-
-export interface BreadcrumbNode extends BaseNode, CommonProps {
-  type: 'Breadcrumb';
-  items: (string | BreadcrumbItem)[];
-}
-
-// ===========================================
-// Divider Node
-// ===========================================
-
-export interface DividerComponentNode extends BaseNode, CommonProps {
-  type: 'Divider';
-}
-
-// ===========================================
-// Node Type Unions
-// ===========================================
-
-export type LayoutNode =
-  | PageNode
-  | HeaderNode
-  | MainNode
-  | FooterNode
-  | SidebarNode
-  | SectionNode;
-
-export type GridNode = RowNode | ColNode;
-
-export type ContainerComponentNode =
-  | CardNode
-  | ModalNode
-  | DrawerNode
-  | AccordionNode;
-
-export type TextContentNode = TextNode | TitleNode | LinkNode;
-
-export type InputComponentNode =
-  | InputNode
-  | TextareaNode
-  | SelectNode
-  | CheckboxNode
-  | RadioNode
-  | SwitchNode
-  | SliderNode;
-
-export type DisplayNode =
-  | ImageNode
-  | PlaceholderNode
-  | AvatarNode
-  | BadgeNode
-  | IconNode;
-
-export type DataNode = TableNode | ListNode;
-
-export type FeedbackNode =
-  | AlertNode
-  | ToastNode
-  | ProgressNode
-  | SpinnerNode;
-
-export type OverlayNode = TooltipNode | PopoverNode | DropdownNode;
-
-export type NavigationNode = NavNode | TabsNode | BreadcrumbNode;
-
-export type ContainerNode =
-  | LayoutNode
-  | GridNode
-  | ContainerComponentNode
-  | PopoverNode
-  | TooltipNode;
-
-export type LeafNode =
-  | TextContentNode
-  | InputComponentNode
-  | ButtonNode
-  | DisplayNode
-  | DataNode
-  | FeedbackNode
-  | DropdownNode
-  | NavigationNode
-  | DividerComponentNode;
-
-export type AnyNode = ContainerNode | LeafNode;
-
-export 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';