@diagrammo/dgmo 0.15.0 → 0.16.0

package/README.md

@@ -167,9 +167,9 @@ const colors = getPalette('nord').light;
 const content = `
 sankey Energy Flow
 
-Coal (orange)
+Coal orange
   Electricity 50
-Gas (blue)
+Gas blue
   Electricity 30
 Electricity -> Industry 45
 Electricity -> Homes 35
@@ -334,8 +334,8 @@ const content = `
 org Engineering
 
 tag Location
-  NY(blue)
-  SF(green)
+  NY blue
+  SF green
 
 Alex Chen
   role: CTO
@@ -389,13 +389,13 @@ Containers can nest and carry their own metadata (key: value pairs). Children ar
 
 ```
 tag Location as l
-  NY(blue)
-  SF(green)
-  Remote(purple) default
+  NY blue
+  SF green
+  Remote purple default
 ```
 
-- `tag GroupName` starts a tag group; `alias` provides a shorthand for metadata keys
-- `Value(color)` maps a metadata value to a color
+- `tag GroupName` starts a tag group; `as <alias>` provides a shorthand for metadata keys
+- `Value color` maps a metadata value to a color (trailing-token form per spec §1.5)
 - `default` marks the fallback value for nodes without that metadata
 - Nodes whose metadata matches a tag group value get color-coded automatically
 - `##` syntax is deprecated but still accepted — use `tag` for new diagrams
@@ -710,7 +710,20 @@ const svg = await renderExtendedChartForExport(content, 'light');
 
 Both accept an optional third argument for a custom `PaletteColors` object (defaults to Nord).
 
-## API overview
+## API tiers
+
+`@diagrammo/dgmo` ships three import paths with different stability contracts:
+
+| Path | Surface | SemVer contract |
+|------|---------|-----------------|
+| `@diagrammo/dgmo` | `render`, `validate`, `encodeDiagramUrl`, `decodeDiagramUrl`, `palettes`, `getPalette`, `themes`, plus the `RenderOptions`, `RenderResult`, `CompactViewState`, `PaletteConfig`, `PaletteColors`, `Theme`, `DgmoError` types | **Stable.** Breaking changes only in major versions. Pin `^0.x` (or `^1.x` once we hit 1.0). |
+| `@diagrammo/dgmo/highlight` | `highlightDgmo`, `NORD_ROLE_STYLES` and other role-style sets | **Stable.** Same policy as root. |
+| `@diagrammo/dgmo/editor` | CodeMirror grammar + language support | **Stable.** Same policy as root. |
+| `@diagrammo/dgmo/advanced` | Parsers (`parseChart`, `parseVisualization`, `parseSequenceDgmo`, …), layout helpers, config builders, low-level renderers, palette-color utilities, sequence internals — see the table below | **Reduced semver.** Symbols may be renamed, signatures may change, or exports may be removed in **minor** versions. Patch versions only fix bugs. Pin `~0.x.y` if you depend on `/advanced`. |
+
+The `@diagrammo/dgmo/internal` subpath was renamed to `/advanced` in 0.15.x and exists as a re-export alias for one minor version. It will be removed in 0.17.x — update your imports to `/advanced` before then.
+
+## /advanced exports
 
 ### Router