schematex 0.2.0 → 0.2.3

package/README.md

@@ -24,7 +24,7 @@
 </p>
 
 <p align="center">
-  <img src="https://schematex.dev/hero-demo.gif" alt="Schematex demo — genogram, pedigree, ladder logic, phylo, entity structure, fishbone, circuit, ecomap, timing" width="720">
+  <img src="./website/public/hero-demo.gif" alt="Schematex demo — genogram, pedigree, ladder logic, phylo, entity structure, fishbone, circuit, ecomap, timing" width="720">
 </p>
 
 ---

package/dist/ai/ai-sdk.cjs

@@ -0,0 +1,85 @@
+'use strict';
+
+var chunkMOU5QRZY_cjs = require('../chunk-MOU5QRZY.cjs');
+require('../chunk-QXIGHMH2.cjs');
+require('../chunk-A5D2IMOX.cjs');
+require('../chunk-4S2WILLW.cjs');
+require('../chunk-MCFQAUQV.cjs');
+require('../chunk-B6INLQBU.cjs');
+require('../chunk-3YZ6FPQW.cjs');
+require('../chunk-ZNOD4VZT.cjs');
+require('../chunk-5AEN2PLB.cjs');
+require('../chunk-QSQX77S2.cjs');
+require('../chunk-Z3DE6S64.cjs');
+require('../chunk-6LZJTAA3.cjs');
+require('../chunk-E65ITQXV.cjs');
+require('../chunk-B37IKTI7.cjs');
+require('../chunk-X7RPFTTR.cjs');
+require('../chunk-COLTVQWR.cjs');
+require('../chunk-ULYRO2KY.cjs');
+require('../chunk-2JDVJRR3.cjs');
+require('../chunk-WYFXOXVK.cjs');
+require('../chunk-D7EHZFK4.cjs');
+require('../chunk-HDKDQAEQ.cjs');
+var ai = require('ai');
+var zod = require('zod');
+
+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 () => chunkMOU5QRZY_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.",
+    inputSchema: zod.z.object({
+      type: zod.z.string().describe(
+        "Diagram type id from listDiagrams (e.g. 'genogram', 'sld', 'fishbone')."
+      )
+    }),
+    execute: async ({ type }) => chunkMOU5QRZY_cjs.getSyntax(type)
+  }),
+  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.",
+    inputSchema: zod.z.object({
+      type: zod.z.string().describe("Diagram type id."),
+      limit: zod.z.number().int().min(1).max(10).optional().describe("Max examples to return (default 5)."),
+      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) => chunkMOU5QRZY_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.",
+    inputSchema: zod.z.object({
+      type: zod.z.string().optional().describe(
+        "Diagram type. Optional \u2014 Schematex auto-detects from the first line if omitted."
+      ),
+      dsl: zod.z.string().describe("The DSL source text to validate.")
+    }),
+    execute: async ({ type, dsl }) => chunkMOU5QRZY_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)."),
+      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.")
+    }),
+    execute: async ({
+      type,
+      dsl,
+      theme,
+      padding
+    }) => chunkMOU5QRZY_cjs.renderDsl(type, dsl, { theme, padding })
+  })
+};
+
+exports.schematexTools = schematexTools;
+//# sourceMappingURL=ai-sdk.cjs.map
+//# sourceMappingURL=ai-sdk.cjs.map

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

@@ -0,0 +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"]}

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

@@ -0,0 +1,30 @@
+import * as ai from 'ai';
+import { DiagramListItem, GetSyntaxResult, GetExamplesResult, ValidateDslResult, RenderDslResult } from './index.cjs';
+import '../api-bQZ98gkJ.cjs';
+import '../types-C4LnMEcB.cjs';
+
+declare const schematexTools: {
+    readonly listDiagrams: ai.Tool<{}, DiagramListItem[]>;
+    readonly getSyntax: ai.Tool<{
+        type: string;
+    }, GetSyntaxResult>;
+    readonly getExamples: ai.Tool<{
+        type: string;
+        limit?: number | undefined;
+        preferFeatured?: boolean | undefined;
+        maxComplexity?: number | undefined;
+    }, GetExamplesResult>;
+    readonly validateDsl: ai.Tool<{
+        dsl: string;
+        type?: string | undefined;
+    }, ValidateDslResult>;
+    readonly renderDsl: ai.Tool<{
+        dsl: string;
+        type?: string | undefined;
+        theme?: string | undefined;
+        padding?: number | undefined;
+    }, RenderDslResult>;
+};
+type SchematexTools = typeof schematexTools;
+
+export { type SchematexTools, schematexTools };

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

