sketchmark 1.1.5 → 1.1.6

package/README.md

@@ -263,17 +263,28 @@ Every diagram follows this structure:
 ```
 diagram
 [title label="My Title"]
-[layout row|column|grid]
+[layout row|column|grid|absolute]
 [config key=value ...]
 [theme name fill="..." stroke="..." color="..."]
 
 [nodes, edges, groups, tables, charts, markdown blocks]
 
-[step action target ...]
-end
-```
-
-- Lines starting with `#` or `//` are comments.
+[step action target ...]
+end
+```
+
+When `layout=absolute`, authored elements use `x`/`y` coordinates instead of flow layout:
+
+```
+diagram
+layout absolute
+box start  x=40  y=60  label="Start"
+box finish x=240 y=140 label="Finish"
+start --> finish
+end
+```
+
+- Lines starting with `#` or `//` are comments.
 - All key-value attributes use the `key=value` or `key="quoted value"` syntax.
 - The DSL is **whitespace-sensitive** — do not indent lines.
 
@@ -327,10 +338,12 @@ note    myNote label="Remember this!"
 
 | Property | Type | Description | Example |
 |----------|------|-------------|---------|
-| `label` | string | Display text (required) | `label="Hello World"` |
-| `width` | number | Override auto-width (px) | `width=140` |
-| `height` | number | Override auto-height (px) | `height=55` |
-| `theme` | string | Named theme preset | `theme=primary` |
+| `label` | string | Display text (required) | `label="Hello World"` |
+| `width` | number | Override auto-width (px) | `width=140` |
+| `height` | number | Override auto-height (px) | `height=55` |
+| `x` | number | Authored X position when parent/root uses `layout=absolute` | `x=80` |
+| `y` | number | Authored Y position when parent/root uses `layout=absolute` | `y=40` |
+| `theme` | string | Named theme preset | `theme=primary` |
 | `fill` | CSS color | Background fill color | `fill="#e8f4ff"` |
 | `stroke` | CSS color | Border/outline color | `stroke="#0044cc"` |
 | `stroke-width` | number | Border thickness | `stroke-width=2` |
@@ -349,8 +362,8 @@ note    myNote label="Remember this!"
 | `name` | string | Iconify icon name (for `icon`) | `name="mdi:cog"` |
 | `value` | string | SVG path data (for `path`) | `value="M 0 0 L 50 0"` |
 | `deg` | number | Static rotation (degrees) | `deg=45` |
-| `dx` | number | Static X translation (px) | `dx=20` |
-| `dy` | number | Static Y translation (px) | `dy=-10` |
+| `dx` | number | Static visual X translation after layout (px) | `dx=20` |
+| `dy` | number | Static visual Y translation after layout (px) | `dy=-10` |
 | `factor` | number | Static scale factor | `factor=1.2` |
 
 ---
