@diagrammo/dgmo 0.10.1 → 0.10.2

package/docs/guide/chart-org.md

@@ -1,209 +0,0 @@
-# Org Chart
-
-```dgmo
-org The Dread Fleet
-sub-node-label Crew
-show-sub-node-count
-
-tag Rank alias r
-  Captain(red)
-  FirstMate(orange)
-  Quartermaster(yellow)
-  Bosun(green)
-  Gunner(teal)
-  Sailor(blue) default
-  Jester(cyan)
-  Swab(purple)
-
-tag Ship alias s
-  Revenge(blue) default
-  Serpent(green)
-  Phantom(purple)
-
-tag Status alias st
-  Loyal(green) default
-  Turncoat(red)
-  NewRecruit(yellow)
-
-Blackbeard| r: Captain, s: Revenge
-  Anne Bonny| r: FirstMate
-    [Gun Deck]
-      Cannonball Pete| r: Gunner
-      Smokey Jack| r: Gunner, st: NewRecruit
-      Powder Meg| r: Swab, st: NewRecruit
-    [Boarding Party]
-      Cutlass Jim| r: Bosun
-      Red Mary
-      One-Eyed Dan| st: Turncoat
-  Calico Rackham| r: Quartermaster
-    [Cargo Hold]
-      Barnacle Bob
-      Slippery Sal| st: Turncoat
-  Long John| r: FirstMate, s: Serpent
-    [Rigging Crew]
-      Monkey Fist| r: Bosun
-      Pegleg Pete
-      Crow Jane
-    [Navigation]
-      Stargazer Quinn| r: Quartermaster
-      Compass Rose| st: NewRecruit
-```
-
-## Overview
-
-Org charts use **indentation** to define reporting hierarchy. Each person is a line of text, and metadata like `role:` appears indented beneath them. Children are indented under their manager.
-
-## Syntax
-
-```
-org Chart Title
-
-Person Name
-  role: Job Title
-
-  Direct Report
-    role: Job Title
-```
-
-## Settings
-
-| Key     | Description   | Default |
-| ------- | ------------- | ------- |
-| `chart` | Must be `org` | Yes     |
-| `title` | Chart title   | None    |
-
-## Nodes
-
-Each non-indented (or less-indented) text line creates a person node. Deeper indentation creates a child (direct report):
-
-```
-CEO
-  VP of Engineering
-    Senior Engineer
-    Junior Engineer
-  VP of Sales
-    Account Executive
-```
-
-## Metadata
-
-Add key-value pairs indented under a node:
-
-```
-Alice Park
-  role: Senior Engineer
-  location: New York
-  focus: APIs
-```
-
-Metadata renders as secondary text on the node card.
-
-### Compact Pipe Syntax
-
-For concise entries, use `|` to put metadata on a single line:
-
-```
-Alice Park | role: Senior Engineer | location: NY
-Bob Torres | role: Junior Engineer | location: CO
-```
-
-## Containers (Teams)
-
-Use `[Team Name]` to create a container that groups its children visually:
-
-```
-Alex Chen
-  role: CTO
-
-  [Platform Team]
-    goal: Core infrastructure and APIs
-
-    Alice Park | role: Senior Engineer
-    Bob Torres | role: Junior Engineer
-
-  [Frontend Team]
-    goal: Ship new design system by Q3
-
-    Carol Wu | role: Senior Engineer
-    Dave Kim | role: Junior Engineer
-```
-
-Containers render as labeled boxes. They can have metadata like `goal:` and `charter:` which display below the container label.
-
-## Node Colors
-
-Add a color name in parentheses:
-
-```
-[Platform Team(blue)]
-[Frontend Team(green)]
-```
-
-## Tag Groups
-
-Define color-coded tags for metadata values like location or status. Tag groups must appear before org content:
-
-```
-org Acme Corp
-
-tag Location
-  NY(blue)
-  LA(yellow)
-  Remote(purple)
-
-tag Status
-  FTE(green)
-  Contractor(orange)
-
-Jane Smith
-  role: CEO
-  location: NY
-  status: FTE
-```
-
-- `tag GroupName` starts a tag group
-- `alias` provides a shorthand for metadata keys (e.g., `tag Location alias l`)
-- `default` marks the fallback value for nodes without that metadata
-- When a node's metadata value matches a tag entry, it renders with that tag's color as a badge
-
-## Comments
-
-```
-// This line is ignored by the parser
-```
-
-## Collapse / Expand
-
-In the app, click a node that has children to focus it. Click again to collapse its subtree — a "+N hidden" label shows how many nodes are hidden. Click once more to expand. Containers can be collapsed independently.
-
-Keyboard: Tab to focus a node, Enter or Space to toggle.
-
-## Complete Example
-
-```dgmo
-org Engineering Division
-
-Alex Chen
-  role: CTO
-
-  [Platform Team]
-    goal: Core infrastructure and APIs
-    charter: Platform reliability and developer experience
-
-    Alice Park | role: Senior Engineer | location: NY
-    Bob Torres | role: Junior Engineer | location: CO
-
-  [Frontend Team]
-    goal: Ship new design system by Q3
-
-    Carol Wu
-      role: Senior Engineer
-    Dave Kim
-      role: Junior Engineer
-
-  [Data Team]
-    goal: ML pipeline and analytics
-
-    Eve Martinez
-      role: Data Scientist
-```

