@diagrammo/dgmo 0.8.3 → 0.8.5

package/docs/language-reference.md

@@ -28,6 +28,11 @@ Syntax changes introduced in the consistency cleanup. Old forms now produce erro
 | `show-sub-node-count: yes` | `show-sub-node-count` (flag) | Org |
 | `import: path` | `import path` | Org |
 | `tags: path` | `tags path` | Org |
+| `xlabel` | `x-label` | Data charts, function |
+| `ylabel` | `y-label` | Data charts, function |
+| `sizelabel` | `size-label` | Scatter/bubble |
+| `x-axis` | `x-label` | Quadrant |
+| `y-axis` | `y-label` | Quadrant |
 
 ---
 
@@ -420,7 +425,7 @@ Bracket syntax only.
 
 ### 4.6 Options
 
-- `direction-tb` (boolean; default is LR)
+- `direction-lr` (boolean; default is TB)
 - `orientation-vertical` (boolean; default is horizontal)
 
 ---
@@ -1018,8 +1023,8 @@ Commas between values are optional. Thousands commas are supported (`3,984,078.6
 **Options (space-separated, NO colon):**
 ```
 title My Chart
-xlabel X Label
-ylabel Y Label
+x-label X Label
+y-label Y Label
 orientation-horizontal
 stacked
 ```
@@ -1056,9 +1061,9 @@ Commas between values are optional. Thousands commas supported.
 
 **Options:**
 ```
-xlabel Weight
-ylabel Height
-sizelabel Crew
+x-label Weight
+y-label Height
+size-label Crew
 no-labels
 ```
 
@@ -1084,8 +1089,8 @@ Commas between values are optional. Thousands commas supported.
 
 ```
 function Trajectories
-xlabel Distance
-ylabel Height
+x-label Distance
+y-label Height
 x 0 to 250
 
 15 degrees(blue): -0.001*x^2 + 0.27*x
@@ -1138,20 +1143,27 @@ Thousands commas supported.
 
 ## 16. Visualizations
 
-### 16.1 Slope Charts (Colon REQUIRED for data)
+### 16.1 Slope Charts
 
 ```
 slope Fleet Strength
 
-1715 1725
+period 1715 1725
 
-Blackbeard: 40 4
-Roberts: 12 52
+Blackbeard 40 4
+Roberts 12 52
 ```
 
-- Period labels on their own line, commas optional
-- Data rows: `Label: value1 value2` — colon required, commas between values optional
-- Thousands commas supported in values
+- Period directive required: `period Label1 Label2` (one-line) or indented block for multi-token labels:
+  ```
+  period
+    Before COVID
+    After COVID
+  ```
+- Data rows: `Label value1 value2` — space-separated, no colons, no commas between values
+- Thousands commas within values supported (e.g., `1,000`)
+- Color annotations: `Label (color) value1 value2`
+- Minimum 2 periods required
 
 ### 16.2 Wordcloud
 
@@ -1168,19 +1180,19 @@ navigation 88
 - Data: space-separated only (`word value`)
 - Options: `rotate none|mixed|angled`, `max N`, `size min max`
 
-### 16.3 Arc Diagrams (Colon Before Weight)
+### 16.3 Arc Diagrams
 
 ```
 arc Pirate Alliances
 
 [Caribbean](red)
-  Blackbeard -> Bonnet: 8
-  Blackbeard -> Vane: 5
+  Blackbeard -> Bonnet 8
+  Blackbeard -> Vane 5
 
 order group
 ```
 
-- Link: `Source -> Target: weight` — colon before optional weight
+- Link: `Source -> Target weight` — space before optional weight
 - Options: `order appearance|name|group|degree`
 
 ### 16.4 Venn Diagrams
@@ -1199,25 +1211,25 @@ sw + nav + lead Legendary Pirates
 - Set declaration: `Name(color) alias X`
 - Intersections: `Set1 + Set2 Label` — label follows the last set reference (no colon)
 
-### 16.5 Quadrant Diagrams (Colon REQUIRED)
+### 16.5 Quadrant Diagrams
 
 ```
 quadrant Crew Assessment
-x-axis: Low Skill, High Skill
-y-axis: Low Loyalty, High Loyalty
+x-label Low Skill, High Skill
+y-label Low Loyalty, High Loyalty
 
-top-right: Promote (green)
-top-left: Train (yellow)
-bottom-left: Maroon (red)
-bottom-right: Watch Closely (purple)
+top-right Promote (green)
+top-left Train (yellow)
+bottom-left Maroon (red)
+bottom-right Watch Closely (purple)
 
-Quartermaster: 0.9 0.95
-Navigator: 0.85 0.8
+Quartermaster 0.9, 0.95
+Navigator 0.85, 0.8
 ```
 
-- Axis labels: `x-axis: Low, High` — colon required
-- Position labels: `top-right: Label` — colon required
-- Data points: `Label: x y` — colon required, commas between values optional
+- Axis labels: `x-label Low, High` — space-separated
+- Position labels: `top-right Label` — space-separated
+- Data points: `Label x, y` — space-separated, comma between coordinates
 - Thousands commas supported in values
 
 ---
@@ -1234,11 +1246,6 @@ Navigator: 0.85 0.8
 | Class field types | class | `+ name: string` |
 | Class method returns | class | `+ sail(): void` |
 | Function expressions | function | `f(x): x^2 + 1` |
-| Slope data rows | slope | `Blackbeard: 40 4` |
-| Quadrant axes | quadrant | `x-axis: Low, High` |
-| Quadrant positions | quadrant | `top-right: Promote` |
-| Quadrant data points | quadrant | `Quartermaster: 0.9 0.8` |
-| Arc link weight | arc | `Source -> Target: 8` |
 | Hide tag values | initiative-status | `hide phase:Planning` |
 
 ### Colons OPTIONAL
@@ -1264,13 +1271,15 @@ Navigator: 0.85 0.8
 | Section dividers | sequence | `== Phase ==` |
 | Comments | all | `// comment` |
 | Wordcloud data | wordcloud | `swordsmanship 95` |
+| Slope data rows | slope | `Blackbeard 40 4` |
+| Slope period directive | slope | `period 1715 1725` |
 | Venn intersections | venn | `sw + nav Sea Raiders` |
 
 ### The Rule
 
 **Colons appear in two contexts:**
 1. **Value assignment** — `key: value` in pipe metadata, indented tag/metadata assignment (org, c4), and hide directives
-2. **Type/expression separation** — where labels can contain spaces and a delimiter is needed (function expressions, slope data, quadrant data, arc weights, class members)
+2. **Type/expression separation** — where labels can contain spaces and a delimiter is needed (function expressions, class members)
 
 **Exception**: Known-schema properties (infra node properties, ER columns) remain space-separated even though they are indented. The colon rule applies to open-ended metadata, not fixed property schemas.
 

package/gallery/fixtures/arc.dgmo

@@ -0,0 +1,18 @@
+arc Microservice Dependencies
+order group
+
+[Frontend]
+  WebApp -> API Gateway 5
+  MobileApp -> API Gateway 3
+
+[Core Services]
+  API Gateway -> AuthService 4
+  API Gateway -> UserService 5
+  API Gateway -> OrderService 3
+  UserService -> Database 4
+  OrderService -> Database 3
+  OrderService -> PaymentService 2
+
+[External]
+  PaymentService -> Stripe 2
+  AuthService -> OAuth 3

package/gallery/fixtures/area.dgmo

@@ -0,0 +1,19 @@
+area Memory Usage Over Time
+x-label Hour
+y-label GB
+
+era 12am -> 9am Night (blue)
+era 9am -> 6pm Day (green)
+era 6pm -> 11pm Evening (purple)
+
+12am 2.1
+3am 1.8
+6am 2.4
+9am 5.7
+10am 6.3
+12pm 7.1
+2pm 6.8
+4pm 5.9
+6pm 4.2
+9pm 3.1
+11pm 2.5

package/gallery/fixtures/bar-stacked.dgmo

@@ -0,0 +1,10 @@
+bar-stacked Support Tickets by Priority
+x-label Month
+y-label Tickets
+
+series Critical (red), High (orange), Medium (yellow), Low (green), Info (blue)
+January 8, 24, 45, 62, 31
+February 12, 19, 51, 58, 28
+March 6, 22, 38, 71, 35
+April 10, 28, 42, 65, 40
+May 5, 15, 48, 70, 33

package/gallery/fixtures/bar.dgmo

@@ -0,0 +1,10 @@
+bar Monthly Revenue by Product Line
+x-label Product
+y-label Revenue ($K)
+
+Enterprise 245
+Professional 182
+Starter 97
+Free Trial 43
+Add-ons 61
+Consulting 128

package/gallery/fixtures/c4-full.dgmo

@@ -0,0 +1,52 @@
+c4 Online Bookstore — C4 Architecture
+
+tag Technology alias tech
+  React(blue)
+  Node(green)
+  Python(orange)
+  PostgreSQL(purple)
+
+tag Team alias t
+  Frontend(blue)
+  Backend(green)
+  Platform(teal)
+  Data(purple)
+
+Customer is a person | t: Frontend
+  description: Browses and purchases books online
+
+Admin is a person | t: Backend
+  description: Manages inventory and orders
+
+Bookstore is a system | t: Backend
+  description: Core e-commerce platform for book sales
+  containers
+    WebApp is a container | tech: React, t: Frontend
+      description: Single-page storefront application
+      components
+        Catalog is a component
+        Cart is a component
+        Checkout is a component
+    API is a container | tech: Node, t: Backend
+      description: REST API gateway for all client requests
+    OrderSvc is a container | tech: Node, t: Backend
+      description: Order processing and fulfillment
+    SearchSvc is a container | tech: Python, t: Backend
+      description: Full-text search over book catalog
+    BookDB is a container is a database | tech: PostgreSQL, t: Data
+      description: Relational store — books, orders, users
+    CacheLayer is a container is a cache | tech: Redis, t: Platform
+      description: Session and query result cache
+    EventBus is a container | tech: Kafka, t: Platform
+      description: Async event backbone for order lifecycle
+
+PaymentGW is a system | t: Platform
+  description: Stripe — external payment processing
+
+EmailSvc is a system | t: Platform
+  description: SendGrid — transactional email delivery
+
+Customer -Browses catalog-> Bookstore
+Admin -Manages inventory-> Bookstore
+Bookstore -Processes payments via-> PaymentGW | tech: REST
+Bookstore ~Sends order confirmations~> EmailSvc | tech: SMTP

package/gallery/fixtures/c4.dgmo

@@ -0,0 +1,17 @@
+c4 Internet Banking System
+
+Customer is a person
+  description: A customer of the bank
+
+Banking is a system
+  description: Core internet banking system
+  containers
+    WebApp is a container | tech: React
+    API is a container | tech: Node.js
+    DB is a container is a database | tech: PostgreSQL
+
+Email is a system
+  description: External email delivery service
+
+Customer -Uses-> Banking
+Banking -Sends emails via-> Email

package/gallery/fixtures/chord.dgmo

@@ -0,0 +1,12 @@
+chord Inter-Department Collaboration
+
+Engineering -> Design 85
+Engineering -> Product 72
+Engineering -> QA 95
+Design -> Product 68
+Design -> Marketing 45
+Product -> Marketing 58
+Product -> Sales 42
+Marketing -> Sales 65
+QA -> Engineering 88
+Sales -> Product 30

package/gallery/fixtures/class-basic.dgmo

@@ -0,0 +1,14 @@
+class Animal Hierarchy
+
+Animal
+  name: string
+  age: number
+  speak(): void
+
+Dog extends Animal
+  breed: string
+  fetch(): void
+
+Cat extends Animal
+  indoor: boolean
+  purr(): void

package/gallery/fixtures/class-full.dgmo

@@ -0,0 +1,43 @@
+class Design Patterns
+
+Drawable [interface]
+  + draw(): void
+  + resize(w: number, h: number): void
+
+Shape implements Drawable [abstract] (purple)
+  # x: number
+  # y: number
+  + area(): number
+  + move(dx: number, dy: number): void
+  - validate(): boolean
+
+Circle extends Shape
+  - radius: number
+  + getRadius(): number
+
+Rectangle extends Shape
+  - width: number
+  - height: number
+  + getDiagonal(): number
+
+Color [enum] (yellow)
+  Red
+  Green
+  Blue
+
+Canvas
+  - shapes: Shape[]
+  + render(): void
+  + addShape(s: Shape): void
+  + clear(): void
+  count: number {static}
+  *-- Shape : contains
+  ..> Logger : uses
+
+Logger
+  - instance: Logger {static}
+  + log(msg: string): void
+  + getInstance(): Logger {static}
+
+Circle
+  -> Color : has fill

package/gallery/fixtures/doughnut.dgmo

@@ -0,0 +1,8 @@
+doughnut Cloud Spending by Service
+
+Compute (blue) 34
+Storage (cyan) 22
+Database (green) 18
+Networking (orange) 12
+AI/ML (purple) 8
+Other (gray) 6

package/gallery/fixtures/flowchart-basic.dgmo

@@ -0,0 +1,3 @@
+flowchart Basic Flow
+
+(Start) -> [Step 1] -> [Step 2] -> [Step 3] -> (End)

package/gallery/fixtures/flowchart-colors.dgmo

@@ -0,0 +1,5 @@
+flowchart Color Demo
+
+(Start(green)) -> [Parse Input] -> <Valid?(blue)>
+  -yes(green)-> [Process(teal)] -> (Success(green))
+  -no(red)-> [Error Handler(red)] -> /Log Error(orange)/ -> (Failure(red))

package/gallery/fixtures/flowchart-complex.dgmo

@@ -0,0 +1,17 @@
+flowchart CI/CD Pipeline
+
+(Push to Repo) -> [[Run Linter]] -> <Lint Pass?>
+  -yes-> [[Run Tests]]
+  -no-> [Lint Report~] -> /Notify Dev/ -> (Fix & Retry)
+
+[[Run Tests]] -> <Tests Pass?>
+  -yes-> [Build Artifact]
+  -no-> [Test Report~] -> /Notify Dev/ -> (Fix & Retry)
+
+[Build Artifact] -> <Environment?>
+  -staging-> [[Deploy to Staging]] -> /Run Smoke Tests/ -> <Smoke OK?>
+    -yes-> /Await Approval/
+    -no-> /Notify Team/ -> (Rollback)
+  -production-> [[Deploy to Prod]] -> /Health Check/ -> <Healthy?>
+    -yes-> (Done)
+    -no-> (Rollback)

package/gallery/fixtures/flowchart-decision.dgmo

@@ -0,0 +1,5 @@
+flowchart Decision Flow
+
+(Start) -> /Get Input/ -> <Valid?>
+  -yes-> [Process Data] -> (Done)
+  -no-> [Show Error] -> /Get Input/

package/gallery/fixtures/flowchart-full.dgmo

@@ -0,0 +1,13 @@
+flowchart Order Processing Pipeline
+
+(Receive Order) -> [Validate Input] -> <Valid?>
+  -yes-> [Check Inventory] -> <In Stock?>
+    -yes-> [[Process Payment]] -> <Payment OK?>
+      -yes-> [Ship Order] -> /Send Confirmation/ -> (Complete)
+      -no-> [Retry Payment] -> <Retries Left?>
+        -yes-> [[Process Payment]]
+        -no-> [Cancel Order] -> /Notify Customer/ -> (Failed)
+    -no-> /Notify Backorder/ -> <Accept Wait?>
+      -yes-> [Queue Order] -> [Check Inventory]
+      -no-> [Refund] -> (Cancelled)
+  -no-> [Log Validation Error~] -> /Show Error/ -> (Rejected)

package/gallery/fixtures/flowchart-groups.dgmo

@@ -0,0 +1,10 @@
+flowchart Microservice Architecture
+
+/Request/ -> [Auth Check] -> <Authorized?>
+
+<Authorized?>
+  -yes-> [Create Order] -> [Validate Items]
+
+[Validate Items] -> [[Send Confirmation]]
+<Authorized?>
+  -no-> [[Send Rejection]]

package/gallery/fixtures/flowchart-loop.dgmo

@@ -0,0 +1,7 @@
+flowchart Retry Logic
+
+(Start) -> [Initialize] -> [Attempt Request] -> <Success?>
+  -yes-> [Process Response] -> (Done)
+  -no-> <Retries Left?>
+    -yes-> [Wait & Backoff] -> [Attempt Request]
+    -no-> [Log Failure] -> (Error)

package/gallery/fixtures/flowchart-nested.dgmo

@@ -0,0 +1,7 @@
+flowchart Authentication Flow
+
+(Start) -> <Authenticated?>
+  -yes-> <Authorized?>
+    -yes-> [Process Request] -> [Return 200] -> (End)
+    -no-> [Return 403] -> (End)
+  -no-> [Return 401] -> (End)

package/gallery/fixtures/flowchart-shapes.dgmo

@@ -0,0 +1,5 @@
+flowchart Pirate's Code
+(Sail Ho!) -> <Friend or Foe?>
+  -friend-> [Check Logs~] -> /Trade Rum/ -> [Celebrate]
+  -foe-> [Fire Cannons] -> [[Claim Loot]] -> [Celebrate]
+[Celebrate]->(Sail On)

package/gallery/fixtures/function.dgmo

@@ -0,0 +1,8 @@
+function Mathematical Functions
+x-label x
+y-label f(x)
+
+x -6 to 6
+f(x) (blue) sin(x)
+g(x) (red) x^2 / 10
+h(x) (green) cos(x) * 2

package/gallery/fixtures/funnel.dgmo

@@ -0,0 +1,7 @@
+funnel Sales Pipeline Conversion
+
+Website Visitors 12000
+Product Page Views 5400
+Free Trial Signups 2100
+Onboarding Complete 890
+Paid Conversion 340

package/gallery/fixtures/gantt-full.dgmo

@@ -0,0 +1,49 @@
+gantt Product Launch Plan — Full
+start 2024-01-15
+today-marker 2024-03-01
+critical-path
+dependencies
+
+tag Team alias t
+  Engineering(blue)
+  Design(purple)
+  QA(orange)
+  Marketing(green)
+
+tag Phase alias p
+  Foundation(green)
+  Growth(orange)
+  Launch(red)
+
+era 2024-01-15 -> 2024-02-15 Investor Review
+era 2024-03-10 -> 2024-03-14 GDC 2024 (purple)
+marker 2024-02-26 Board Meeting
+marker 2024-04-08 Trade Show Demo (orange)
+
+// Independent task with offset — starts 8bd after project start
+10bd Brand Guidelines | t: Design, p: Foundation, offset: 8bd
+
+parallel
+  [Backend] | t: Engineering
+    30bd Database Layer | p: Foundation, 80%
+    10bd? Auth Module | p: Foundation, 100%
+      -blocks-> Frontend.API Integration | offset: -5bd
+    parallel
+      5bd Load Testing | t: QA, p: Growth
+      5bd Security Audit | t: QA, p: Growth
+
+  [Frontend] | t: Design
+    15bd Component Library | p: Foundation
+    10bd API Integration | t: Engineering, p: Growth
+    5bd Polish | p: Growth, 30%
+
+[Marketing] | t: Marketing
+  10bd Landing Page | p: Growth
+  5bd Press Kit | p: Launch
+    -needs-> Landing Page
+
+[Integration] | t: QA
+  10bd E2E Testing | p: Launch
+    -depends on-> Backend.Auth Module
+  // Final validation before release
+  0d Release Candidate | p: Launch

package/gallery/fixtures/gantt.dgmo

@@ -0,0 +1,42 @@
+gantt Product Launch Plan
+start 2024-01-15
+today-marker 2024-03-01
+critical-path
+dependencies
+
+tag Team alias t
+  Engineering(blue)
+  Design(purple)
+  QA(orange)
+
+tag Phase alias p
+  Foundation(green)
+  Growth(orange)
+
+era 2024-01-15 -> 2024-02-15 Investor Review
+era 2024-03-10 -> 2024-03-14 GDC 2024 (purple)
+marker 2024-02-26 Board Meeting
+marker 2024-04-08 Trade Show Demo (orange)
+
+// Independent task with offset — starts 8bd after project start
+10bd Brand Guidelines | t: Design, p: Foundation, offset: 8bd
+
+parallel
+  [Backend] | t: Engineering
+    30bd Database Layer | p: Foundation, 80%
+    10bd? Auth Module | p: Foundation, 100%
+      // Start frontend integration 5bd before Auth finishes (overlap)
+      -> Frontend.API Integration | offset: -5bd
+    parallel
+      5bd Load Testing | t: QA, p: Growth
+      5bd Security Audit | t: QA, p: Growth
+
+  [Frontend] | t: Design
+    15bd Component Library | p: Foundation
+    10bd API Integration | t: Engineering, p: Growth
+    5bd Polish | p: Growth, 30%
+
+[Integration] | t: QA
+  10bd E2E Testing
+  // Final validation before release
+  0d Release Candidate

package/gallery/fixtures/heatmap.dgmo

@@ -0,0 +1,8 @@
+heatmap Deploy Frequency by Day and Hour
+
+columns Mon, Tue, Wed, Thu, Fri
+6 AM 1, 2, 0, 1, 0
+9 AM 5, 8, 6, 7, 4
+12 PM 3, 4, 5, 3, 2
+3 PM 8, 12, 9, 10, 6
+6 PM 2, 3, 1, 2, 1

package/gallery/fixtures/infra-full.dgmo

@@ -0,0 +1,78 @@
+infra E-Commerce Platform — Full Infrastructure
+
+tag Team alias t
+  Backend(blue)
+  Platform(teal)
+  Data(purple)
+
+tag Tier alias r
+  Edge(green)
+  Core(blue)
+  Storage(orange)
+
+edge
+  rps: 15000
+  -> CloudFront
+
+CloudFront is a network | t: Platform, r: Edge
+  description: CDN — edge cache with 200+ PoPs
+  cache-hit: 85%
+  -> WAF
+
+WAF is a gateway | t: Platform, r: Edge
+  description: Web Application Firewall — bot protection and rate limiting
+  firewall-block: 8%
+  -> ALB
+
+ALB is a gateway | t: Platform, r: Core
+  -/api-> [API Tier] | split: 50%
+  -/shop-> [Commerce Tier] | split: 35%
+  -/static-> StaticBucket | split: 15%
+
+[API Tier] | t: Backend, r: Core
+  APIServer is a service
+    description: Core REST API — auth, catalog, user profiles
+    instances: 4
+    max-rps: 800
+    latency-ms: 35
+    cb-error-threshold: 50%
+    -> Redis | fanout: 2
+    -> PostgreSQL
+    ~order.placed~> EventBus
+
+[Commerce Tier] | t: Backend, r: Core
+  CheckoutSvc is a service
+    description: Checkout and payment orchestration
+    instances: 2-10
+    max-rps: 400
+    latency-ms: 100
+    -> PaymentGW
+    -> PostgreSQL
+    ~payment.confirmed~> EventBus
+  PaymentGW is a gateway
+    description: Stripe/Adyen payment gateway proxy
+    latency-ms: 250
+
+Redis is a cache | t: Data, r: Storage
+  description: Session store and query cache
+  latency-ms: 2
+
+PostgreSQL is a database | t: Data, r: Storage
+  description: Primary relational store — orders, users, catalog
+  latency-ms: 8
+
+EventBus is a queue | t: Platform, r: Core
+  description: Async event backbone (Kafka)
+  ~analytics~> ClickHouse
+  ~notifications~> NotifySvc
+
+ClickHouse is a database | t: Data, r: Storage
+  description: Analytics OLAP — real-time dashboards
+
+NotifySvc is a service | t: Backend, r: Core
+  description: Email/SMS/push notification dispatcher
+  instances: 2
+
+StaticBucket is a storage | t: Platform, r: Edge
+  description: S3 bucket — JS, CSS, images
+  latency-ms: 5