@@ -420,12 +433,12 @@ group outer label="Outer Group" layout=column items=[a,b,inner]
 General form:
 
 ```
-group <id> [label="..."] [layout=row|column|grid] [gap=N] [padding=N]
-           [columns=N] [align=start|center|end]
-           [justify=start|center|end|space-between|space-around]
-           [theme=...] [fill="..."] [stroke="..."] [width=N] [height=N]
-           [items=[id1,id2,...]]
-```
+group <id> [label="..."] [layout=row|column|grid|absolute] [gap=N] [padding=N]
+           [columns=N] [align=start|center|end]
+           [justify=start|center|end|space-between|space-around]
+           [theme=...] [fill="..."] [stroke="..."] [x=N] [y=N] [width=N] [height=N]
+           [items=[id1,id2,...]]
+```
 
 - Groups are always declared at the top level.
 - `items` order is the visual child order.
@@ -437,18 +450,22 @@ group <id> [label="..."] [layout=row|column|grid] [gap=N] [padding=N]
 | Property | Type | Description |
 |----------|------|-------------|
 | `label` | string | Group title (shown at top) |
-| `layout` | row / column / grid | Child arrangement direction |
-| `gap` | number | Space between children (px) |
-| `padding` | number | Inner padding (px) |
-| `columns` | number | Column count (for `layout=grid`) |
-| `align` | start/center/end | Cross-axis alignment (align-items) |
-| `justify` | start/center/end/space-between/space-around | Main-axis alignment |
-| `width` | number | Minimum width override |
-| `height` | number | Minimum height override |
-| `theme` | string | Named theme preset |
-| `fill` | CSS color | Background color |
-| `stroke` | CSS color | Border color |
-| `stroke-width` | number | Border thickness |
+| `layout` | row / column / grid / absolute | Child arrangement direction |
+| `gap` | number | Space between children (px) |
+| `padding` | number | Inner padding (px) |
+| `columns` | number | Column count (for `layout=grid`) |
+| `align` | start/center/end | Cross-axis alignment (align-items) |
+| `justify` | start/center/end/space-between/space-around | Main-axis alignment |
+| `x` | number | Authored X position when parent/root uses `layout=absolute` |
+| `y` | number | Authored Y position when parent/root uses `layout=absolute` |
+| `width` | number | Minimum width override |
+| `height` | number | Minimum height override |
+| `theme` | string | Named theme preset |
+| `fill` | CSS color | Background color |
+| `stroke` | CSS color | Border color |
+| `stroke-width` | number | Border thickness |
+
+For absolute groups, child `x`/`y` coordinates are relative to the group's inner content box.
 
 #### `bare` keyword
 
@@ -465,7 +482,7 @@ bare myContainer layout=row items=[a,b]
 ## Tables
 
 ```
-table <id> [label="..."] [theme=...] [fill="..."] [stroke="..."]
+table <id> [label="..."] [x=N] [y=N] [theme=...] [fill="..."] [stroke="..."]
 {
   header Col1 Col2 Col3
   row    "Value A" "Value B" "Value C"
@@ -473,18 +490,19 @@ table <id> [label="..."] [theme=...] [fill="..."] [stroke="..."]
 }
 ```
 
-- `header` rows get a shaded background and bold text.
-- `row` rows use regular styling.
-- `"value"` must use a double-quoted string literal. 
-- Column widths auto-size to content.
-- Tables support `fill`, `stroke`, `color`, `font-size`, `font`, `text-align`, `letter-spacing`, `theme`, `opacity` style props (same as nodes).
+- `header` rows get a shaded background and bold text.
+- `row` rows use regular styling.
+- `"value"` must use a double-quoted string literal. 
+- Column widths auto-size to content.
+- Tables support `fill`, `stroke`, `color`, `font-size`, `font`, `text-align`, `letter-spacing`, `theme`, `opacity` style props (same as nodes).
+- Tables also accept `x` and `y` when the parent/root uses `layout=absolute`.
 
 ---
 
 ## Charts
 
 ```
-<chart-type> <id> [label="Title"] [width=N] [height=N] [theme=...] [style props]
+<chart-type> <id> [label="Title"] [x=N] [y=N] [width=N] [height=N] [theme=...] [style props]
 data
   [["Category", "Series1", "Series2"],
    ["Jan", 120, 80],
@@ -512,13 +530,15 @@ data
    ["Mar", 1100, 750]]
 
 # Pie chart example
-pie-chart share label="Market Share" width=300 height=240
-data
-  [["Company", "Share"],
-   ["Alpha", 42],
-   ["Beta", 31],
-   ["Gamma", 27]]
-```
+pie-chart share label="Market Share" width=300 height=240
+data
+  [["Company", "Share"],
+   ["Alpha", 42],
+   ["Beta", 31],
+   ["Gamma", 27]]
+```
+
+Charts also accept `x` and `y` when the parent/root uses `layout=absolute`.
 
 ---
 
@@ -527,7 +547,7 @@ data
 Renders inline rich text with headings and bold/italic:
 
 ```
-markdown <id> [width=N] [height=N] [theme=...] [style props]
+markdown <id> [x=N] [y=N] [width=N] [height=N] [theme=...] [style props]
 """
 # Heading 1
 ## Heading 2
@@ -539,9 +559,10 @@ Another paragraph here.
 """
 ```
 
