@diagrammo/dgmo 0.8.2 → 0.8.3

package/src/infra/parser.ts

@@ -4,10 +4,10 @@
 //
 // Parses `infra [Title]` syntax into a structured InfraModel.
 // Handles: chart metadata, component blocks with indented properties
-// and connections, [Group] / # Group containers, tag groups, pipe metadata.
+// and connections, [Group] containers, tag groups, pipe metadata.
 
 import { makeDgmoError, formatDgmoError, suggest } from '../diagnostics';
-import { measureIndent, normalizeDirection, parseFirstLine, GROUP_HASH_RE, OPTION_NOCOLON_RE } from '../utils/parsing';
+import { measureIndent, parseFirstLine, OPTION_NOCOLON_RE } from '../utils/parsing';
 import { matchTagBlockHeading } from '../utils/tag-groups';
 import type {
   ParsedInfra,
@@ -40,12 +40,6 @@ const ASYNC_SIMPLE_CONNECTION_RE =
 // Deprecated xN fanout suffix (e.g. "x5" at end of line)
 const DEPRECATED_FANOUT_RE = /\bx(\d+)\s*$/;
 
-// "is a" type declaration: NodeName is a <type>
-const IS_A_RE = /^(.+?)\s+is\s+an?\s+(database|cache|queue|service|gateway|storage|function|network)\s*$/i;
-
-// Valid node types for "is a" declarations
-const VALID_NODE_TYPES = new Set(['database', 'cache', 'queue', 'service', 'gateway', 'storage', 'function', 'network']);
-
 // Group declaration: [Group Name] with optional pipe metadata
 const GROUP_RE = /^\[([^\]]+)\]\s*(?:\|\s*(.+))?$/;
 
@@ -217,16 +211,9 @@ export function parseInfra(content: string): ParsedInfra {
         continue;
       }
 
