schematex 0.5.0 → 0.6.0

package/README.md

@@ -29,15 +29,16 @@
 
 ---
 
-**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. 33 diagram families across ten 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
+- 🖧 **Network & Infrastructure** — **network topology** diagrams (Cisco-convention icons) with device/link/port integrity, IP-CCTV camera systems, three-tier campus, spine-leaf fabric, subnets & VLANs
 - 📅 **Timelines** — proportional / equidistant / log axis · swimlane · gantt · lollipop · BC dates · geological Ma scale
 
 Mermaid draws generic flowcharts. Schematex draws the diagrams doctors, engineers, and lawyers actually use — a genogram a genetic counselor accepts clinically, ladder logic that maps 1:1 to IEC 61131-3, a cap table that survives a Series A review.
@@ -73,7 +74,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*
 
@@ -502,6 +503,79 @@ task G "Launch event"         duration: 2  after: E, F
 
 [PERT / CPM syntax →](https://schematex.dev/docs/pert)
 
+---
+
+### ◉ Petri net — *Murata 1989 / ISO-IEC 15909 place-transition net*
+
+The only text-DSL Petri net tool that **understands the dynamics**, not just the shapes. You declare places (circles holding tokens), transitions (bars), and weighted arcs; the engine validates the bipartite structure, computes which transitions are *enabled* under the marking (highlighted green), and can `fire:` a sequence forward to render any reachable marking. Immediate vs. timed transitions, arc weights, capacity, and inhibitor / read / reset arcs — the recognised concurrency vocabulary.
+
+```
+petri "Mutual Exclusion — two processes, one resource"
+  place idleA *1 "A idle"
+  place idleB *1 "B idle"
+  place mutex *1 "resource"
+  place critA "A critical"
+  place critB "B critical"
+  transition enterA
+  transition exitA
+  transition enterB
+  transition exitB
+  idleA -> enterA
+  mutex -> enterA
+  enterA -> critA
+  critA -> exitA
+  exitA -> idleA
+  exitA -> mutex
+  idleB -> enterB
+  mutex -> enterB
+  enterB -> critB
+  critB -> exitB
+  exitB -> idleB
+  exitB -> mutex
+```
+
+![Mutual Exclusion Petri Net](examples/petri/mutual-exclusion.svg)
+
+[Petri net syntax →](https://schematex.dev/docs/petri)
+
+---
+
+### 🖧 Network topology — *Cisco-convention icons · device / link / port integrity*
+
+The free, text-first, zero-dependency network-diagram engine. Declare typed devices (router, switch, firewall, AP, server, **IP camera / NVR / PoE switch**, …) and typed annotated links (copper / fiber / wireless / serial / **PoE** / VPN / LAG, carrying VLAN / speed / port / mode), group them into sites, racks, subnets and VLANs, and let the engine lay out the topology class correctly — `tiered` (three-tier campus), `star`, `ring`, `bus`, `mesh`, `spine-leaf` (auto-meshed Clos), or `tree`. Unlike an LLM emitting raw Mermaid, it **never drops a device, a port, or a link**, and it validates IP-in-subnet and VLAN ranges.
+
+```
+network "Acme HQ — CCTV"
+  layout: tiered
+  internet net "Internet"
+  firewall fw1 "Perimeter FW" tier: edge
+  l3switch core1 "Core SW" tier: core
+  poeswitch poe1 "PoE Switch A" tier: access
+  poeswitch poe2 "PoE Switch B" tier: access
+  nvr nvr1 "Video Recorder"
+  monitor wall1 "Guard Station"
+  subnet cams "192.168.20.0/24" {
+    camera cam1 "Lobby Dome" type: dome ip: 192.168.20.11
+    camera cam2 "Gate PTZ" type: ptz ip: 192.168.20.12
+    camera cam3 "Dock Bullet" type: bullet ip: 192.168.20.13
+    poe1
+    poe2
+  }
+  net -- fw1 : wan "ISP 1Gbps"
+  fw1 -- core1 : fiber 10G
+  core1 -- poe1 : trunk vlan: 20 1G
+  core1 -- poe2 : trunk vlan: 20 1G
+  core1 -- nvr1 : 1G
+  core1 -- wall1
+  poe1 -- cam1 : poe
+  poe1 -- cam2 : poe
+  poe2 -- cam3 : poe
+```
+
+![CCTV camera network topology](examples/network/cctv-camera-network.svg)
+
+[Network topology syntax →](https://schematex.dev/docs/network)
+
 ## Why SchemaTex?
 
 **Generic flowchart tools can't draw professional diagrams.** Every diagram domain has published standards — symbol conventions, layout rules, labelling grammars — and when you ignore them, domain experts reject the output:
@@ -538,16 +612,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,27 +1,27 @@
 'use strict';
 
-var chunkNWPCY65Z_cjs = require('../chunk-NWPCY65Z.cjs');
-require('../chunk-3YUUC6RN.cjs');
-require('../chunk-QUKVGHN4.cjs');
-require('../chunk-XRCY75UV.cjs');
+var chunkYVDUEUFV_cjs = require('../chunk-YVDUEUFV.cjs');
+require('../chunk-25ZON47K.cjs');
+require('../chunk-FKJBXGWP.cjs');
+require('../chunk-V4RO5KYY.cjs');
 require('../chunk-SUIDD2C5.cjs');
-require('../chunk-N7W5KZK7.cjs');
-require('../chunk-3M6WB62Y.cjs');
+require('../chunk-2L4YXZAZ.cjs');
+require('../chunk-ECD5XHBM.cjs');
 require('../chunk-SBB6C4OP.cjs');
-require('../chunk-RYVV5UVI.cjs');
-require('../chunk-VFZOPRQP.cjs');
-require('../chunk-BW4KGTV7.cjs');
-require('../chunk-QTNPMIO2.cjs');
-require('../chunk-TZTCIAYW.cjs');
-require('../chunk-VZ5LDNHK.cjs');
-require('../chunk-EGSUMHCS.cjs');
+require('../chunk-V4GILQR6.cjs');
+require('../chunk-HWVBHU3O.cjs');
+require('../chunk-C5C5EF3W.cjs');
+require('../chunk-6JI6FWLZ.cjs');
+require('../chunk-S3RMAXH5.cjs');
+require('../chunk-VTSH4YPT.cjs');
+require('../chunk-YB4XJY5L.cjs');
 require('../chunk-3KRL2EGN.cjs');
-require('../chunk-S2KJRHDZ.cjs');
-require('../chunk-UUBNQV2T.cjs');
+require('../chunk-4UFR2LB6.cjs');
+require('../chunk-WQDIZH2Z.cjs');
 require('../chunk-5UCXMYE7.cjs');
 require('../chunk-ST5YRTTV.cjs');
-require('../chunk-YLEVMOK2.cjs');
-require('../chunk-D7EHZFK4.cjs');
+require('../chunk-R66QG3XT.cjs');
+require('../chunk-L7POWM5B.cjs');
 require('../chunk-NAGUZFXX.cjs');
 require('../chunk-3WNW5Y7P.cjs');
 var ai = require('ai');
@@ -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 () => chunkYVDUEUFV_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
+    }) => chunkYVDUEUFV_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) => chunkYVDUEUFV_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 }) => chunkYVDUEUFV_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 })
+    }) => chunkYVDUEUFV_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 { c as DiagramListItem, g as GetSyntaxResult, e as GetExamplesResult, V as ValidateDslResult, R as RenderDslResult } from '../tools-DdhP1kWY.cjs';
+import '../api-qVDutqXH.cjs';
+import '../diagnostics-DRxhodP6.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 { c as DiagramListItem, g as GetSyntaxResult, e as GetExamplesResult, V as ValidateDslResult, R as RenderDslResult } from '../tools-BVeUNdsU.js';
+import '../api-XWHHAhQI.js';
+import '../diagnostics-DRxhodP6.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,25 +1,25 @@
-import { renderDsl, validateDsl, getExamples, getSyntax, listDiagrams } from '../chunk-IM4RCUHA.js';
-import '../chunk-GTDQAN2Z.js';
-import '../chunk-I55HO32M.js';
-import '../chunk-HUPDIRBX.js';
+import { renderDsl, validateDsl, getExamples, getSyntax, listDiagrams } from '../chunk-P63S7P6N.js';
+import '../chunk-7AFW2J6J.js';
+import '../chunk-RJMCWT7Z.js';
+import '../chunk-UWA5MWCI.js';
 import '../chunk-EPKIJEH7.js';
