You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: USAGE.md
+2Lines changed: 2 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -896,6 +896,8 @@ Only when every stage returns an empty list (or errors) does Mini-A log the issu
896
896
#### Visual Guidance
897
897
- **`usediagrams`** (boolean, default: false): Ask the model to produce Mermaid diagrams when sketching workflows or structures
898
898
- **`usecharts`** (boolean, default: false): Hint the model to provide Chart.js snippets for data visualization tasks. When combined with `usesvg=true` or `usevectors=true`, supported charts should still be emitted as chart configs instead of being drawn manually as SVG/vector art; SVG remains the fallback for unsupported chart forms or custom illustrations.
899
+
- **`usesvg`** (boolean, default: false): Prime the model to emit raw `svg` fenced blocks for infographics, annotated summaries, custom artwork, and other self-contained illustrations. Standard structural diagrams should still prefer Mermaid when supported.
900
+
- **`usevectors`** (boolean, default: false): Enable the combined vector bundle (`usesvg=true` + `usediagrams=true`). In practice this should prefer Mermaid for structural diagrams and SVG for infographics or custom visuals.
899
901
- **`useascii`** (boolean, default: false): Encourage enhanced UTF-8/ANSI visual output for rich terminal displays. When enabled, Mini-A guides the model to use:
"- Default to including a diagram, chart, or UTF-8/ANSI visual whenever structure, flow, hierarchy, metrics, or comparisons are involved.\n" +
729
-
"- Always pair the visual with a short caption (1-2 sentences) summarizing the insight.\n" +
727
+
var introLines = [
728
+
"Visual output guidance (concise):\n",
729
+
"- Default to including a diagram, chart, or UTF-8/ANSI visual whenever structure, flow, hierarchy, metrics, or comparisons are involved.",
730
+
"- Always pair the visual with a short caption (1-2 sentences) summarizing the insight.",
730
731
"- In your explanatory text and captions, refer only to the visual type (e.g., 'diagram', 'chart', 'table', 'map') without mentioning the technical implementation (Mermaid, Chart.js, Leaflet, ANSI codes, etc.)."
731
-
)
732
+
]
733
+
if (useSvg && (useCharts || useDiagrams)) {
734
+
introLines.push(
735
+
"- INTENT OVERRIDE — When the user's request contains words like 'infographic', 'poster', 'banner', 'flyer', 'draw', 'design', 'illustrate', 'layout', 'mockup', or 'wireframe', treat SVG as the primary output format immediately, regardless of other enabled modes. Do not default to a chart or Mermaid diagram for these requests."
" - For custom illustrations, output a ```svg``` fenced block with complete `<svg>...</svg>` markup.\n" +
874
-
" - In vector/infographic mode, default to a polished SVG infographic whenever visuals improve understanding.\n" +
881
+
" - In vector/infographic mode, use SVG primarily for infographics, annotated summaries, custom artwork, technical drawings, and UI mockups rather than standard structural diagrams.\n" +
875
882
" - If chart rendering guidance is also enabled, do NOT draw ordinary charts in SVG/vector form when a supported chart type can be expressed with the chart fence; reserve SVG for unsupported chart designs or non-chart custom visuals.\n" +
876
883
" - Build the infographic for fast scanning: headline, clear sections, visual hierarchy, concise labels, and callouts.\n" +
" - Use this format for custom illustrations, icons, technical drawings, annotated diagrams, infographics, geometric patterns, and UI mockups.\n" +
884
-
" - Prefer Mermaid for standard flow/sequence/entity/timeline-style diagrams when Mermaid types apply."
891
+
" - Prefer Mermaid for standard flow, sequence, entity, architecture, dependency, and timeline-style structural diagrams when Mermaid types apply."
885
892
)
893
+
894
+
if (isMap(browserContext) && Object.keys(browserContext).length > 0) {
895
+
visualParts.push(
896
+
"Browser context hints for SVG/vector rendering:\n" +
897
+
" - Use this browser context to tune layout density, typography scale, and contrast for the expected viewport.\n" +
898
+
" - Keep SVG dimensions and composition aligned with the available panel width to avoid clipping.\n" +
899
+
" - browserContext:\n" +
900
+
" ```json\n" +
901
+
stringify(browserContext, __, " ") + "\n" +
902
+
" ```"
903
+
)
904
+
}
886
905
}
887
906
888
907
var checklist = "\n\nVisual selection checklist:"
889
908
var nextIndex = 1
909
+
if (useSvg && (useCharts || useDiagrams)) {
910
+
checklist += "\n" + nextIndex + ". User says 'infographic', 'poster', 'banner', 'flyer', 'draw', 'design', 'illustrate', 'layout', 'mockup', or 'wireframe' -> SVG is the primary output; charts or Mermaid diagrams may appear as embedded sub-elements only if they genuinely help."
911
+
nextIndex++
912
+
}
890
913
if (useDiagrams) {
891
914
checklist += "\n" + nextIndex + ". Relationships or flows -> diagram with graph or sequence."
checklist += "\n" + nextIndex + ". Rich infographic, annotated summary, or custom illustration -> use a self-contained SVG block with safe static elements only."
928
951
nextIndex++
929
-
checklist += "\n" + nextIndex + ". Standard process/flow/timeline diagrams -> prefer Mermaid when a supported type exists; otherwise use a custom illustration."
952
+
checklist += "\n" + nextIndex + ". Standard process/flow/timeline/architecture diagrams -> prefer Mermaid when a supported type exists; otherwise use a custom illustration."
930
953
nextIndex++
931
954
}
932
955
checklist += "\n\nIf no visual type above applies to the user's request (e.g., purely narrative or conversational queries), you may provide text-only output without explanation."
0 commit comments