schematex 0.5.0 → 0.5.2

package/README.md

@@ -29,13 +29,13 @@
 
 ---
 
-**Schematex** is the open-source rendering engine for the diagrams professionals actually use — medical, electrical, legal, and analytical. 30 diagram families across nine domains:
+**Schematex** is the open-source rendering engine for the diagrams professionals actually use — medical, electrical, legal, and analytical. 31 diagram families across nine domains:
 
 - 👪 **Relationships** — genograms, ecomaps, pedigrees, sociograms, phylogenetic trees
 - ⚡ **Electrical & Industrial** — ladder logic, single-line diagrams, circuit schematics, logic gates, timing, block diagrams, **FBD**, **SFC**, breadboard, **P&ID** (ISA-5.1)
 - 🏢 **Corporate & Legal** — entity structures, cap tables
 - 🐟 **Causality & Analysis** — fishbone / Ishikawa, decision trees (Howard-Raiffa EV · CART/sklearn · taxonomy)
-- 🔄 **Behavior modeling** — UML 2.5 / Harel **state diagrams** (Mermaid-compatible superset), **BPMN 2.0** (OMG), **use case diagrams** (UML 2.5.1 §18)
+- 🔄 **Behavior modeling** — UML 2.5 / Harel **state diagrams** (Mermaid-compatible superset), **BPMN 2.0** (OMG), **use case diagrams** (UML 2.5.1 §18), **sequence diagrams** (UML 2.5.1 §17 — all 12 combined fragments + `ref`)
 - 🗄️ **Data modeling** — ERD crow's-foot notation
 - 🗓️ **Project management** — **PERT / CPM** networks (PMBOK 7) that *compute* the schedule: ES/EF/LS/LF, slack, critical path, three-point estimation, swimlanes, time-scaled layout
 - 📅 **Timelines** — proportional / equidistant / log axis · swimlane · gantt · lollipop · BC dates · geological Ma scale
@@ -73,7 +73,7 @@ import { render } from 'schematex/genogram';
 
 ## Gallery
 