-import '../chunk-IBRW3UOA.js';
-import '../chunk-6OSUNBZY.js';
+import '../chunk-TWLKXV2O.js';
+import '../chunk-LGABFD3L.js';
 import '../chunk-PIV2A3HG.js';
-import '../chunk-SZK376QB.js';
-import '../chunk-3M6T7KB4.js';
-import '../chunk-L3CTXXVZ.js';
-import '../chunk-UFTYX73U.js';
-import '../chunk-VJGMEGMR.js';
-import '../chunk-JHDR56XO.js';
-import '../chunk-ZL5RB4UV.js';
+import '../chunk-H4MT5TJP.js';
+import '../chunk-HAZALB7U.js';
+import '../chunk-FBS3PACU.js';
+import '../chunk-7F76AWOI.js';
+import '../chunk-DOK7LKLO.js';
+import '../chunk-YS6CGUNH.js';
+import '../chunk-N5B242WY.js';
 import '../chunk-2KTQ75LN.js';
-import '../chunk-VDSYMSUY.js';
-import '../chunk-ZX74KJPM.js';
+import '../chunk-MVIEIKOI.js';
+import '../chunk-3VB5AT4R.js';
 import '../chunk-FO7BLCEW.js';
 import '../chunk-6URNSB6G.js';
-import '../chunk-ZYRCPSBU.js';
-import '../chunk-2VNMKOUO.js';
+import '../chunk-3IE7KZY4.js';
+import '../chunk-LRI4RH2N.js';
 import '../chunk-5IKOLUWK.js';
 import '../chunk-SYYBKDL7.js';
 import { tool } from 'ai';