@@ -0,0 +1,30 @@
+import * as ai from 'ai';
+import { DiagramListItem, GetSyntaxResult, GetExamplesResult, ValidateDslResult, RenderDslResult } from './index.js';
+import '../api-bQZ98gkJ.js';
+import '../types-C4LnMEcB.js';
+
+declare const schematexTools: {
+    readonly listDiagrams: ai.Tool<{}, DiagramListItem[]>;
+    readonly getSyntax: ai.Tool<{
+        type: string;
+    }, GetSyntaxResult>;
+    readonly getExamples: ai.Tool<{
+        type: string;
+        limit?: number | undefined;
+        preferFeatured?: boolean | undefined;
+        maxComplexity?: number | undefined;
+    }, GetExamplesResult>;
+    readonly validateDsl: ai.Tool<{
+        dsl: string;
+        type?: string | undefined;
+    }, ValidateDslResult>;
+    readonly renderDsl: ai.Tool<{
+        dsl: string;
+        type?: string | undefined;
+        theme?: string | undefined;
+        padding?: number | undefined;
+    }, RenderDslResult>;
+};
+type SchematexTools = typeof schematexTools;
+
+export { type SchematexTools, schematexTools };

package/dist/ai/ai-sdk.js

@@ -0,0 +1,83 @@
+import { renderDsl, validateDsl, getExamples, getSyntax, listDiagrams } from '../chunk-4QP37LD3.js';
+import '../chunk-S3RBKJM5.js';
+import '../chunk-FCGHV6ZK.js';
+import '../chunk-PGALHQFF.js';
+import '../chunk-UGCUNADI.js';
+import '../chunk-U6L3FAML.js';
+import '../chunk-FE6GAUNW.js';
+import '../chunk-M5B2UUNW.js';
+import '../chunk-ZNDIGQJD.js';
+import '../chunk-JDTB7IKL.js';
+import '../chunk-SN7NTZI6.js';
+import '../chunk-2BM3HJSK.js';
+import '../chunk-LR4X4ZRG.js';
+import '../chunk-OC22GGQN.js';
+import '../chunk-YQANC7HQ.js';
+import '../chunk-RP5UATRA.js';
+import '../chunk-DNZFOCV7.js';
+import '../chunk-45KP67RR.js';
+import '../chunk-5YYAYW67.js';
+import '../chunk-2VNMKOUO.js';
+import '../chunk-KLJEK547.js';
+import { tool } from 'ai';
+import { z } from 'zod';
+
+var schematexTools = {
+  listDiagrams: 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: z.object({}),
+    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.",
+    inputSchema: z.object({
+      type: z.string().describe(
+        "Diagram type id from listDiagrams (e.g. 'genogram', 'sld', 'fishbone')."
+      )
+    }),
+    execute: async ({ type }) => getSyntax(type)
+  }),
+  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.",
+    inputSchema: z.object({
+      type: z.string().describe("Diagram type id."),
+      limit: z.number().int().min(1).max(10).optional().describe("Max examples to return (default 5)."),
+      preferFeatured: z.boolean().optional().describe("Rank featured examples first."),
+      maxComplexity: z.number().int().min(1).max(5).optional().describe("Only return examples with complexity <= this value (1=simplest).")
+    }),
+    execute: async (args) => getExamples(args.type, {
+      limit: args.limit,
+      preferFeatured: args.preferFeatured,
+      maxComplexity: args.maxComplexity
+    })
+  }),
+  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.",
+    inputSchema: z.object({
+      type: z.string().optional().describe(
+        "Diagram type. Optional \u2014 Schematex auto-detects from the first line if omitted."
+      ),
+      dsl: z.string().describe("The DSL source text to validate.")
+    }),
+    execute: async ({ type, dsl }) => validateDsl(type, dsl)
+  }),
+  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)."),
+      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.")
+    }),
+    execute: async ({
+      type,
+      dsl,
+      theme,
+      padding
+    }) => renderDsl(type, dsl, { theme, padding })
+  })
+};
+
+export { schematexTools };
+//# sourceMappingURL=ai-sdk.js.map
+//# sourceMappingURL=ai-sdk.js.map

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

@@ -0,0 +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"]}

package/dist/ai/index.cjs