-30 diagram types, one unified pipeline. **Try any of these live at [schematex.dev/playground](https://schematex.dev/playground).**
+31 diagram types, one unified pipeline. **Try any of these live at [schematex.dev/playground](https://schematex.dev/playground).**
 
 ### 👪 Genogram — *McGoldrick family-systems standard*
 
@@ -538,16 +538,24 @@ Written by humans, shaped by what LLMs get wrong.
 
 ```ts
 // Universal entry — auto-detects diagram type from first keyword
-import { render, parse } from 'schematex';
+import { render, renderPreview, renderResult, parse, parseResult } from 'schematex';
 
-const svg = render(text, config?);      // → SVG string
-const ast = parse(text, config?);       // → AST (JSON-serializable)
+const svg = render(text, config?);              // strict → SVG string or throw
+const ast = parse(text, config?);               // strict → AST or throw
+const previewSvg = renderPreview(text, config?); // always → SVG, including a visible diagnostic fallback
+const renderState = renderResult(text, config?); // → SVG + diagnostics + valid/partial/invalid status
+const parseState = parseResult(text, config?);   // → AST or diagnostics without throwing
 
 // Per-diagram tree-shaking
 import { render } from 'schematex/genogram';
 
 // Browser DOM
-import { renderToElement, renderToContainer } from 'schematex/browser';
+import {
+  renderToElement,
+  renderToContainer,
+  renderPreviewToElement,
+  renderPreviewToContainer,
+} from 'schematex/browser';
 container.appendChild(renderToElement(dsl));
 
 // React

package/dist/ai/ai-sdk.cjs

@@ -1,9 +1,9 @@
 'use strict';
 
-var chunkNWPCY65Z_cjs = require('../chunk-NWPCY65Z.cjs');
-require('../chunk-3YUUC6RN.cjs');
+var chunkHK56GQQP_cjs = require('../chunk-HK56GQQP.cjs');
+require('../chunk-4QPDZJAL.cjs');
 require('../chunk-QUKVGHN4.cjs');
-require('../chunk-XRCY75UV.cjs');
+require('../chunk-QMTWG6JL.cjs');
 require('../chunk-SUIDD2C5.cjs');
 require('../chunk-N7W5KZK7.cjs');
 require('../chunk-3M6WB62Y.cjs');
@@ -31,16 +31,22 @@ var schematexTools = {
   listDiagrams: ai.tool({
     description: "List every Schematex diagram type with a tagline, 'use when' hint, domain cluster, and authoritative standard. Call this first to discover what's available.",
     inputSchema: zod.z.object({}),
-    execute: async () => chunkNWPCY65Z_cjs.listDiagrams()
+    execute: async () => chunkHK56GQQP_cjs.listDiagrams()
   }),
   getSyntax: ai.tool({
-    description: "Return a compact syntax reference for one diagram type \u2014 rules, grammar (EBNF), and inline examples. Trimmed for LLM consumption (~2,000\u20134,000 tokens). Call after listDiagrams once you've chosen a type.",
+    description: "Return syntax for one diagram type. Default `detail: canonical` is the compact first-shot generation path: canonical header, preferred forms, rules, and repair checks. Request `detail: reference` only for advanced forms or imported adapters after choosing a type.",
     inputSchema: zod.z.object({
       type: zod.z.string().describe(
         "Diagram type id from listDiagrams (e.g. 'genogram', 'sld', 'fishbone')."
+      ),
+      detail: zod.z.enum(["canonical", "reference"]).optional().describe(
+        "Default `canonical` is best for generation. Use `reference` for the fuller grammar/tutorial."
       )
     }),
-    execute: async ({ type }) => chunkNWPCY65Z_cjs.getSyntax(type)
+    execute: async ({
+      type,
+      detail
+    }) => chunkHK56GQQP_cjs.getSyntax(type, { detail })
   }),
   getExamples: ai.tool({
     description: "Return curated real-world DSL examples for a diagram type, each with scenario notes and tags. Use as few-shot context before generating DSL.",
@@ -50,26 +56,26 @@ var schematexTools = {
       preferFeatured: zod.z.boolean().optional().describe("Rank featured examples first."),
       maxComplexity: zod.z.number().int().min(1).max(5).optional().describe("Only return examples with complexity <= this value (1=simplest).")
     }),
-    execute: async (args) => chunkNWPCY65Z_cjs.getExamples(args.type, {
+    execute: async (args) => chunkHK56GQQP_cjs.getExamples(args.type, {
       limit: args.limit,
       preferFeatured: args.preferFeatured,
       maxComplexity: args.maxComplexity
     })
   }),
   validateDsl: ai.tool({
-    description: "Validate Schematex DSL. Returns { ok: true } or { ok: false, errors: [{line, column, message, source}] }. Call before returning DSL to the user and self-correct on errors.",
+    description: "Validate Schematex DSL. Pass the selected diagram `type` whenever you know it. Returns { ok: true } or { ok: false, errors: [{line, column, message, source, hint}] }. Call before returning DSL and self-correct on errors.",
     inputSchema: zod.z.object({
       type: zod.z.string().optional().describe(
-        "Diagram type. Optional \u2014 Schematex auto-detects from the first line if omitted."
+        "Selected diagram type. Optional for adapters/autodetect, but explicit canonical types are more robust."
       ),
       dsl: zod.z.string().describe("The DSL source text to validate.")
     }),
-    execute: async ({ type, dsl }) => chunkNWPCY65Z_cjs.validateDsl(type, dsl)
+    execute: async ({ type, dsl }) => chunkHK56GQQP_cjs.validateDsl(type, dsl)
   }),
   renderDsl: ai.tool({
     description: "Render Schematex DSL to an SVG string. Returns { ok: true, svg } or { ok: false, errors }. Use when the caller needs the actual diagram output, not just validation.",
     inputSchema: zod.z.object({
-      type: zod.z.string().optional().describe("Diagram type (auto-detected if omitted)."),
+      type: zod.z.string().optional().describe("Selected diagram type. Prefer passing it once chosen."),
       dsl: zod.z.string().describe("The DSL source text to render."),
       theme: zod.z.string().optional().describe("Theme name, e.g. 'default' or 'dark'."),
       padding: zod.z.number().optional().describe("Outer padding in pixels.")
@@ -79,7 +85,7 @@ var schematexTools = {
       dsl,
       theme,
       padding
-    }) => chunkNWPCY65Z_cjs.renderDsl(type, dsl, { theme, padding })
+    }) => chunkHK56GQQP_cjs.renderDsl(type, dsl, { theme, padding })
   })
 };
 

package/dist/ai/ai-sdk.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/ai/ai-sdk.ts"],"names":["tool","z","listDiagrams","getSyntax","getExamples","validateDsl","renderDsl"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCO,IAAM,cAAA,GAAiB;AAAA,EAC5B,cAAcA,OAAA,CAAK;AAAA,IACjB,WAAA,EACE,8JAAA;AAAA,IACF,WAAA,EAAaC,KAAA,CAAE,MAAA,CAAO,EAAE,CAAA;AAAA,IACxB,OAAA,EAAS,YAAYC,8BAAA;AAAiB,GACvC,CAAA;AAAA,EAED,WAAWF,OAAA,CAAK;AAAA,IACd,WAAA,EACE,sNAAA;AAAA,IACF,WAAA,EAAaC,MAAE,MAAA,CAAO;AAAA,MACpB,IAAA,EAAMA,KAAA,CACH,MAAA,EAAO,CACP,QAAA;AAAA,QACC;AAAA;AACF,KACH,CAAA;AAAA,IACD,SAAS,OAAO,EAAE,IAAA,EAAK,KAAwBE,4BAAc,IAAI;AAAA,GAClE,CAAA;AAAA,EAED,aAAaH,OAAA,CAAK;AAAA,IAChB,WAAA,EACE,8IAAA;AAAA,IACF,WAAA,EAAaC,MAAE,MAAA,CAAO;AAAA,MACpB,IAAA,EAAMA,KAAA,CAAE,MAAA,EAAO,CAAE,SAAS,kBAAkB,CAAA;AAAA,MAC5C,KAAA,EAAOA,KAAA,CACJ,MAAA,EAAO,CACP,KAAI,CACJ,GAAA,CAAI,CAAC,CAAA,CACL,IAAI,EAAE,CAAA,CACN,QAAA,EAAS,CACT,SAAS,qCAAqC,CAAA;AAAA,MACjD,gBAAgBA,KAAA,CACb,OAAA,GACA,QAAA,EAAS,CACT,SAAS,+BAA+B,CAAA;AAAA,MAC3C,aAAA,EAAeA,KAAA,CACZ,MAAA,EAAO,CACP,KAAI,CACJ,GAAA,CAAI,CAAC,CAAA,CACL,IAAI,CAAC,CAAA,CACL,QAAA,EAAS,CACT,SAAS,kEAAkE;AAAA,KAC/E,CAAA;AAAA,IACD,OAAA,EAAS,OAAO,IAAA,KAMdG,6BAAA,CAAgB,KAAK,IAAA,EAAM;AAAA,MACzB,OAAO,IAAA,CAAK,KAAA;AAAA,MACZ,gBAAgB,IAAA,CAAK,cAAA;AAAA,MACrB,eAAe,IAAA,CAAK;AAAA,KACrB;AAAA,GACJ,CAAA;AAAA,EAED,aAAaJ,OAAA,CAAK;AAAA,IAChB,WAAA,EACE,6KAAA;AAAA,IACF,WAAA,EAAaC,MAAE,MAAA,CAAO;AAAA,MACpB,IAAA,EAAMA,KAAA,CACH,MAAA,EAAO,CACP,UAAS,CACT,QAAA;AAAA,QACC;AAAA,OACF;AAAA,MACF,GAAA,EAAKA,KAAA,CAAE,MAAA,EAAO,CAAE,SAAS,kCAAkC;AAAA,KAC5D,CAAA;AAAA,IACD,OAAA,EAAS,OAAO,EAAE,IAAA,EAAM,KAAI,KAC1BI,6BAAA,CAAgB,MAAM,GAAG;AAAA,GAC5B,CAAA;AAAA,EAED,WAAWL,OAAA,CAAK;AAAA,IACd,WAAA,EACE,sKAAA;AAAA,IACF,WAAA,EAAaC,MAAE,MAAA,CAAO;AAAA,MACpB,MAAMA,KAAA,CAAE,MAAA,GAAS,QAAA,EAAS,CAAE,SAAS,0CAA0C,CAAA;AAAA,MAC/E,GAAA,EAAKA,KAAA,CAAE,MAAA,EAAO,CAAE,SAAS,gCAAgC,CAAA;AAAA,MACzD,OAAOA,KAAA,CAAE,MAAA,GAAS,QAAA,EAAS,CAAE,SAAS,uCAAuC,CAAA;AAAA,MAC7E,SAASA,KAAA,CAAE,MAAA,GAAS,QAAA,EAAS,CAAE,SAAS,0BAA0B;AAAA,KACnE,CAAA;AAAA,IACD,SAAS,OAAO;AAAA,MACd,IAAA;AAAA,MACA,GAAA;AAAA,MACA,KAAA;AAAA,MACA;AAAA,UAMIK,2BAAA,CAAc,IAAA,EAAM,KAAK,EAAE,KAAA,EAAO,SAAS;AAAA,GAClD;AACH","file":"ai-sdk.cjs","sourcesContent":["/**\n * Vercel AI SDK adapter — ready-to-use `tools` object for `generateText` /\n * `streamText`.\n *\n * @example\n * ```ts\n * import { streamText } from 'ai';\n * import { schematexTools } from 'schematex/ai/sdk';\n *\n * const result = streamText({\n *   model: 'anthropic/claude-opus-4-7',\n *   tools: schematexTools,\n *   maxSteps: 5,\n *   system: `You write Schematex DSL. Discover types with listDiagrams,\n * then fetch getSyntax + getExamples before writing. Call validateDsl\n * before returning DSL to the user.`,\n *   prompt: userMessage,\n * });\n * ```\n *\n * Peer-deps `ai` and `zod` are optional — this module only loads if both\n * are installed.\n */\nimport { tool } from \"ai\";\nimport { z } from \"zod\";\n\nimport {\n  listDiagrams as listDiagramsImpl,\n  getSyntax as getSyntaxImpl,\n  getExamples as getExamplesImpl,\n  validateDsl as validateDslImpl,\n  renderDsl as renderDslImpl,\n} from \"./tools\";\n\nexport const schematexTools = {\n  listDiagrams: tool({\n    description:\n      \"List every Schematex diagram type with a tagline, 'use when' hint, domain cluster, and authoritative standard. Call this first to discover what's available.\",\n    inputSchema: z.object({}),\n    execute: async () => listDiagramsImpl(),\n  }),\n\n  getSyntax: tool({\n    description:\n      \"Return a compact syntax reference for one diagram type — rules, grammar (EBNF), and inline examples. Trimmed for LLM consumption (~2,000–4,000 tokens). Call after listDiagrams once you've chosen a type.\",\n    inputSchema: z.object({\n      type: z\n        .string()\n        .describe(\n          \"Diagram type id from listDiagrams (e.g. 'genogram', 'sld', 'fishbone').\"\n        ),\n    }),\n    execute: async ({ type }: { type: string }) => getSyntaxImpl(type),\n  }),\n\n  getExamples: tool({\n    description:\n      \"Return curated real-world DSL examples for a diagram type, each with scenario notes and tags. Use as few-shot context before generating DSL.\",\n    inputSchema: z.object({\n      type: z.string().describe(\"Diagram type id.\"),\n      limit: z\n        .number()\n        .int()\n        .min(1)\n        .max(10)\n        .optional()\n        .describe(\"Max examples to return (default 5).\"),\n      preferFeatured: z\n        .boolean()\n        .optional()\n        .describe(\"Rank featured examples first.\"),\n      maxComplexity: z\n        .number()\n        .int()\n        .min(1)\n        .max(5)\n        .optional()\n        .describe(\"Only return examples with complexity <= this value (1=simplest).\"),\n    }),\n    execute: async (args: {\n      type: string;\n      limit?: number;\n      preferFeatured?: boolean;\n      maxComplexity?: number;\n    }) =>\n      getExamplesImpl(args.type, {\n        limit: args.limit,\n        preferFeatured: args.preferFeatured,\n        maxComplexity: args.maxComplexity,\n      }),\n  }),\n\n  validateDsl: tool({\n    description:\n      \"Validate Schematex DSL. Returns { ok: true } or { ok: false, errors: [{line, column, message, source}] }. Call before returning DSL to the user and self-correct on errors.\",\n    inputSchema: z.object({\n      type: z\n        .string()\n        .optional()\n        .describe(\n          \"Diagram type. Optional — Schematex auto-detects from the first line if omitted.\"\n        ),\n      dsl: z.string().describe(\"The DSL source text to validate.\"),\n    }),\n    execute: async ({ type, dsl }: { type?: string; dsl: string }) =>\n      validateDslImpl(type, dsl),\n  }),\n\n  renderDsl: tool({\n    description:\n      \"Render Schematex DSL to an SVG string. Returns { ok: true, svg } or { ok: false, errors }. Use when the caller needs the actual diagram output, not just validation.\",\n    inputSchema: z.object({\n      type: z.string().optional().describe(\"Diagram type (auto-detected if omitted).\"),\n      dsl: z.string().describe(\"The DSL source text to render.\"),\n      theme: z.string().optional().describe(\"Theme name, e.g. 'default' or 'dark'.\"),\n      padding: z.number().optional().describe(\"Outer padding in pixels.\"),\n    }),\n    execute: async ({\n      type,\n      dsl,\n      theme,\n      padding,\n    }: {\n      type?: string;\n      dsl: string;\n      theme?: string;\n      padding?: number;\n    }) => renderDslImpl(type, dsl, { theme, padding }),\n  }),\n} as const;\n\nexport type SchematexTools = typeof schematexTools;\n"]}
+{"version":3,"sources":["../../src/ai/ai-sdk.ts"],"names":["tool","z","listDiagrams","getSyntax","getExamples","validateDsl","renderDsl"],"mappings":"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","file":"ai-sdk.cjs","sourcesContent":["/**\n * Vercel AI SDK adapter — ready-to-use `tools` object for `generateText` /\n * `streamText`.\n *\n * @example\n * ```ts\n * import { streamText } from 'ai';\n * import { schematexTools } from 'schematex/ai/sdk';\n *\n * const result = streamText({\n *   model: 'anthropic/claude-opus-4-7',\n *   tools: schematexTools,\n *   maxSteps: 5,\n *   system: `You write Schematex DSL. Discover types with listDiagrams,\n * then fetch getSyntax + getExamples before writing. Call validateDsl\n * before returning DSL to the user.`,\n *   prompt: userMessage,\n * });\n * ```\n *\n * Peer-deps `ai` and `zod` are optional — this module only loads if both\n * are installed.\n */\nimport { tool } from \"ai\";\nimport { z } from \"zod\";\n\nimport {\n  listDiagrams as listDiagramsImpl,\n  getSyntax as getSyntaxImpl,\n  getExamples as getExamplesImpl,\n  validateDsl as validateDslImpl,\n  renderDsl as renderDslImpl,\n} from \"./tools\";\n\nexport const schematexTools = {\n  listDiagrams: tool({\n    description:\n      \"List every Schematex diagram type with a tagline, 'use when' hint, domain cluster, and authoritative standard. Call this first to discover what's available.\",\n    inputSchema: z.object({}),\n    execute: async () => listDiagramsImpl(),\n  }),\n\n  getSyntax: tool({\n    description:\n      \"Return syntax for one diagram type. Default `detail: canonical` is the compact first-shot generation path: canonical header, preferred forms, rules, and repair checks. Request `detail: reference` only for advanced forms or imported adapters after choosing a type.\",\n    inputSchema: z.object({\n      type: z\n        .string()\n        .describe(\n          \"Diagram type id from listDiagrams (e.g. 'genogram', 'sld', 'fishbone').\"\n        ),\n      detail: z\n        .enum([\"canonical\", \"reference\"])\n        .optional()\n        .describe(\n          \"Default `canonical` is best for generation. Use `reference` for the fuller grammar/tutorial.\"\n        ),\n    }),\n    execute: async ({\n      type,\n      detail,\n    }: {\n      type: string;\n      detail?: \"canonical\" | \"reference\";\n    }) => getSyntaxImpl(type, { detail }),\n  }),\n\n  getExamples: tool({\n    description:\n      \"Return curated real-world DSL examples for a diagram type, each with scenario notes and tags. Use as few-shot context before generating DSL.\",\n    inputSchema: z.object({\n      type: z.string().describe(\"Diagram type id.\"),\n      limit: z\n        .number()\n        .int()\n        .min(1)\n        .max(10)\n        .optional()\n        .describe(\"Max examples to return (default 5).\"),\n      preferFeatured: z\n        .boolean()\n        .optional()\n        .describe(\"Rank featured examples first.\"),\n      maxComplexity: z\n        .number()\n        .int()\n        .min(1)\n        .max(5)\n        .optional()\n        .describe(\"Only return examples with complexity <= this value (1=simplest).\"),\n    }),\n    execute: async (args: {\n      type: string;\n      limit?: number;\n      preferFeatured?: boolean;\n      maxComplexity?: number;\n    }) =>\n      getExamplesImpl(args.type, {\n        limit: args.limit,\n        preferFeatured: args.preferFeatured,\n        maxComplexity: args.maxComplexity,\n      }),\n  }),\n\n  validateDsl: tool({\n    description:\n      \"Validate Schematex DSL. Pass the selected diagram `type` whenever you know it. Returns { ok: true } or { ok: false, errors: [{line, column, message, source, hint}] }. Call before returning DSL and self-correct on errors.\",\n    inputSchema: z.object({\n      type: z\n        .string()\n        .optional()\n        .describe(\n          \"Selected diagram type. Optional for adapters/autodetect, but explicit canonical types are more robust.\"\n        ),\n      dsl: z.string().describe(\"The DSL source text to validate.\"),\n    }),\n    execute: async ({ type, dsl }: { type?: string; dsl: string }) =>\n      validateDslImpl(type, dsl),\n  }),\n\n  renderDsl: tool({\n    description:\n      \"Render Schematex DSL to an SVG string. Returns { ok: true, svg } or { ok: false, errors }. Use when the caller needs the actual diagram output, not just validation.\",\n    inputSchema: z.object({\n      type: z\n        .string()\n        .optional()\n        .describe(\"Selected diagram type. Prefer passing it once chosen.\"),\n      dsl: z.string().describe(\"The DSL source text to render.\"),\n      theme: z.string().optional().describe(\"Theme name, e.g. 'default' or 'dark'.\"),\n      padding: z.number().optional().describe(\"Outer padding in pixels.\"),\n    }),\n    execute: async ({\n      type,\n      dsl,\n      theme,\n      padding,\n    }: {\n      type?: string;\n      dsl: string;\n      theme?: string;\n      padding?: number;\n    }) => renderDslImpl(type, dsl, { theme, padding }),\n  }),\n} as const;\n\nexport type SchematexTools = typeof schematexTools;\n"]}

package/dist/ai/ai-sdk.d.cts

@@ -1,12 +1,13 @@
 import * as ai from 'ai';
-import { DiagramListItem, GetSyntaxResult, GetExamplesResult, ValidateDslResult, RenderDslResult } from './index.cjs';
-import '../api-C5UcmT7n.cjs';
-import '../types-BOAsqHoU.cjs';
+import { b as DiagramListItem, f as GetSyntaxResult, d as GetExamplesResult, V as ValidateDslResult, R as RenderDslResult } from '../tools-DlpuE76u.cjs';
+import '../api-C5SECOxZ.cjs';
+import '../types-WTr9W5Ud.cjs';
 
 declare const schematexTools: {
     readonly listDiagrams: ai.Tool<{}, DiagramListItem[]>;
     readonly getSyntax: ai.Tool<{
         type: string;
+        detail?: "canonical" | "reference" | undefined;
     }, GetSyntaxResult>;
     readonly getExamples: ai.Tool<{
         type: string;

package/dist/ai/ai-sdk.d.ts

@@ -1,12 +1,13 @@
 import * as ai from 'ai';
-import { DiagramListItem, GetSyntaxResult, GetExamplesResult, ValidateDslResult, RenderDslResult } from './index.js';
-import '../api-C5UcmT7n.js';
-import '../types-BOAsqHoU.js';
+import { b as DiagramListItem, f as GetSyntaxResult, d as GetExamplesResult, V as ValidateDslResult, R as RenderDslResult } from '../tools-BHWaJPOl.js';
+import '../api-Cr_MxttI.js';
+import '../types-WTr9W5Ud.js';
 
 declare const schematexTools: {
     readonly listDiagrams: ai.Tool<{}, DiagramListItem[]>;
     readonly getSyntax: ai.Tool<{
         type: string;
+        detail?: "canonical" | "reference" | undefined;
     }, GetSyntaxResult>;
     readonly getExamples: ai.Tool<{
         type: string;

package/dist/ai/ai-sdk.js

@@ -1,7 +1,7 @@
-import { renderDsl, validateDsl, getExamples, getSyntax, listDiagrams } from '../chunk-IM4RCUHA.js';
-import '../chunk-GTDQAN2Z.js';
+import { renderDsl, validateDsl, getExamples, getSyntax, listDiagrams } from '../chunk-VKPCR7BG.js';
+import '../chunk-OK5ZS3LU.js';
 import '../chunk-I55HO32M.js';
-import '../chunk-HUPDIRBX.js';
+import '../chunk-VCH7RI5H.js';
 import '../chunk-EPKIJEH7.js';
 import '../chunk-IBRW3UOA.js';
 import '../chunk-6OSUNBZY.js';
@@ -32,13 +32,19 @@ var schematexTools = {
     execute: async () => listDiagrams()
   }),
   getSyntax: tool({
-    description: "Return a compact syntax reference for one diagram type \u2014 rules, grammar (EBNF), and inline examples. Trimmed for LLM consumption (~2,000\u20134,000 tokens). Call after listDiagrams once you've chosen a type.",
+    description: "Return syntax for one diagram type. Default `detail: canonical` is the compact first-shot generation path: canonical header, preferred forms, rules, and repair checks. Request `detail: reference` only for advanced forms or imported adapters after choosing a type.",
     inputSchema: z.object({
       type: z.string().describe(
         "Diagram type id from listDiagrams (e.g. 'genogram', 'sld', 'fishbone')."
+      ),
+      detail: z.enum(["canonical", "reference"]).optional().describe(
+        "Default `canonical` is best for generation. Use `reference` for the fuller grammar/tutorial."
       )
     }),
-    execute: async ({ type }) => getSyntax(type)
+    execute: async ({
+      type,
+      detail
+    }) => getSyntax(type, { detail })
   }),
   getExamples: tool({
     description: "Return curated real-world DSL examples for a diagram type, each with scenario notes and tags. Use as few-shot context before generating DSL.",
@@ -55,10 +61,10 @@ var schematexTools = {
     })
   }),
   validateDsl: tool({
-    description: "Validate Schematex DSL. Returns { ok: true } or { ok: false, errors: [{line, column, message, source}] }. Call before returning DSL to the user and self-correct on errors.",
+    description: "Validate Schematex DSL. Pass the selected diagram `type` whenever you know it. Returns { ok: true } or { ok: false, errors: [{line, column, message, source, hint}] }. Call before returning DSL and self-correct on errors.",
     inputSchema: z.object({
       type: z.string().optional().describe(
-        "Diagram type. Optional \u2014 Schematex auto-detects from the first line if omitted."
+        "Selected diagram type. Optional for adapters/autodetect, but explicit canonical types are more robust."
       ),
       dsl: z.string().describe("The DSL source text to validate.")
     }),
@@ -67,7 +73,7 @@ var schematexTools = {
   renderDsl: tool({
     description: "Render Schematex DSL to an SVG string. Returns { ok: true, svg } or { ok: false, errors }. Use when the caller needs the actual diagram output, not just validation.",
     inputSchema: z.object({
-      type: z.string().optional().describe("Diagram type (auto-detected if omitted)."),
+      type: z.string().optional().describe("Selected diagram type. Prefer passing it once chosen."),
       dsl: z.string().describe("The DSL source text to render."),
       theme: z.string().optional().describe("Theme name, e.g. 'default' or 'dark'."),
       padding: z.number().optional().describe("Outer padding in pixels.")

package/dist/ai/ai-sdk.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/ai/ai-sdk.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCO,IAAM,cAAA,GAAiB;AAAA,EAC5B,cAAc,IAAA,CAAK;AAAA,IACjB,WAAA,EACE,8JAAA;AAAA,IACF,WAAA,EAAa,CAAA,CAAE,MAAA,CAAO,EAAE,CAAA;AAAA,IACxB,OAAA,EAAS,YAAY,YAAA;AAAiB,GACvC,CAAA;AAAA,EAED,WAAW,IAAA,CAAK;AAAA,IACd,WAAA,EACE,sNAAA;AAAA,IACF,WAAA,EAAa,EAAE,MAAA,CAAO;AAAA,MACpB,IAAA,EAAM,CAAA,CACH,MAAA,EAAO,CACP,QAAA;AAAA,QACC;AAAA;AACF,KACH,CAAA;AAAA,IACD,SAAS,OAAO,EAAE,IAAA,EAAK,KAAwB,UAAc,IAAI;AAAA,GAClE,CAAA;AAAA,EAED,aAAa,IAAA,CAAK;AAAA,IAChB,WAAA,EACE,8IAAA;AAAA,IACF,WAAA,EAAa,EAAE,MAAA,CAAO;AAAA,MACpB,IAAA,EAAM,CAAA,CAAE,MAAA,EAAO,CAAE,SAAS,kBAAkB,CAAA;AAAA,MAC5C,KAAA,EAAO,CAAA,CACJ,MAAA,EAAO,CACP,KAAI,CACJ,GAAA,CAAI,CAAC,CAAA,CACL,IAAI,EAAE,CAAA,CACN,QAAA,EAAS,CACT,SAAS,qCAAqC,CAAA;AAAA,MACjD,gBAAgB,CAAA,CACb,OAAA,GACA,QAAA,EAAS,CACT,SAAS,+BAA+B,CAAA;AAAA,MAC3C,aAAA,EAAe,CAAA,CACZ,MAAA,EAAO,CACP,KAAI,CACJ,GAAA,CAAI,CAAC,CAAA,CACL,IAAI,CAAC,CAAA,CACL,QAAA,EAAS,CACT,SAAS,kEAAkE;AAAA,KAC/E,CAAA;AAAA,IACD,OAAA,EAAS,OAAO,IAAA,KAMd,WAAA,CAAgB,KAAK,IAAA,EAAM;AAAA,MACzB,OAAO,IAAA,CAAK,KAAA;AAAA,MACZ,gBAAgB,IAAA,CAAK,cAAA;AAAA,MACrB,eAAe,IAAA,CAAK;AAAA,KACrB;AAAA,GACJ,CAAA;AAAA,EAED,aAAa,IAAA,CAAK;AAAA,IAChB,WAAA,EACE,6KAAA;AAAA,IACF,WAAA,EAAa,EAAE,MAAA,CAAO;AAAA,MACpB,IAAA,EAAM,CAAA,CACH,MAAA,EAAO,CACP,UAAS,CACT,QAAA;AAAA,QACC;AAAA,OACF;AAAA,MACF,GAAA,EAAK,CAAA,CAAE,MAAA,EAAO,CAAE,SAAS,kCAAkC;AAAA,KAC5D,CAAA;AAAA,IACD,OAAA,EAAS,OAAO,EAAE,IAAA,EAAM,KAAI,KAC1B,WAAA,CAAgB,MAAM,GAAG;AAAA,GAC5B,CAAA;AAAA,EAED,WAAW,IAAA,CAAK;AAAA,IACd,WAAA,EACE,sKAAA;AAAA,IACF,WAAA,EAAa,EAAE,MAAA,CAAO;AAAA,MACpB,MAAM,CAAA,CAAE,MAAA,GAAS,QAAA,EAAS,CAAE,SAAS,0CAA0C,CAAA;AAAA,MAC/E,GAAA,EAAK,CAAA,CAAE,MAAA,EAAO,CAAE,SAAS,gCAAgC,CAAA;AAAA,MACzD,OAAO,CAAA,CAAE,MAAA,GAAS,QAAA,EAAS,CAAE,SAAS,uCAAuC,CAAA;AAAA,MAC7E,SAAS,CAAA,CAAE,MAAA,GAAS,QAAA,EAAS,CAAE,SAAS,0BAA0B;AAAA,KACnE,CAAA;AAAA,IACD,SAAS,OAAO;AAAA,MACd,IAAA;AAAA,MACA,GAAA;AAAA,MACA,KAAA;AAAA,MACA;AAAA,UAMI,SAAA,CAAc,IAAA,EAAM,KAAK,EAAE,KAAA,EAAO,SAAS;AAAA,GAClD;AACH","file":"ai-sdk.js","sourcesContent":["/**\n * Vercel AI SDK adapter — ready-to-use `tools` object for `generateText` /\n * `streamText`.\n *\n * @example\n * ```ts\n * import { streamText } from 'ai';\n * import { schematexTools } from 'schematex/ai/sdk';\n *\n * const result = streamText({\n *   model: 'anthropic/claude-opus-4-7',\n *   tools: schematexTools,\n *   maxSteps: 5,\n *   system: `You write Schematex DSL. Discover types with listDiagrams,\n * then fetch getSyntax + getExamples before writing. Call validateDsl\n * before returning DSL to the user.`,\n *   prompt: userMessage,\n * });\n * ```\n *\n * Peer-deps `ai` and `zod` are optional — this module only loads if both\n * are installed.\n */\nimport { tool } from \"ai\";\nimport { z } from \"zod\";\n\nimport {\n  listDiagrams as listDiagramsImpl,\n  getSyntax as getSyntaxImpl,\n  getExamples as getExamplesImpl,\n  validateDsl as validateDslImpl,\n  renderDsl as renderDslImpl,\n} from \"./tools\";\n\nexport const schematexTools = {\n  listDiagrams: tool({\n    description:\n      \"List every Schematex diagram type with a tagline, 'use when' hint, domain cluster, and authoritative standard. Call this first to discover what's available.\",\n    inputSchema: z.object({}),\n    execute: async () => listDiagramsImpl(),\n  }),\n\n  getSyntax: tool({\n    description:\n      \"Return a compact syntax reference for one diagram type — rules, grammar (EBNF), and inline examples. Trimmed for LLM consumption (~2,000–4,000 tokens). Call after listDiagrams once you've chosen a type.\",\n    inputSchema: z.object({\n      type: z\n        .string()\n        .describe(\n          \"Diagram type id from listDiagrams (e.g. 'genogram', 'sld', 'fishbone').\"\n        ),\n    }),\n    execute: async ({ type }: { type: string }) => getSyntaxImpl(type),\n  }),\n\n  getExamples: tool({\n    description:\n      \"Return curated real-world DSL examples for a diagram type, each with scenario notes and tags. Use as few-shot context before generating DSL.\",\n    inputSchema: z.object({\n      type: z.string().describe(\"Diagram type id.\"),\n      limit: z\n        .number()\n        .int()\n        .min(1)\n        .max(10)\n        .optional()\n        .describe(\"Max examples to return (default 5).\"),\n      preferFeatured: z\n        .boolean()\n        .optional()\n        .describe(\"Rank featured examples first.\"),\n      maxComplexity: z\n        .number()\n        .int()\n        .min(1)\n        .max(5)\n        .optional()\n        .describe(\"Only return examples with complexity <= this value (1=simplest).\"),\n    }),\n    execute: async (args: {\n      type: string;\n      limit?: number;\n      preferFeatured?: boolean;\n      maxComplexity?: number;\n    }) =>\n      getExamplesImpl(args.type, {\n        limit: args.limit,\n        preferFeatured: args.preferFeatured,\n        maxComplexity: args.maxComplexity,\n      }),\n  }),\n\n  validateDsl: tool({\n    description:\n      \"Validate Schematex DSL. Returns { ok: true } or { ok: false, errors: [{line, column, message, source}] }. Call before returning DSL to the user and self-correct on errors.\",\n    inputSchema: z.object({\n      type: z\n        .string()\n        .optional()\n        .describe(\n          \"Diagram type. Optional — Schematex auto-detects from the first line if omitted.\"\n        ),\n      dsl: z.string().describe(\"The DSL source text to validate.\"),\n    }),\n    execute: async ({ type, dsl }: { type?: string; dsl: string }) =>\n      validateDslImpl(type, dsl),\n  }),\n\n  renderDsl: tool({\n    description:\n      \"Render Schematex DSL to an SVG string. Returns { ok: true, svg } or { ok: false, errors }. Use when the caller needs the actual diagram output, not just validation.\",\n    inputSchema: z.object({\n      type: z.string().optional().describe(\"Diagram type (auto-detected if omitted).\"),\n      dsl: z.string().describe(\"The DSL source text to render.\"),\n      theme: z.string().optional().describe(\"Theme name, e.g. 'default' or 'dark'.\"),\n      padding: z.number().optional().describe(\"Outer padding in pixels.\"),\n    }),\n    execute: async ({\n      type,\n      dsl,\n      theme,\n      padding,\n    }: {\n      type?: string;\n      dsl: string;\n      theme?: string;\n      padding?: number;\n    }) => renderDslImpl(type, dsl, { theme, padding }),\n  }),\n} as const;\n\nexport type SchematexTools = typeof schematexTools;\n"]}
+{"version":3,"sources":["../../src/ai/ai-sdk.ts"],"names":[],"mappings":"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","file":"ai-sdk.js","sourcesContent":["/**\n * Vercel AI SDK adapter — ready-to-use `tools` object for `generateText` /\n * `streamText`.\n *\n * @example\n * ```ts\n * import { streamText } from 'ai';\n * import { schematexTools } from 'schematex/ai/sdk';\n *\n * const result = streamText({\n *   model: 'anthropic/claude-opus-4-7',\n *   tools: schematexTools,\n *   maxSteps: 5,\n *   system: `You write Schematex DSL. Discover types with listDiagrams,\n * then fetch getSyntax + getExamples before writing. Call validateDsl\n * before returning DSL to the user.`,\n *   prompt: userMessage,\n * });\n * ```\n *\n * Peer-deps `ai` and `zod` are optional — this module only loads if both\n * are installed.\n */\nimport { tool } from \"ai\";\nimport { z } from \"zod\";\n\nimport {\n  listDiagrams as listDiagramsImpl,\n  getSyntax as getSyntaxImpl,\n  getExamples as getExamplesImpl,\n  validateDsl as validateDslImpl,\n  renderDsl as renderDslImpl,\n} from \"./tools\";\n\nexport const schematexTools = {\n  listDiagrams: tool({\n    description:\n      \"List every Schematex diagram type with a tagline, 'use when' hint, domain cluster, and authoritative standard. Call this first to discover what's available.\",\n    inputSchema: z.object({}),\n    execute: async () => listDiagramsImpl(),\n  }),\n\n  getSyntax: tool({\n    description:\n      \"Return syntax for one diagram type. Default `detail: canonical` is the compact first-shot generation path: canonical header, preferred forms, rules, and repair checks. Request `detail: reference` only for advanced forms or imported adapters after choosing a type.\",\n    inputSchema: z.object({\n      type: z\n        .string()\n        .describe(\n          \"Diagram type id from listDiagrams (e.g. 'genogram', 'sld', 'fishbone').\"\n        ),\n      detail: z\n        .enum([\"canonical\", \"reference\"])\n        .optional()\n        .describe(\n          \"Default `canonical` is best for generation. Use `reference` for the fuller grammar/tutorial.\"\n        ),\n    }),\n    execute: async ({\n      type,\n      detail,\n    }: {\n      type: string;\n      detail?: \"canonical\" | \"reference\";\n    }) => getSyntaxImpl(type, { detail }),\n  }),\n\n  getExamples: tool({\n    description:\n      \"Return curated real-world DSL examples for a diagram type, each with scenario notes and tags. Use as few-shot context before generating DSL.\",\n    inputSchema: z.object({\n      type: z.string().describe(\"Diagram type id.\"),\n      limit: z\n        .number()\n        .int()\n        .min(1)\n        .max(10)\n        .optional()\n        .describe(\"Max examples to return (default 5).\"),\n      preferFeatured: z\n        .boolean()\n        .optional()\n        .describe(\"Rank featured examples first.\"),\n      maxComplexity: z\n        .number()\n        .int()\n        .min(1)\n        .max(5)\n        .optional()\n        .describe(\"Only return examples with complexity <= this value (1=simplest).\"),\n    }),\n    execute: async (args: {\n      type: string;\n      limit?: number;\n      preferFeatured?: boolean;\n      maxComplexity?: number;\n    }) =>\n      getExamplesImpl(args.type, {\n        limit: args.limit,\n        preferFeatured: args.preferFeatured,\n        maxComplexity: args.maxComplexity,\n      }),\n  }),\n\n  validateDsl: tool({\n    description:\n      \"Validate Schematex DSL. Pass the selected diagram `type` whenever you know it. Returns { ok: true } or { ok: false, errors: [{line, column, message, source, hint}] }. Call before returning DSL and self-correct on errors.\",\n    inputSchema: z.object({\n      type: z\n        .string()\n        .optional()\n        .describe(\n          \"Selected diagram type. Optional for adapters/autodetect, but explicit canonical types are more robust.\"\n        ),\n      dsl: z.string().describe(\"The DSL source text to validate.\"),\n    }),\n    execute: async ({ type, dsl }: { type?: string; dsl: string }) =>\n      validateDslImpl(type, dsl),\n  }),\n\n  renderDsl: tool({\n    description:\n      \"Render Schematex DSL to an SVG string. Returns { ok: true, svg } or { ok: false, errors }. Use when the caller needs the actual diagram output, not just validation.\",\n    inputSchema: z.object({\n      type: z\n        .string()\n        .optional()\n        .describe(\"Selected diagram type. Prefer passing it once chosen.\"),\n      dsl: z.string().describe(\"The DSL source text to render.\"),\n      theme: z.string().optional().describe(\"Theme name, e.g. 'default' or 'dark'.\"),\n      padding: z.number().optional().describe(\"Outer padding in pixels.\"),\n    }),\n    execute: async ({\n      type,\n      dsl,\n      theme,\n      padding,\n    }: {\n      type?: string;\n      dsl: string;\n      theme?: string;\n      padding?: number;\n    }) => renderDslImpl(type, dsl, { theme, padding }),\n  }),\n} as const;\n\nexport type SchematexTools = typeof schematexTools;\n"]}

package/dist/ai/index.cjs

@@ -1,9 +1,9 @@
 'use strict';
 
-var chunkNWPCY65Z_cjs = require('../chunk-NWPCY65Z.cjs');
-require('../chunk-3YUUC6RN.cjs');
+var chunkHK56GQQP_cjs = require('../chunk-HK56GQQP.cjs');
+require('../chunk-4QPDZJAL.cjs');
 require('../chunk-QUKVGHN4.cjs');
-require('../chunk-XRCY75UV.cjs');
+require('../chunk-QMTWG6JL.cjs');
 require('../chunk-SUIDD2C5.cjs');
 require('../chunk-N7W5KZK7.cjs');
 require('../chunk-3M6WB62Y.cjs');
@@ -29,35 +29,39 @@ require('../chunk-3WNW5Y7P.cjs');
 
 Object.defineProperty(exports, "DIAGRAM_REGISTRY", {
   enumerable: true,
-  get: function () { return chunkNWPCY65Z_cjs.DIAGRAM_REGISTRY; }
+  get: function () { return chunkHK56GQQP_cjs.DIAGRAM_REGISTRY; }
 });
 Object.defineProperty(exports, "getAllDiagramTypes", {
   enumerable: true,
-  get: function () { return chunkNWPCY65Z_cjs.getAllDiagramTypes; }
+  get: function () { return chunkHK56GQQP_cjs.getAllDiagramTypes; }
 });
 Object.defineProperty(exports, "getDiagramMeta", {
   enumerable: true,
-  get: function () { return chunkNWPCY65Z_cjs.getDiagramMeta; }
+  get: function () { return chunkHK56GQQP_cjs.getDiagramMeta; }
 });
 Object.defineProperty(exports, "getExamples", {
   enumerable: true,
-  get: function () { return chunkNWPCY65Z_cjs.getExamples; }
+  get: function () { return chunkHK56GQQP_cjs.getExamples; }
 });
 Object.defineProperty(exports, "getSyntax", {
   enumerable: true,
-  get: function () { return chunkNWPCY65Z_cjs.getSyntax; }
+  get: function () { return chunkHK56GQQP_cjs.getSyntax; }
 });
 Object.defineProperty(exports, "listDiagrams", {
   enumerable: true,
-  get: function () { return chunkNWPCY65Z_cjs.listDiagrams; }
+  get: function () { return chunkHK56GQQP_cjs.listDiagrams; }
 });
 Object.defineProperty(exports, "renderDsl", {
   enumerable: true,
-  get: function () { return chunkNWPCY65Z_cjs.renderDsl; }
+  get: function () { return chunkHK56GQQP_cjs.renderDsl; }
+});
+Object.defineProperty(exports, "resolveDiagramType", {
+  enumerable: true,
+  get: function () { return chunkHK56GQQP_cjs.resolveDiagramType; }
 });
 Object.defineProperty(exports, "validateDsl", {
   enumerable: true,
-  get: function () { return chunkNWPCY65Z_cjs.validateDsl; }
+  get: function () { return chunkHK56GQQP_cjs.validateDsl; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/ai/index.d.cts

@@ -1,155 +1,22 @@
-import { S as SchematexConfig } from '../api-C5UcmT7n.cjs';
-import { q as DiagramType } from '../types-BOAsqHoU.cjs';
+export { D as DIAGRAM_REGISTRY, a as DiagramCluster, b as DiagramListItem, c as DiagramMeta, E as Example, G as GetExamplesOptions, d as GetExamplesResult, e as GetSyntaxOptions, f as GetSyntaxResult, R as RenderDslResult, S as SchematexValidationError, g as SyntaxDetail, h as SyntaxDoc, V as ValidateDslResult, i as getAllDiagramTypes, j as getDiagramMeta, k as getExamples, l as getSyntax, m as listDiagrams, r as renderDsl, n as resolveDiagramType, v as validateDsl } from '../tools-DlpuE76u.cjs';
+import { q as DiagramType } from '../types-WTr9W5Ud.cjs';
+import '../api-C5SECOxZ.cjs';
 
-/**
- * Diagram registry — metadata for every diagram type Schematex supports.
- *
- * This is the index an LLM sees when calling `listDiagrams()`. Descriptions
- * are tuned to help the model pick the right type for a user request.
- */
-
-type DiagramCluster = "relationships" | "electrical-industrial" | "corporate-legal" | "causality-analysis" | "generic" | "strategy" | "knowledge" | "behavior-modeling" | "research" | "project-management";
-interface DiagramMeta {
-    /** Canonical type id — matches `DiagramType` and plugin keys. */
+interface GenerationProfile {
+    /** Canonical type id from `listDiagrams()`. */
     type: DiagramType;
-    /** Human-readable name. */
-    name: string;
-    /** One-sentence tagline. */
-    tagline: string;
-    /** When should an LLM pick this diagram? Written in "use X when …" form. */
-    useWhen: string;
-    /** Domain cluster for grouping. */
-    cluster: DiagramCluster;
-    /** Published standard the parser and layout follow. */
-    standard: string;
-    /** Path to the syntax doc key in the generated content bundle. */
-    syntaxKey: string;
-}
-declare const DIAGRAM_REGISTRY: readonly DiagramMeta[];
-declare function getDiagramMeta(type: string): DiagramMeta | undefined;
-declare function getAllDiagramTypes(): DiagramType[];
-
-/**
- * Structured error type returned by the AI tool layer.
- *
- * The underlying per-diagram parsers each throw their own error class
- * (genogram.ParseError, SLDParseError, PedigreeParseError, ...). Some
- * carry line/column, some don't. {@link extractError} normalises any
- * thrown value into this shape via structural extraction — no parser
- * refactor required.
- */
-interface SchematexValidationError {
-    /** 1-based line number where the error occurred, if the parser reported it. */
-    line?: number;
-    /** 1-based column, if reported. */
-    column?: number;
-    /** Source snippet from the offending line, if the parser captured it. */
-    source?: string;
-    /** Human-readable error message. */
-    message: string;
-    /** Optional remediation hint. */
-    hint?: string;
-}
-
-/**
- * AUTO-GENERATED by scripts/build-ai-content.mjs — do not edit by hand.
- * Regenerate with: npm run build:ai
- *
- * Compiled content bundle for the AI tool layer. Keeps MDX content
- * available to the published npm package without runtime fs access.
- */
-interface GeneratedExample {
-    slug: string;
-    diagram: string;
-    title: string;
-    description: string;
-    standard: string;
-    tags: readonly string[];
-    complexity: number;
-    featured: boolean;
-    dsl: string;
-    notes: string;
-}
-interface GeneratedSyntax {
-    title: string;
-    content: string;
-}
-
-/**
- * Example library — runtime lookup over the bundled MDX examples.
- */
-
-type Example = GeneratedExample;
-interface GetExamplesOptions {
-    /** Maximum number of examples to return. Default 5. */
-    limit?: number;
-    /** Prefer examples marked `featured: true` when set. */
-    preferFeatured?: boolean;
-    /** Maximum complexity (1–5). */
-    maxComplexity?: number;
-}
-
-/**
- * Syntax lookup — LLM-facing per-diagram grammar reference.
- *
- * v1: returns the stripped-MDX content from `website/content/docs/*.mdx`
- * (JSX components replaced with fenced DSL code blocks).
- *
- * Later: may be replaced with curated compact summaries per diagram if
- * the stripped docs prove too long for good LLM performance.
- */
-
-type SyntaxDoc = GeneratedSyntax & {
-    key: string;
-};
-
-/**
- * AI-facing tool functions — the five tools an LLM uses to work with Schematex.
- *
- * Pure TypeScript, zero framework deps. Both the Vercel AI SDK adapter
- * (ai-sdk.ts) and the MCP server wrap these functions.
- */
-
-interface DiagramListItem {
-    type: string;
-    name: string;
-    tagline: string;
-    useWhen: string;
-    cluster: DiagramMeta["cluster"];
-    standard: string;
-}
-declare function listDiagrams(): DiagramListItem[];
-interface GetSyntaxResult {
-    type: string;
-    name: string;
-    standard: string;
-    syntax: SyntaxDoc;
-}
-declare function getSyntax(type: string): GetSyntaxResult;
-interface GetExamplesResult {
-    type: string;
-    count: number;
-    examples: Example[];
-}
-declare function getExamples(type: string, opts?: GetExamplesOptions): GetExamplesResult;
-type ValidateDslResult = {
-    ok: true;
-    type: string | null;
-} | {
-    ok: false;
-    type: string | null;
-    errors: SchematexValidationError[];
-};
-declare function validateDsl(type: string | undefined, dsl: string): ValidateDslResult;
-type RenderDslResult = {
-    ok: true;
-    type: string | null;
-    svg: string;
-} | {
-    ok: false;
-    type: string | null;
-    errors: SchematexValidationError[];
-};
-declare function renderDsl(type: string | undefined, dsl: string, options?: Omit<SchematexConfig, "type">): RenderDslResult;
-
-export { DIAGRAM_REGISTRY, type DiagramCluster, type DiagramListItem, type DiagramMeta, type Example, type GetExamplesOptions, type GetExamplesResult, type GetSyntaxResult, type RenderDslResult, type SchematexValidationError, type SyntaxDoc, type ValidateDslResult, getAllDiagramTypes, getDiagramMeta, getExamples, getSyntax, listDiagrams, renderDsl, validateDsl };
+    /** First line form preferred for generated DSL. */
+    header: string;
+    /** Short name for the preferred authoring mode when a parser has several. */
+    mode: string;
+    /** Forms that cover most first-shot generations for this type. */
+    forms: readonly string[];
+    /** Short grammar choices the model should make by default. */
+    prefer: readonly string[];
+    /** Accepted adapters / advanced paths to avoid unless explicitly needed. */
+    avoid: readonly string[];
+    /** Validation or semantic reminders that prevent common failed renders. */
+    repair: readonly string[];
+}
+
+export type { GenerationProfile };