@@ -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":";;;;;;;;;;;;;;;;;;;;;;;;;;;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,yQAAA;AAAA,IACF,WAAA,EAAa,EAAE,MAAA,CAAO;AAAA,MACpB,IAAA,EAAM,CAAA,CACH,MAAA,EAAO,CACP,QAAA;AAAA,QACC;AAAA,OACF;AAAA,MACF,MAAA,EAAQ,EACL,IAAA,CAAK,CAAC,aAAa,WAAW,CAAC,CAAA,CAC/B,QAAA,EAAS,CACT,QAAA;AAAA,QACC;AAAA;AACF,KACH,CAAA;AAAA,IACD,SAAS,OAAO;AAAA,MACd,IAAA;AAAA,MACA;AAAA,KACF,KAGM,SAAA,CAAc,IAAA,EAAM,EAAE,QAAQ;AAAA,GACrC,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,8NAAA;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,CACH,MAAA,GACA,QAAA,EAAS,CACT,SAAS,uDAAuD,CAAA;AAAA,MACnE,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 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,27 +1,27 @@
 'use strict';
 
-var chunkNWPCY65Z_cjs = require('../chunk-NWPCY65Z.cjs');
-require('../chunk-3YUUC6RN.cjs');
-require('../chunk-QUKVGHN4.cjs');
-require('../chunk-XRCY75UV.cjs');
+var chunkYVDUEUFV_cjs = require('../chunk-YVDUEUFV.cjs');
+require('../chunk-25ZON47K.cjs');
+require('../chunk-FKJBXGWP.cjs');
+require('../chunk-V4RO5KYY.cjs');
 require('../chunk-SUIDD2C5.cjs');
-require('../chunk-N7W5KZK7.cjs');
-require('../chunk-3M6WB62Y.cjs');
+require('../chunk-2L4YXZAZ.cjs');
+require('../chunk-ECD5XHBM.cjs');
 require('../chunk-SBB6C4OP.cjs');