-      // direction LR | TB  (also accepts orientation as alias)
-      // Supports both `direction LR` (new) and `direction: LR` (legacy)
-      if (/^(?:direction|orientation)\s/i.test(trimmed)) {
-        const raw = trimmed.replace(/^(?:direction|orientation)\s+/i, '').trim();
-        const dir = normalizeDirection(raw);
-        if (dir) {
-          result.direction = dir;
-        } else {
-          warn(lineNumber, `Unknown direction '${raw}'. Expected 'LR', 'TB', 'horizontal', or 'vertical'.`);
-        }
+      // direction-tb — bare boolean to switch to top-to-bottom (default is LR)
+      if (/^direction-tb$/i.test(trimmed)) {
+        result.direction = 'TB';
         continue;
       }
 
@@ -247,23 +234,6 @@ export function parseInfra(content: string): ParsedInfra {
         continue;
       }
 
-      // scenario: Name — no longer supported
-      if (/^scenario\s*:/i.test(trimmed)) {
-        setError(lineNumber, `'scenario:' syntax is no longer supported`);
-        // Skip indented block
-        let si = i + 1;
-        while (si < lines.length) {
-          const sLine = lines[si];
-          const sTrimmed = sLine.trim();
-          if (!sTrimmed || sTrimmed.startsWith('#')) { si++; continue; }
-          const sIndent = sLine.length - sLine.trimStart().length;
-          if (sIndent === 0) break;
-          si++;
-        }
-        i = si - 1;
-        continue;
-      }
-
       // Tag group: `tag Name [alias]` (via shared matchTagBlockHeading)
       const tagMatch = matchTagBlockHeading(trimmed);
       if (tagMatch) {
@@ -278,23 +248,6 @@ export function parseInfra(content: string): ParsedInfra {
         continue;
       }
 
-      // # GroupName (alternate group notation)
-      const hashGroupMatch = trimmed.match(GROUP_HASH_RE);
-      if (hashGroupMatch) {
-        finishCurrentNode();
-        finishCurrentTagGroup();
-        const gLabel = hashGroupMatch[1].trim();
-        const gId = groupId(gLabel);
-        currentGroup = {
-          id: gId,
-          label: gLabel,
-          metadata: undefined,
-          lineNumber,
-        };
-        result.groups.push(currentGroup);
-        continue;
-      }
-
       // [Group Name] or [Group Name] | t: Engineering
       const groupMatch = trimmed.match(GROUP_RE);
       if (groupMatch) {
@@ -313,32 +266,6 @@ export function parseInfra(content: string): ParsedInfra {
         continue;
       }
 
-      // "is a" type declaration: NodeName is a <type>
-      const isaMatch = trimmed.match(IS_A_RE);
-      if (isaMatch) {
-        finishCurrentNode();
-        finishCurrentTagGroup();
-
-        const name = isaMatch[1].trim();
-        const nType = isaMatch[2].toLowerCase();
-        const id = nodeId(name);
-        const isEdge = EDGE_NODE_NAMES.has(id.toLowerCase());
-
-        currentNode = {
-          id,
-          label: name,
-          properties: [],
-          groupId: null,
-          tags: {},
-          isEdge,
-          nodeType: nType,
-          lineNumber,
-        };
-        currentGroup = null;
-        baseIndent = 0;
-        continue;
-      }
-
       // Component at top level (no indent)
       const compMatch = trimmed.match(COMPONENT_RE);
       if (compMatch) {
@@ -408,30 +335,6 @@ export function parseInfra(content: string): ParsedInfra {
         }
       }
 
-      // "is a" type declaration inside group
-      const isaMatchG = trimmed.match(IS_A_RE);
-      if (isaMatchG) {
-        finishCurrentTagGroup();
-        const name = isaMatchG[1].trim();
-        const nType = isaMatchG[2].toLowerCase();
-        const id = nodeId(name);
-        // Cascade group metadata into node tags (node-level overrides later)
-        const tags: Record<string, string> = currentGroup.metadata ? { ...currentGroup.metadata } : {};
-
-        currentNode = {
-          id,
-          label: name,
-          properties: [],
-          groupId: currentGroup.id,
-          tags,
-          isEdge: false,
-          nodeType: nType,
-          lineNumber,
-        };
-        baseIndent = indent;
-        continue;
-      }
-
       const compMatch = trimmed.match(COMPONENT_RE);
       if (compMatch) {
         finishCurrentTagGroup();
@@ -639,28 +542,6 @@ export function parseInfra(content: string): ParsedInfra {
     if (currentGroup && indent > 0) {
       finishCurrentNode();
 
-      // "is a" type declaration inside group
-      const isaMatchG2 = trimmed.match(IS_A_RE);
-      if (isaMatchG2) {
-        const name = isaMatchG2[1].trim();
-        const nType = isaMatchG2[2].toLowerCase();
-        const id = nodeId(name);
-        const tags: Record<string, string> = currentGroup.metadata ? { ...currentGroup.metadata } : {};
-
-        currentNode = {
-          id,
-          label: name,
-          properties: [],
-          groupId: currentGroup.id,
-          tags,
-          isEdge: false,
-          nodeType: nType,
-          lineNumber,
-        };
-        baseIndent = indent;
-        continue;
-      }
-
       const compMatch = trimmed.match(COMPONENT_RE);
       if (compMatch) {
         const name = compMatch[1];
@@ -780,7 +661,7 @@ export function extractSymbols(docText: string): DiagramSymbols {
         // Recognize new-style bare options (`key value`) and old-style (`key: value`)
         const firstLine = parseFirstLine(line);
         if (firstLine) continue; // chart type line
-        if (/^(?:direction|orientation|animate|no-animate|slo-|default-)/i.test(line)) continue;
+        if (/^(?:direction-tb|animate|no-animate|slo-|default-)/i.test(line)) continue;
         if (/^[a-z-]+\s*:/i.test(line)) continue; // legacy colon options
         inMetadata = false;
       } else {
@@ -794,7 +675,6 @@ export function extractSymbols(docText: string): DiagramSymbols {
       if (/^tag\s*:/i.test(line)) { inTagGroup = true; continue; } // legacy
       inTagGroup = false;
       if (/^\[/.test(line)) continue; // [Group] header
-      if (/^#\s/.test(line)) continue; // # Group header
       const m = COMPONENT_RE.exec(line);
       if (m && !entities.includes(m[1]!)) entities.push(m[1]!);
     } else {

package/src/infra/types.ts

@@ -62,7 +62,6 @@ export interface InfraNode {
   groupId: string | null;
   tags: Record<string, string>; // tagGroup -> tagValue
   isEdge: boolean; // true for the `edge` entry-point component
-  nodeType?: string; // database, cache, queue, service, gateway, storage, function, network
   description?: string;
   lineNumber: number;
 }

package/src/initiative-status/parser.ts

@@ -203,16 +203,16 @@ export function parseInitiativeStatus(content: string): ParsedInitiativeStatus {
       continue;
     }
 
-    // hide directive (no colon): `hide phase Planning, phase Review`
+    // hide directive (colon syntax): `hide phase:Planning, phase:Review`
     const hideMatch = trimmed.match(/^hide\s+(.+)/i);
     if (hideMatch && !trimmed.match(/^hide\s*\|/)) {
-      // Parse comma-separated tag-value pairs: `phase Planning, phase Review`
+      // Parse comma-separated tag:value pairs: `phase:Planning, phase:Review`
       const pairs = hideMatch[1].split(',');
       for (const pair of pairs) {
-        const tokens = pair.trim().split(/\s+/);
-        if (tokens.length >= 2) {
-          const groupKey = tokens[0].toLowerCase();
-          const value = tokens.slice(1).join(' ').toLowerCase();
+        const colonIdx = pair.indexOf(':');
+        if (colonIdx > 0) {
+          const groupKey = pair.substring(0, colonIdx).trim().toLowerCase();
+          const value = pair.substring(colonIdx + 1).trim().toLowerCase();
           if (groupKey && value) {
             if (!result.initialHiddenTagValues.has(groupKey)) {
               result.initialHiddenTagValues.set(groupKey, new Set());
@@ -231,7 +231,7 @@ export function parseInitiativeStatus(content: string): ParsedInitiativeStatus {
         const key = optMatch[1].toLowerCase();
         const value = optMatch[2].trim();
         // Only recognize known option keys (not node content)
-        if (key === 'active-tag' || key === 'sort') {
+        if (key === 'active-tag') {
           result.options[key] = value;
           continue;
         }
@@ -247,12 +247,6 @@ export function parseInitiativeStatus(content: string): ParsedInitiativeStatus {
         );
         continue;
       }
-      if (tagBlockMatch.deprecated) {
-        result.diagnostics.push(
-          makeDgmoError(lineNum, `'## ${tagBlockMatch.name}' is no longer supported — use 'tag ${tagBlockMatch.name}' instead`)
-        );
-        continue;
-      }
       currentTagGroup = {
         name: tagBlockMatch.name,
         alias: tagBlockMatch.alias,

package/src/kanban/parser.ts

@@ -27,10 +27,11 @@ const LEGACY_COLUMN_RE = /^==\s+(.+?)\s*(?:\[wip:\s*(\d+)\])?\s*==$/;
 
 /** Known kanban options (key-value). */
 const KNOWN_OPTIONS = new Set([
-  'color-off', 'hide',
+  'hide',
 ]);
 /** Known kanban boolean options (bare keyword = on). */
 const KNOWN_BOOLEANS = new Set<string>([
+  'no-auto-color',
 ]);
 
 // ============================================================
@@ -125,15 +126,11 @@ export function parseKanban(
       }
     }
 
-    // Tag group heading — `tag: Name` (new) or `## Name` (deprecated)
-    // Must be checked BEFORE OPTION_RE to prevent `tag: Rank` being swallowed as option
+    // Tag group heading — `tag Name`
+    // Must be checked BEFORE OPTION_RE to prevent `tag Rank` being swallowed as option
     if (!contentStarted) {
       const tagBlockMatch = matchTagBlockHeading(trimmed);
       if (tagBlockMatch) {
-        if (tagBlockMatch.deprecated) {
-          result.diagnostics.push(makeDgmoError(lineNumber, `'## ${tagBlockMatch.name}' is no longer supported — use 'tag: ${tagBlockMatch.name}' instead`));
-          continue;
-        }
         currentTagGroup = {
           name: tagBlockMatch.name,
           alias: tagBlockMatch.alias,

package/src/org/parser.ts

@@ -7,7 +7,7 @@ import {
   measureIndent,
   extractColor,
   parsePipeMetadata,
-  MULTIPLE_PIPE_WARNING,
+  MULTIPLE_PIPE_ERROR,
   parseFirstLine,
   OPTION_NOCOLON_RE,
 } from '../utils/parsing';
@@ -46,18 +46,19 @@ const METADATA_RE = /^([^:]+):\s*(.+)$/;
 
 /** Known org chart options (key-value). */
 const KNOWN_OPTIONS = new Set([
-  'direction', 'sub-node-label', 'hide', 'show-sub-node-count',
+  'sub-node-label', 'hide', 'show-sub-node-count',
 ]);
 /** Known org chart boolean options (bare keyword = on). */
 const KNOWN_BOOLEANS = new Set([
   'show-sub-node-count',
+  'direction-tb',
 ]);
 
 // ============================================================
 // Inference
 // ============================================================
 
-/** Returns true if content contains tag group headings (`tag: …` or `## …`), suggesting an org chart. */
+/** Returns true if content contains tag group headings (`tag …`), suggesting an org chart. */
 export function looksLikeOrg(content: string): boolean {
   for (const line of content.split('\n')) {
     const trimmed = line.trim();
@@ -169,10 +170,6 @@ export function parseOrg(
         pushError(lineNumber, 'Tag groups must appear before org content');
         continue;
       }
-      if (tagBlockMatch.deprecated) {
-        pushError(lineNumber, `'## ${tagBlockMatch.name}' is no longer supported — use 'tag: ${tagBlockMatch.name}' instead`);
-        continue;
-      }
       currentTagGroup = {
         name: tagBlockMatch.name,
         alias: tagBlockMatch.alias,
@@ -335,7 +332,7 @@ function parseNodeLabel(
   let rawLabel = segments[0];
   const { label, color } = extractColor(rawLabel, palette);
 
-  const metadata = parsePipeMetadata(segments, aliasMap, warnFn ? () => warnFn(lineNumber, MULTIPLE_PIPE_WARNING) : undefined);
+  const metadata = parsePipeMetadata(segments, aliasMap, warnFn ? () => warnFn(lineNumber, MULTIPLE_PIPE_ERROR) : undefined);
 
   return {
     id: `node-${counter}`,

package/src/org/resolver.ts

@@ -36,14 +36,14 @@ export interface ResolveImportsResult {
 const MAX_DEPTH = 10;
 const IMPORT_RE = /^(\s+)import:?\s+(.+\.dgmo)\s*$/i;
 const TAGS_RE = /^tags:?\s+(.+\.dgmo)\s*$/i;
-/** Matches new-style first line: `org ...` or old `chart: ...` or `title: ...` */
-const HEADER_RE = /^(org|kanban|chart\s*:|title\s*:)/i;
+/** Matches new-style first line: `org ...` or `kanban ...` or `title: ...` */
+const HEADER_RE = /^(org|kanban|title\s*:)/i;
 /**
  * Known option keys that can appear in org chart headers (space-separated).
  * Only these are stripped from imported files — avoids eating content like "Alice Chen".
  */
 const KNOWN_HEADER_OPTIONS = new Set([
-  'direction', 'sub-node-label', 'hide', 'show-sub-node-count',
+  'direction-tb', 'sub-node-label', 'hide', 'show-sub-node-count',
   'color-off',
 ]);
 

package/src/render.ts

@@ -36,8 +36,7 @@ async function ensureDom(): Promise<void> {
  * ```ts
  * import { render } from '@diagrammo/dgmo';
  *
- * const svg = await render(`chart: pie
- * title: Languages
+ * const svg = await render(`pie Languages
  * TypeScript: 45
  * Python: 30
  * Rust: 25`);

package/src/sequence/parser.ts

@@ -6,7 +6,7 @@ import { inferParticipantType } from './participant-inference';
 import type { DgmoError } from '../diagnostics';
 import { makeDgmoError, formatDgmoError, suggest } from '../diagnostics';
 import { parseArrow } from '../utils/arrows';
-import { measureIndent, extractColor, parsePipeMetadata, MULTIPLE_PIPE_WARNING, parseFirstLine, OPTION_NOCOLON_RE } from '../utils/parsing';
+import { measureIndent, extractColor, parsePipeMetadata, MULTIPLE_PIPE_ERROR, parseFirstLine, OPTION_NOCOLON_RE } from '../utils/parsing';
 import type { TagGroup } from '../utils/tag-groups';
 import { matchTagBlockHeading, validateTagValues } from '../utils/tag-groups';
 
@@ -185,17 +185,15 @@ const SECTION_PATTERN = /^==\s+(.+?)(?:\s*==)?\s*$/;
 // Arrow pattern for sequence inference — detects any arrow form
 const ARROW_PATTERN = /\S+\s*(?:<-\S+-|<~\S+~|-\S+->|~\S+~>|->|~>|<-|<~)\s*\S+/;
 
-// Note patterns — colon-free syntax
+// Note patterns — colon-free syntax only
 // Single-line: "note text", "note left text", "note right of X text", "note left X text"
 // Multi-line:  "note", "note right", "note right of X", "note left X" (body indented below)
-// Also supports legacy colon syntax: "note: text", "note right of X: text"
 //
 // The colon-free positioned form requires participant resolution — the parser
 // already has participant collection infrastructure, so we match the general
 // structure here and resolve participant vs text in the parsing logic.
-const NOTE_SINGLE_COLON = /^note(?:\s+(right|left)(?:\s+(?:of\s+)?(.+?))?)?\s*:\s*(.+)$/i;
 const NOTE_BARE = /^note\s+(.+)$/i;
-const NOTE_MULTI = /^note(?:\s+(right|left)(?:\s+(?:of\s+)?(.+?))?)?\s*:?\s*$/i;
+const NOTE_MULTI = /^note(?:\s+(right|left)(?:\s+(?:of\s+)?(.+?))?)?\s*$/i;
 
 /** Result of parseNoteLine — indicates what the parser should do. */
 type NoteParseResult =
@@ -208,10 +206,10 @@ type NoteParseResult =
  * Parse a note line, resolving participant names from the known participants list.
  *
  * Supports:
- * - `note: text` / `note text` — default position (right), last msg sender
- * - `note left of X: text` / `note left of X text` / `note left X text`
- * - `note right:` / `note right` — multi-line head
- * - `note right of X:` / `note right of X` / `note left X` — multi-line head
+ * - `note text` — default position (right), last msg sender
+ * - `note left of X text` / `note left X text`
+ * - `note right` — multi-line head
+ * - `note right of X` / `note left X` — multi-line head
  * - Quoted participant: `note left "Auth Service" text`
  */
 function parseNoteLine(
@@ -222,25 +220,12 @@ function parseNoteLine(
   const lower = trimmed.toLowerCase();
   if (!lower.startsWith('note')) return null;
   // Must be exactly "note" or "note " — not "notebook" etc.
-  if (trimmed.length > 4 && trimmed[4] !== ' ' && trimmed[4] !== ':') return null;
+  if (trimmed.length > 4 && trimmed[4] !== ' ') return null;
 
-  // 1. Try legacy colon-based syntax first
-  const colonMatch = trimmed.match(NOTE_SINGLE_COLON);
-  if (colonMatch) {
-    const position = (colonMatch[1]?.toLowerCase() as 'right' | 'left') || 'right';
-    let participantId = colonMatch[2] || null;
-    if (!participantId) {
-      if (!lastMsgFrom) return { kind: 'skip' };
-      participantId = lastMsgFrom;
-    }
-    if (!participants.some((p) => p.id === participantId)) return { kind: 'skip' };
-    return { kind: 'single', position, participantId, text: colonMatch[3].trim() };
-  }
-
-  // 2. Try multi-line head (no text after note): `note`, `note right`, `note right of X`, `note left X`
+  // 1. Try multi-line head (no text after note): `note`, `note right`, `note right of X`, `note left X`
   // NOTE: NOTE_MULTI's (.+?) can greedily capture "participant text" as one group.
-  // Only trust this match if the captured participant actually exists. Otherwise, fall
-  // through to the bare-note handler which does proper participant-aware splitting.
+  // Only trust this match if the captured participant actually exists. Otherwise,
+  // fall through to the bare-note handler which does proper participant-aware splitting.
   const multiMatch = trimmed.match(NOTE_MULTI);
   if (multiMatch) {
     const position = (multiMatch[1]?.toLowerCase() as 'right' | 'left') || 'right';
@@ -255,7 +240,7 @@ function parseNoteLine(
     // Participant not found — fall through to bare-note handler for proper resolution
   }
 
-  // 3. Bare note (colon-free): `note text` or `note left [of] X text`
+  // 2. Bare note: `note text` or `note left [of] X text`
   const bareMatch = trimmed.match(NOTE_BARE);
   if (bareMatch) {
     const rest = bareMatch[1].trim();
@@ -427,7 +412,7 @@ export function parseSequenceDgmo(content: string): ParsedSequenceDgmo {
     if (idx < 0) return { core: text };
     const core = text.substring(0, idx).trimEnd();
     const segments = text.substring(idx).split('|');
-    const warnFn = ln != null ? () => pushWarning(ln, MULTIPLE_PIPE_WARNING) : undefined;
+    const warnFn = ln != null ? () => pushError(ln, MULTIPLE_PIPE_ERROR) : undefined;
     const meta = parsePipeMetadata(segments, aliasMap, warnFn);
     return Object.keys(meta).length > 0 ? { core, meta } : { core };
   };
@@ -475,7 +460,7 @@ export function parseSequenceDgmo(content: string): ParsedSequenceDgmo {
       const afterBracket = groupMatch[3]?.trim() || '';
       if (afterBracket.startsWith('|')) {
         const segments = afterBracket.split('|');
-        const meta = parsePipeMetadata(segments, aliasMap, () => pushWarning(lineNumber, MULTIPLE_PIPE_WARNING));
+        const meta = parsePipeMetadata(segments, aliasMap, () => pushError(lineNumber, MULTIPLE_PIPE_ERROR));
         if (Object.keys(meta).length > 0) groupMeta = meta;
       }
 
@@ -531,9 +516,9 @@ export function parseSequenceDgmo(content: string): ParsedSequenceDgmo {
     }
 
     // ---- Tag group handling ----
-    // Tag block heading: "tag: Name [alias X]"
+    // Tag block heading: "tag Name [alias X]"
     const tagBlockMatch = matchTagBlockHeading(trimmed);
-    if (tagBlockMatch && !tagBlockMatch.deprecated) {
+    if (tagBlockMatch) {
       if (contentStarted) {
         pushError(lineNumber, 'Tag groups must appear before sequence content');
         continue;
@@ -608,14 +593,6 @@ export function parseSequenceDgmo(content: string): ParsedSequenceDgmo {
       } else {
       const value = trimmed.substring(colonIndex + 1).trim();
 
-      if (key === 'chart') {
-        hasExplicitChart = true;
-        if (value.toLowerCase() !== 'sequence') {
-          return fail(lineNumber, `Expected chart type "sequence", got "${value}"`);
-        }
-        continue;
-      }
-
       // Enforce headers-before-content
       if (contentStarted) {
         pushError(lineNumber, `Options like '${key}: ${value}' must appear before the first message or declaration`);
@@ -666,8 +643,9 @@ export function parseSequenceDgmo(content: string): ParsedSequenceDgmo {
     }
 
     // Parse "Name is a type [aka Alias]" declarations (always top-level)
+    // Skip lines starting with 'note' — handled by note parsing below
     const { core: isACore, meta: isAMeta } = splitPipe(trimmed, lineNumber);
-    const isAMatch = isACore.match(IS_A_PATTERN);
+    const isAMatch = !/^note(\s|$)/i.test(trimmed) ? isACore.match(IS_A_PATTERN) : null;
     if (isAMatch) {
       contentStarted = true;
       const id = isAMatch[1];
@@ -1049,12 +1027,11 @@ export function parseSequenceDgmo(content: string): ParsedSequenceDgmo {
       continue;
     }
 
-    // ---- Note parsing (colon-free + legacy colon syntax) ----
+    // ---- Note parsing (space-separated only) ----
     // Strategy:
-    // 1. Try colon-based syntax: `note right of X: text` (legacy, still supported)
-    // 2. Try bare note: `note text` — position defaults, text is everything after `note`
-    // 3. For positioned: `note left [of] X text` — needs participant lookup to split name vs text
-    // 4. Multi-line: `note`, `note right`, `note right [of] X` (body indented below)
+    // 1. Try bare note: `note text` — position defaults, text is everything after `note`
+    // 2. For positioned: `note left [of] X text` — needs participant lookup to split name vs text
+    // 3. Multi-line: `note`, `note right`, `note right [of] X` (body indented below)
     {
       const noteParsed = parseNoteLine(trimmed, result.participants, lastMsgFrom);
       if (noteParsed) {

package/src/sitemap/parser.ts

@@ -11,10 +11,8 @@ import {
   measureIndent,
   extractColor,
   parsePipeMetadata,
-  normalizeDirection,
   inferArrowColor,
-  MULTIPLE_PIPE_WARNING,
-  CHART_TYPE_RE,
+  MULTIPLE_PIPE_ERROR,
   TITLE_RE,
   OPTION_RE,
   parseFirstLine,
@@ -92,7 +90,7 @@ export function looksLikeSitemap(content: string): boolean {
     if (!trimmed || trimmed.startsWith('//')) continue;
 
     // Skip header lines
-    if (CHART_TYPE_RE.test(trimmed) || TITLE_RE.test(trimmed)) continue;
+    if (parseFirstLine(trimmed) || TITLE_RE.test(trimmed)) continue;
     if (isTagBlockHeading(trimmed)) continue;
 
     if (/^-.*->\s*.+/.test(trimmed) || /^->\s*.+/.test(trimmed)) {
@@ -124,7 +122,7 @@ export function parseSitemap(
   const result: ParsedSitemap = {
     title: null,
     titleLineNumber: null,
-    direction: 'TB',
+    direction: 'LR',
     roots: [],
     edges: [],
     tagGroups: [],
@@ -226,10 +224,6 @@ export function parseSitemap(
         pushError(lineNumber, 'Tag groups must appear before sitemap content');
         continue;
       }
-      if (tagBlockMatch.deprecated) {
-        pushError(lineNumber, `'## ${tagBlockMatch.name}' is no longer supported — use 'tag: ${tagBlockMatch.name}' instead`);
-        continue;
-      }
       currentTagGroup = {
         name: tagBlockMatch.name,
         alias: tagBlockMatch.alias,
@@ -247,16 +241,15 @@ export function parseSitemap(
     // Skip lines with `|` (pipe metadata) or `->` (arrows) — those are content
     if (!contentStarted && !currentTagGroup && measureIndent(line) === 0
         && !trimmed.includes('|') && !trimmed.includes('->')) {
+      // Bare boolean: direction-tb
+      if (/^direction-tb$/i.test(trimmed)) {
+        result.direction = 'TB';
+        continue;
+      }
+
       const optMatch = trimmed.match(OPTION_NOCOLON_RE);
       if (optMatch) {
         const key = optMatch[1].trim().toLowerCase();
-        if (key === 'direction' || key === 'orientation') {
-          const dir = normalizeDirection(optMatch[2]);
-          if (dir) {
-            result.direction = dir as SitemapDirection;
-          }
-          continue;
-        }
         result.options[key] = optMatch[2].trim();
         continue;
       }
@@ -440,7 +433,7 @@ function parseNodeLabel(
   const segments = trimmed.split('|').map((s) => s.trim());
   const rawLabel = segments[0];
   const { label, color } = extractColor(rawLabel, palette);
-  const metadata = parsePipeMetadata(segments, aliasMap, warnFn ? () => warnFn(lineNumber, MULTIPLE_PIPE_WARNING) : undefined);
+  const metadata = parsePipeMetadata(segments, aliasMap, warnFn ? () => warnFn(lineNumber, MULTIPLE_PIPE_ERROR) : undefined);
 
   return {
     id: `node-${counter}`,