-- Triple-quote `"""` delimiters for the content block.
-- Supported formatting: `# H1`, `## H2`, `### H3`, `**bold**`, `*italic*`, blank lines.
-- Style props: `color`, `font`, `font-size`, `text-align`, `padding`, `fill`, `stroke`, `opacity`, `letter-spacing`.
+- Triple-quote `"""` delimiters for the content block.
+- Supported formatting: `# H1`, `## H2`, `### H3`, `**bold**`, `*italic*`, blank lines.
+- Style props: `color`, `font`, `font-size`, `text-align`, `padding`, `fill`, `stroke`, `opacity`, `letter-spacing`.
+- Markdown blocks also accept `x` and `y` when the parent/root uses `layout=absolute`.
 
 ---
 
@@ -974,9 +995,11 @@ exportHTML(instance.svg, dslSource, { filename: 'diagram.html' });
 
 ## Supported vs Unsupported Features
 
-### Nodes
-
-| Feature | Supported | Notes |
+### Nodes
+
+Nodes can also opt into authored absolute `x`/`y` positioning when their parent or the root diagram uses `layout=absolute`.
+
+| Feature | Supported | Notes |
 |---------|-----------|-------|
 | box | ✅ | Default shape |
 | circle | ✅ | |
@@ -1016,9 +1039,11 @@ exportHTML(instance.svg, dslSource, { filename: 'diagram.html' });
 | Multiple edges between same nodes | ✅ | Stack visually |
 | Edge from/to groups | ✅ | Uses group center |
 
-### Groups
-
-| Feature | Supported | Notes |
+### Groups
+
+Groups support `layout=absolute` in addition to flow layouts. In absolute groups, child `x`/`y` coordinates are measured from the group's inner content box.
+
+| Feature | Supported | Notes |
 |---------|-----------|-------|
 | Nested groups | ✅ | Unlimited depth |
 | Row / column / grid layout | ✅ | |
@@ -1101,7 +1126,7 @@ exportHTML(instance.svg, dslSource, { filename: 'diagram.html' });
 | `end` | Structure | `end` |
 | `title` | Meta | `title label="My Diagram"` |
 | `description` | Meta | `description "Some text"` |
-| `layout` | Meta | `layout row` / `layout column` / `layout grid` |
+| `layout` | Meta | `layout row` / `layout column` / `layout grid` / `layout absolute` |
 | `config` | Meta | `config gap=60` |
 | `theme` | Styling | `theme primary fill="#e8f4ff" stroke="#0044cc" color="#003399"` |
 | `style` | Styling | `style nodeId fill="#ff0" stroke="#000"` |

package/dist/ast/types.d.ts

@@ -1,6 +1,6 @@
 export type NodeShape = 'box' | 'circle' | 'diamond' | 'hexagon' | 'triangle' | 'cylinder' | 'parallelogram' | 'text' | 'image' | 'icon' | 'note' | 'line' | 'path';
 export type EdgeConnector = '->' | '<-' | '<->' | '-->' | '<-->' | '---' | '--';
-export type LayoutType = 'row' | 'column' | 'grid';
+export type LayoutType = 'row' | 'column' | 'grid' | 'absolute';
 export type AlignItems = 'start' | 'center' | 'end';
 export type JustifyContent = 'start' | 'center' | 'end' | 'space-between' | 'space-around';
 export type AnimationAction = 'highlight' | 'fade' | 'unfade' | 'draw' | 'erase' | 'show' | 'hide' | 'pulse' | 'move' | 'color' | 'scale' | 'rotate' | 'narrate' | 'circle' | 'underline' | 'crossout' | 'bracket' | 'tick' | 'strikeoff';