package/docs/guide/chart-pie.md

@@ -1,39 +0,0 @@
-# Pie Chart
-
-```dgmo
-pie Crew Roles Distribution
-
-Sailors 45
-Gunners 20
-Marines 15
-Officers 8
-Specialists 7
-Cooks & Surgeons 5
-```
-
-## Syntax
-
-```
-pie Chart Title
-
-Label value
-```
-
-## Metadata Keys
-
-| Key     | Description                           | Required |
-| ------- | ------------------------------------- | -------- |
-| `chart` | Must be `pie`                         | Yes      |
-| `title` | Chart title displayed above the chart | No       |
-
-## Data Format
-
-Each data line follows the pattern `Label value`:
-
-```
-Sailors 45
-Gunners 20
-Officers 8
-```
-
-Slices are automatically colored using the Nord palette.

package/docs/guide/chart-polar-area.md

@@ -1,38 +0,0 @@
-# Polar Area Chart
-
-```dgmo
-polar-area Captain's Skills
-
-Navigation 90
-Swordsmanship 75
-Leadership 85
-Cunning 95
-Seamanship 80
-```
-
-## Syntax
-
-```
-polar-area Chart Title
-
-Label value
-```
-
-## Metadata Keys
-
-| Key     | Description                           | Required |
-| ------- | ------------------------------------- | -------- |
-| `chart` | Must be `polar-area`                  | Yes      |
-| `title` | Chart title displayed above the chart | No       |
-
-## Data Format
-
-Each data line follows the pattern `Label value`:
-
-```
-Navigation 90
-Swordsmanship 75
-Leadership 85
-```
-
-Segments are automatically colored using the Nord palette.

package/docs/guide/chart-pyramid.md

@@ -1,111 +0,0 @@
-# Pyramid Diagram
-
-```dgmo
-pyramid Maslow's Hierarchy of Needs
-
-Self-Actualization | color: purple
-  Morality, creativity, acceptance of facts.
-
-Esteem | color: blue
-  Respect, recognition, confidence.
-
-Love & Belonging | color: green
-  Friendship, intimacy, family.
-
-Safety | color: yellow
-  Security, employment, health.
-
-Physiological | color: orange
-  Food, water, warmth, rest.
-```
-
-## Overview
-
-Pyramid diagrams show a hierarchy of stacked layers. Each layer gets a colored band with a label and an optional description. Source order reads apex-first — the first layer in the file is the narrowest (visual top), the last is the widest (visual bottom). Use `inverted` to flip into a funnel orientation.
-
-## Syntax
-
-```
-pyramid Title
-
-LayerLabel
-LayerLabel | color: blue
-LayerLabel | color: green
-  Indented description
-```
-
-The first line declares the chart type and an optional title. Each non-indented, non-directive line declares one layer. At least two layers are required.
-
-## Layers
-
-```
-pyramid Roles
-
-Executives | color: purple
-Managers | color: blue
-Individual Contributors | color: green
-```
-
-### Layer Pipe Metadata
-
-| Key | Type | Default | Description |
-|-----|------|---------|-------------|
-| `color` | palette name | auto-assigned | Layer color |
-| `description` | string | — | One-liner shown beside the layer |
-
-### Descriptions
-
-Indented lines under a layer add description text. Markdown inline formatting is supported (`**bold**`, `*italic*`, `` `code` ``, `[links](url)`). Bullet points with `- item` render as `• item`.
-
-```
-Wisdom | color: purple
-  Ethical judgment, acting with insight.
-  - Knowing *why* something matters
-  - Acting with long-term perspective
-```
-
-If both `| description: text` and indented lines exist, they concatenate (pipe first, then indented).
-
-## Directives
-
-| Directive | Effect |
-|-----------|--------|
-| `inverted` | Flip apex to the bottom (funnel orientation). Source order is preserved — the first layer is always the visual top. |
-
-```
-pyramid Acquisition Funnel
-
-inverted
-
-Visitors | color: blue
-Signups | color: cyan
-Activated | color: green
-Paid | color: orange
-```
-
-## Overflow Handling
-
-When descriptions don't fit a layer's band, the renderer automatically:
-
-- **Wraps** text at the column edge so nothing leaves the canvas
-- **Truncates** with "…" when content exceeds the available lines
-- **Alternates** descriptions left ↔ right when a single column can't hold them
-- **Reveals** the full description when a layer is highlighted (in-app), hiding siblings so it has room
-
-## Complete Example
-
-```dgmo
-pyramid The DIKW Pyramid
-
-Wisdom | color: purple
-  Ethical judgment, acting with insight — knowing *why*.
-
-Knowledge | color: blue
-  Synthesized information — knowing *how*.
-
-Information | color: green
-  Processed data with context — knowing *what*.
-
-Data | color: yellow
-  Raw facts and measurements — unprocessed signals.
-```