-require('../chunk-RYVV5UVI.cjs');
-require('../chunk-VFZOPRQP.cjs');
-require('../chunk-BW4KGTV7.cjs');
-require('../chunk-QTNPMIO2.cjs');
-require('../chunk-TZTCIAYW.cjs');
-require('../chunk-VZ5LDNHK.cjs');
-require('../chunk-EGSUMHCS.cjs');
+require('../chunk-V4GILQR6.cjs');
+require('../chunk-HWVBHU3O.cjs');
+require('../chunk-C5C5EF3W.cjs');
+require('../chunk-6JI6FWLZ.cjs');
+require('../chunk-S3RMAXH5.cjs');
+require('../chunk-VTSH4YPT.cjs');
+require('../chunk-YB4XJY5L.cjs');
 require('../chunk-3KRL2EGN.cjs');
-require('../chunk-S2KJRHDZ.cjs');
-require('../chunk-UUBNQV2T.cjs');
+require('../chunk-4UFR2LB6.cjs');
+require('../chunk-WQDIZH2Z.cjs');
 require('../chunk-5UCXMYE7.cjs');
 require('../chunk-ST5YRTTV.cjs');
-require('../chunk-YLEVMOK2.cjs');
-require('../chunk-D7EHZFK4.cjs');
+require('../chunk-R66QG3XT.cjs');
+require('../chunk-L7POWM5B.cjs');
 require('../chunk-NAGUZFXX.cjs');
 require('../chunk-3WNW5Y7P.cjs');
 
@@ -29,35 +29,47 @@ require('../chunk-3WNW5Y7P.cjs');
 
 Object.defineProperty(exports, "DIAGRAM_REGISTRY", {
   enumerable: true,
-  get: function () { return chunkNWPCY65Z_cjs.DIAGRAM_REGISTRY; }
+  get: function () { return chunkYVDUEUFV_cjs.DIAGRAM_REGISTRY; }
+});
+Object.defineProperty(exports, "DIAGRAM_SINCE", {
+  enumerable: true,
+  get: function () { return chunkYVDUEUFV_cjs.DIAGRAM_SINCE; }
 });
 Object.defineProperty(exports, "getAllDiagramTypes", {
   enumerable: true,
-  get: function () { return chunkNWPCY65Z_cjs.getAllDiagramTypes; }
+  get: function () { return chunkYVDUEUFV_cjs.getAllDiagramTypes; }
 });
 Object.defineProperty(exports, "getDiagramMeta", {
   enumerable: true,
-  get: function () { return chunkNWPCY65Z_cjs.getDiagramMeta; }
+  get: function () { return chunkYVDUEUFV_cjs.getDiagramMeta; }
+});
+Object.defineProperty(exports, "getDiagramSince", {
+  enumerable: true,
+  get: function () { return chunkYVDUEUFV_cjs.getDiagramSince; }
 });
 Object.defineProperty(exports, "getExamples", {
   enumerable: true,
-  get: function () { return chunkNWPCY65Z_cjs.getExamples; }
+  get: function () { return chunkYVDUEUFV_cjs.getExamples; }
 });
 Object.defineProperty(exports, "getSyntax", {
   enumerable: true,
-  get: function () { return chunkNWPCY65Z_cjs.getSyntax; }
+  get: function () { return chunkYVDUEUFV_cjs.getSyntax; }
 });
 Object.defineProperty(exports, "listDiagrams", {
   enumerable: true,
-  get: function () { return chunkNWPCY65Z_cjs.listDiagrams; }
+  get: function () { return chunkYVDUEUFV_cjs.listDiagrams; }
 });
 Object.defineProperty(exports, "renderDsl", {
   enumerable: true,
-  get: function () { return chunkNWPCY65Z_cjs.renderDsl; }
+  get: function () { return chunkYVDUEUFV_cjs.renderDsl; }
+});
+Object.defineProperty(exports, "resolveDiagramType", {
+  enumerable: true,
+  get: function () { return chunkYVDUEUFV_cjs.resolveDiagramType; }
 });
 Object.defineProperty(exports, "validateDsl", {
   enumerable: true,
-  get: function () { return chunkNWPCY65Z_cjs.validateDsl; }
+  get: function () { return chunkYVDUEUFV_cjs.validateDsl; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map