@@ -0,0 +1,60 @@
+'use strict';
+
+var chunkMOU5QRZY_cjs = require('../chunk-MOU5QRZY.cjs');
+require('../chunk-QXIGHMH2.cjs');
+require('../chunk-A5D2IMOX.cjs');
+require('../chunk-4S2WILLW.cjs');
+require('../chunk-MCFQAUQV.cjs');
+require('../chunk-B6INLQBU.cjs');
+require('../chunk-3YZ6FPQW.cjs');
+require('../chunk-ZNOD4VZT.cjs');
+require('../chunk-5AEN2PLB.cjs');
+require('../chunk-QSQX77S2.cjs');
+require('../chunk-Z3DE6S64.cjs');
+require('../chunk-6LZJTAA3.cjs');
+require('../chunk-E65ITQXV.cjs');
+require('../chunk-B37IKTI7.cjs');
+require('../chunk-X7RPFTTR.cjs');
+require('../chunk-COLTVQWR.cjs');
+require('../chunk-ULYRO2KY.cjs');
+require('../chunk-2JDVJRR3.cjs');
+require('../chunk-WYFXOXVK.cjs');
+require('../chunk-D7EHZFK4.cjs');
+require('../chunk-HDKDQAEQ.cjs');
+
+
+
+Object.defineProperty(exports, "DIAGRAM_REGISTRY", {
+  enumerable: true,
+  get: function () { return chunkMOU5QRZY_cjs.DIAGRAM_REGISTRY; }
+});
+Object.defineProperty(exports, "getAllDiagramTypes", {
+  enumerable: true,
+  get: function () { return chunkMOU5QRZY_cjs.getAllDiagramTypes; }
+});
+Object.defineProperty(exports, "getDiagramMeta", {
+  enumerable: true,
+  get: function () { return chunkMOU5QRZY_cjs.getDiagramMeta; }
+});
+Object.defineProperty(exports, "getExamples", {
+  enumerable: true,
+  get: function () { return chunkMOU5QRZY_cjs.getExamples; }
+});
+Object.defineProperty(exports, "getSyntax", {
+  enumerable: true,
+  get: function () { return chunkMOU5QRZY_cjs.getSyntax; }
+});
+Object.defineProperty(exports, "listDiagrams", {
+  enumerable: true,
+  get: function () { return chunkMOU5QRZY_cjs.listDiagrams; }
+});
+Object.defineProperty(exports, "renderDsl", {
+  enumerable: true,
+  get: function () { return chunkMOU5QRZY_cjs.renderDsl; }
+});
+Object.defineProperty(exports, "validateDsl", {
+  enumerable: true,
+  get: function () { return chunkMOU5QRZY_cjs.validateDsl; }
+});
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/ai/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}

package/dist/ai/index.d.cts

@@ -0,0 +1,155 @@
+import { S as SchematexConfig } from '../api-bQZ98gkJ.cjs';
+import { q as DiagramType } from '../types-C4LnMEcB.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";
+interface DiagramMeta {
+    /** Canonical type id — matches `DiagramType` and plugin keys. */
+    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 };

package/dist/ai/index.d.ts

@@ -0,0 +1,155 @@
+import { S as SchematexConfig } from '../api-bQZ98gkJ.js';
+import { q as DiagramType } from '../types-C4LnMEcB.js';
+
+/**
+ * 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";
+interface DiagramMeta {
+    /** Canonical type id — matches `DiagramType` and plugin keys. */
+    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 };

package/dist/ai/index.js

@@ -0,0 +1,23 @@
+export { DIAGRAM_REGISTRY, getAllDiagramTypes, getDiagramMeta, getExamples, getSyntax, listDiagrams, renderDsl, validateDsl } from '../chunk-4QP37LD3.js';
+import '../chunk-S3RBKJM5.js';
+import '../chunk-FCGHV6ZK.js';
+import '../chunk-PGALHQFF.js';
+import '../chunk-UGCUNADI.js';
+import '../chunk-U6L3FAML.js';
+import '../chunk-FE6GAUNW.js';
+import '../chunk-M5B2UUNW.js';
+import '../chunk-ZNDIGQJD.js';
+import '../chunk-JDTB7IKL.js';
+import '../chunk-SN7NTZI6.js';
+import '../chunk-2BM3HJSK.js';
+import '../chunk-LR4X4ZRG.js';
+import '../chunk-OC22GGQN.js';
+import '../chunk-YQANC7HQ.js';
+import '../chunk-RP5UATRA.js';
+import '../chunk-DNZFOCV7.js';
+import '../chunk-45KP67RR.js';
+import '../chunk-5YYAYW67.js';
+import '../chunk-2VNMKOUO.js';
+import '../chunk-KLJEK547.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/ai/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}