package/docs/guide/chart-quadrant.md

@@ -1,69 +0,0 @@
-# Quadrant Chart
-
-```dgmo
-quadrant Crew Performance Assessment
-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)
-
-Quartermaster 0.9, 0.95
-Navigator 0.85, 0.8
-Gunner 0.7, 0.6
-Surgeon 0.8, 0.75
-Boatswain 0.6, 0.85
-Cook 0.4, 0.9
-New Recruit 0.2, 0.5
-Troublemaker 0.65, 0.2
-```
-
-## Syntax
-
-```
-quadrant Chart Title
-x-label Low Label, High Label
-y-label Low Label, High Label
-
-top-right Quadrant Label (color)
-top-left Quadrant Label (color)
-bottom-left Quadrant Label (color)
-bottom-right Quadrant Label (color)
-
-Item Name x, y
-```
-
-## Metadata Keys
-
-| Key            | Description                                             | Required |
-| -------------- | ------------------------------------------------------- | -------- |
-| `chart`        | Must be `quadrant`                                      | Yes      |
-| `title`        | Chart title displayed above the chart                   | No       |
-| `x-label`      | Two comma-separated labels for X axis (low, high)       | No       |
-| `y-label`      | Two comma-separated labels for Y axis (low, high)       | No       |
-| `top-right`    | Label for the top-right quadrant with optional color    | No       |
-| `top-left`     | Label for the top-left quadrant with optional color     | No       |
-| `bottom-left`  | Label for the bottom-left quadrant with optional color  | No       |
-| `bottom-right` | Label for the bottom-right quadrant with optional color | No       |
-
-## Data Format
-
-Each data point specifies X and Y coordinates between 0 and 1:
-
-```
-Item A 0.9, 0.95
-Item B 0.4, 0.3
-```
-
-## Quadrant Colors
-
-Colors can be specified in parentheses after each quadrant label:
-
-```
-top-right Promote (green)
-top-left Train (yellow)
-bottom-left Maroon (red)
-bottom-right Watch Closely (purple)
-```

package/docs/guide/chart-radar.md

@@ -1,38 +0,0 @@
-# Radar Chart
-
-```dgmo
-radar Ship Combat Rating
-
-Firepower 85
-Speed 70
-Armor 60
-Maneuverability 90
-Crew Morale 75
-```
-
-## Syntax
-
-```
-radar Chart Title
-
-Label value
-```
-
-## Metadata Keys
-
-| Key     | Description                           | Required |
-| ------- | ------------------------------------- | -------- |
-| `chart` | Must be `radar`                       | Yes      |
-| `title` | Chart title displayed above the chart | No       |
-
-## Data Format
-
-Each data line defines one axis of the radar with its value:
-
-```
-Firepower 85
-Speed 70
-Armor 60
-```
-
-Values are plotted on axes radiating from the center, connected by a filled polygon.

package/docs/guide/chart-sankey.md