@@ -65,6 +65,8 @@ export interface ASTNode {
     pathData?: string;
     width?: number;
     height?: number;
+    x?: number;
+    y?: number;
     deg?: number;
     dx?: number;
     dy?: number;
@@ -98,6 +100,8 @@ export interface ASTGroup {
     justify?: JustifyContent;
     theme?: string;
     style?: StyleProps;
+    x?: number;
+    y?: number;
     width?: number;
     height?: number;
 }
@@ -133,6 +137,8 @@ export interface ASTChart {
     data: ASTChartData;
     width?: number;
     height?: number;
+    x?: number;
+    y?: number;
     theme?: string;
     style?: StyleProps;
 }
@@ -145,6 +151,8 @@ export interface ASTTable {
     id: string;
     label: string;
     rows: ASTTableRow[];
+    x?: number;
+    y?: number;
     theme?: string;
     style?: StyleProps;
 }
@@ -154,6 +162,8 @@ export interface ASTMarkdown {
     content: string;
     width?: number;
     height?: number;
+    x?: number;
+    y?: number;
     theme?: string;
     style?: StyleProps;
 }

package/dist/ast/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/ast/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/ast/types.ts"],"names":[],"mappings":"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"}

package/dist/index.cjs

@@ -504,6 +504,8 @@ function parse(src) {
             label: props.label || "",
             ...(props.width ? { width: parseFloat(props.width) } : {}),
             ...(props.height ? { height: parseFloat(props.height) } : {}),
+            ...(props.x ? { x: parseFloat(props.x) } : {}),
+            ...(props.y ? { y: parseFloat(props.y) } : {}),
             ...(props.deg ? { deg: parseFloat(props.deg) } : {}),
             ...(props.dx ? { dx: parseFloat(props.dx) } : {}),
             ...(props.dy ? { dy: parseFloat(props.dy) } : {}),
@@ -542,6 +544,12 @@ function parse(src) {
             style: propsToStyle(props),
             ...(props.width ? { width: parseFloat(props.width) } : {}),
             ...(props.height ? { height: parseFloat(props.height) } : {}),
+            ...(props.x ? { x: parseFloat(props.x) } : {}),
+            ...(props.y ? { y: parseFloat(props.y) } : {}),
+            ...(props.deg ? { deg: parseFloat(props.deg) } : {}),
+            ...(props.dx ? { dx: parseFloat(props.dx) } : {}),
+            ...(props.dy ? { dy: parseFloat(props.dy) } : {}),
+            ...(props.factor ? { factor: parseFloat(props.factor) } : {}),
         };
     }
     function parseGroup() {
@@ -581,6 +589,8 @@ function parse(src) {
             justify: props.justify,
             theme: props.theme,
             style: propsToStyle(props),
+            x: props.x !== undefined ? parseFloat(props.x) : undefined,
+            y: props.y !== undefined ? parseFloat(props.y) : undefined,
             width: props.width !== undefined ? parseFloat(props.width) : undefined,
             height: props.height !== undefined ? parseFloat(props.height) : undefined,
         };
@@ -752,6 +762,8 @@ function parse(src) {
             chartType: chartType.replace("-chart", ""),
             label: props.label ?? props.title,
             data: { headers, rows },
+            x: props.x ? parseFloat(props.x) : undefined,
+            y: props.y ? parseFloat(props.y) : undefined,
             width: props.width ? parseFloat(props.width) : undefined,
             height: props.height ? parseFloat(props.height) : undefined,
             theme: props.theme,
@@ -777,6 +789,8 @@ function parse(src) {
             id,
             label: props.label ?? "",
             rows: [],
+            x: props.x ? parseFloat(props.x) : undefined,
+            y: props.y ? parseFloat(props.y) : undefined,
             theme: props.theme,
             style: propsToStyle(props),
         };
@@ -832,6 +846,8 @@ function parse(src) {
             kind: "markdown",
             id,
             content: content.trim(),
+            x: props.x ? parseFloat(props.x) : undefined,
+            y: props.y ? parseFloat(props.y) : undefined,
             width: props.width ? parseFloat(props.width) : undefined,
             height: props.height ? parseFloat(props.height) : undefined,
             theme: props.theme,
@@ -3440,6 +3456,8 @@ function buildSceneGraph(ast) {
             groupId: nodeParentById.get(n.id),
             width: n.width,
             height: n.height,
+            authoredX: n.x,
+            authoredY: n.y,
             deg: n.deg,
             dx: n.dx,
             dy: n.dy,
@@ -3468,6 +3486,8 @@ function buildSceneGraph(ast) {
             align: (g.align ?? "start"),
             justify: (g.justify ?? "start"),
             style: { ...ast.styles[g.id], ...themeStyle, ...g.style },
+            authoredX: g.x,
+            authoredY: g.y,
             width: g.width,
             height: g.height,
             x: 0,
@@ -3487,6 +3507,8 @@ function buildSceneGraph(ast) {
             headerH: TABLE.headerH,
             labelH: TABLE.labelH,
             style: { ...ast.styles[t.id], ...themeStyle, ...t.style },
+            authoredX: t.x,
+            authoredY: t.y,
             x: 0,
             y: 0,
             w: 0,
@@ -3501,6 +3523,8 @@ function buildSceneGraph(ast) {
             label: c.label,
             data: c.data,
             style: { ...ast.styles[c.id], ...themeStyle, ...c.style },
+            authoredX: c.x,
+            authoredY: c.y,
             x: 0,
             y: 0,
             w: c.width ?? CHART.defaultW,
@@ -3516,6 +3540,8 @@ function buildSceneGraph(ast) {
             style: { ...ast.styles[m.id], ...themeStyle, ...m.style },
             width: m.width,
             height: m.height,
+            authoredX: m.x,
+            authoredY: m.y,
             x: 0,
             y: 0,
             w: 0,
@@ -4363,6 +4389,12 @@ function iW(r, em) {
 function iH(r, em) {
     return em.get(r.id).h;
 }
+function iAuthX(r, em) {
+    return em.get(r.id).authoredX ?? 0;
+}
+function iAuthY(r, em) {
+    return em.get(r.id).authoredY ?? 0;
+}
 function setPos(r, x, y, em) {
     const e = em.get(r.id);
     e.x = Math.round(x);
@@ -4409,6 +4441,12 @@ function measure(g, gm, tm, cm, mdm, em) {
         g.w = cols * cellW + (cols - 1) * gap + pad * 2;
         g.h = rows * cellH + (rows - 1) * gap + pad * 2 + labelH;
     }
+    else if (layout === "absolute") {
+        const maxRight = Math.max(0, ...kids.map((r) => iAuthX(r, em) + iW(r, em)));
+        const maxBottom = Math.max(0, ...kids.map((r) => iAuthY(r, em) + iH(r, em)));
+        g.w = maxRight + pad * 2;
+        g.h = maxBottom + pad * 2 + labelH;
+    }
     else {
         // column (default)
         g.w = Math.max(...ws) + pad * 2;
@@ -4499,6 +4537,11 @@ function place(g, gm, em) {
             setPos(ref, contentX + (i % cols) * (cellW + gap), contentY + Math.floor(i / cols) * (cellH + gap), em);
         });
     }
+    else if (layout === "absolute") {
+        kids.forEach((ref) => {
+            setPos(ref, contentX + iAuthX(ref, em), contentY + iAuthY(ref, em), em);
+        });
+    }
     else {
         // column (default)
         const ws = kids.map((r) => iW(r, em));
@@ -4681,6 +4724,7 @@ function layout(sg) {
     const rootCols = Number(sg.config["columns"] ?? 1);
     const useGrid = rootLayout === "grid" && rootCols > 0;
     const useColumn = rootLayout === "column";
+    const useAbsolute = rootLayout === "absolute";
     if (useGrid) {
         // ── Grid: per-row heights, per-column widths (no wasted space) ──
         const cols = rootCols;
@@ -4712,6 +4756,13 @@ function layout(sg) {
             e.y = rowY[Math.floor(idx / cols)];
         });
     }
+    else if (useAbsolute) {
+        for (const ref of rootOrder) {
+            const e = em.get(ref.id);
+            e.x = MARGIN + (e.authoredX ?? 0);
+            e.y = MARGIN + (e.authoredY ?? 0);
+        }
+    }
     else {
         // ── Row or Column linear flow ──────────────────────────
         let pos = MARGIN;