@@ -1,103 +0,0 @@
-# Sankey Diagram
-
-```dgmo
-sankey Rum Supply Chain of the Caribbean
-
-Sugar Plantations(green)
-  Tortuga Distillery(orange) 3000
-  Nassau Distillery(orange) 2500
-  Kingston Distillery(orange) 2000
-
-Tortuga Distillery
-  Pirate Taverns(red) 2000
-  Ship Provisions(teal) 1000
-
-Nassau Distillery
-  Pirate Taverns 1500
-  Black Market(purple) 1000
-
-Kingston Distillery
-  Royal Navy(blue) 1200
-  Pirate Taverns 800
-
-Pirate Taverns
-  Crew Morale 3500
-  Bar Fights 800 (red)
-
-Ship Provisions -> Long Voyages 1000
-```
-
-## Syntax
-
-### Arrow syntax
-
-```
-sankey Chart Title
-
-Source -> Target value
-```
-
-### Indentation syntax
-
-```
-sankey
-
-Source
-  Target A 300
-  Target B 200
-
-Target A
-  Sub-target 150
-```
-
-Indent targets under a bare source label. Both syntaxes can be mixed in the same diagram.
-
-## Color Annotations
-
-### Node colors
-
-Add `(color)` after a node name to color that node:
-
-```
-Revenue(green)
-  Costs(red) 600
-  Profit(blue) 400
-
-// or with arrows
-Revenue(green) -> Costs(red) 600
-```
-
-Uncolored nodes use the palette's default series colors.
-
-### Link colors
-
-Add `(color)` after the value to color a specific link:
-
-```
-Revenue
-  Costs 600 (orange)
-
-// or with arrows
-Revenue -> Costs 600 (orange)
-```
-
-Uncolored links use a gradient between their source and target node colors.
-
-## Metadata Keys
-
-| Key     | Description                           | Required |
-| ------- | ------------------------------------- | -------- |
-| `chart` | Must be `sankey`                      | Yes      |
-| `title` | Chart title displayed above the chart | No       |
-
-## Data Format
-
-Each data line defines a flow from source to target with a numeric value:
-
-```
-Sugar Plantations -> Distillery 3000
-Distillery -> Taverns 2000
-Distillery -> Ship Provisions 1000
-```
-
-Nodes are created automatically from the source and target names. The same node can appear as both a source and a target to create multi-level flows.

package/docs/guide/chart-scatter.md

@@ -1,91 +0,0 @@
-# Scatter Plot
-
-```dgmo
-scatter Cannon Range vs Powder Charge
-x-label Powder (lbs)
-y-label Range (yards)
-
-Long Tom 12 1800
-Demi-Culverin 8 1200
-Carronade 4 400
-Swivel Gun 2 250
-Nine-Pounder 6 900
-Eighteen-Pounder 10 1500
-Basilisk 14 2000
-Falconet 3 350
-Minion 5 700
-Saker 7 1050
-```
-
-## Syntax
-
-```
-scatter Chart Title
-x-label X Axis Label
-y-label Y Axis Label
-no-name
-size-label Size Legend Label
-
-Point Name x y
-
-// or with size (bubble chart)
-Point Name x y size
-```
-
-## Metadata Keys
-
-| Key          | Description                                                | Required |
-| ------------ | ---------------------------------------------------------- | -------- |
-| `chart`      | Must be `scatter`                                          | Yes      |
-| `title`      | Chart title displayed above the chart                      | No       |
-| `x-label`    | Label for the X axis                                       | No       |
-| `y-label`    | Label for the Y axis                                       | No       |
-| `no-name`    | Hide point labels (labels are on by default)               | No       |
-| `size-label` | Label for the size dimension (shown in legend for bubbles) | No       |
-
-## Data Format
-
-Each data line provides X and Y values, with an optional third value for bubble size:
-
-```
-// 2D scatter
-Point A 12 1800
-Point B 8 1200
-
-// 3D bubble
-Point A 85 90 80
-Point B 45 55 35
-```
-
-## Category Groups
-
-Use `[Category Name](color)` headers to group points into colored categories:
-
-```
-[English Pirates](red)
-Blackbeard 85 90 80
-Calico Jack 45 55 35
-
-[French Buccaneers](blue)
-L'Olonnais 70 80 60
-```
-
-## Variants
-
-### Bubble Chart
-
-Add a third value per data point and use `sizelabel` to label the size dimension:
-
-```dgmo
-scatter Pirate Fleets of the Caribbean
-size-label Crew
-
-[English Pirates](red)
-Blackbeard 85 90 80
-Calico Jack 45 55 35
-Anne Bonny 50 70 30
-
-[French Buccaneers](blue)
-L'Olonnais 70 80 60
-Pierre le Grand 30 45 25
-```