schematex 0.8.2 → 0.9.0

package/dist/ai/ai-sdk.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkHWNVSNDJ_cjs = require('../chunk-HWNVSNDJ.cjs');
+var chunkHKOPXQYU_cjs = require('../chunk-HKOPXQYU.cjs');
 require('../chunk-UGB42BGK.cjs');
 require('../chunk-Q2YRJHFB.cjs');
 require('../chunk-JIJWGHRN.cjs');
@@ -31,7 +31,7 @@ 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 () => chunkHWNVSNDJ_cjs.listDiagrams()
+    execute: async () => chunkHKOPXQYU_cjs.listDiagrams()
   }),
   getSyntax: ai.tool({
     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.",
@@ -46,7 +46,7 @@ var schematexTools = {
     execute: async ({
       type,
       detail
-    }) => chunkHWNVSNDJ_cjs.getSyntax(type, { detail })
+    }) => chunkHKOPXQYU_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.",
@@ -56,7 +56,7 @@ 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) => chunkHWNVSNDJ_cjs.getExamples(args.type, {
+    execute: async (args) => chunkHKOPXQYU_cjs.getExamples(args.type, {
       limit: args.limit,
       preferFeatured: args.preferFeatured,
       maxComplexity: args.maxComplexity
@@ -70,7 +70,7 @@ var schematexTools = {
       ),
       dsl: zod.z.string().describe("The DSL source text to validate.")
     }),
-    execute: async ({ type, dsl }) => chunkHWNVSNDJ_cjs.validateDsl(type, dsl)
+    execute: async ({ type, dsl }) => chunkHKOPXQYU_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.",
@@ -85,7 +85,7 @@ var schematexTools = {
       dsl,
       theme,
       padding
-    }) => chunkHWNVSNDJ_cjs.renderDsl(type, dsl, { theme, padding })
+    }) => chunkHKOPXQYU_cjs.renderDsl(type, dsl, { theme, padding })
   })
 };
 

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

@@ -1,5 +1,5 @@
 import * as ai from 'ai';
-import { c as DiagramListItem, g as GetSyntaxResult, e as GetExamplesResult, V as ValidateDslResult, R as RenderDslResult } from '../tools-CVgUmiGP.cjs';
+import { c as DiagramListItem, g as GetSyntaxResult, e as GetExamplesResult, V as ValidateDslResult, R as RenderDslResult } from '../tools-D5dkAqNy.cjs';
 import '../api-BDMaX1cT.cjs';
 import '../diagnostics-hObcaaFC.cjs';
 
@@ -7,7 +7,7 @@ declare const schematexTools: {
     readonly listDiagrams: ai.Tool<{}, DiagramListItem[]>;
     readonly getSyntax: ai.Tool<{
         type: string;
-        detail?: "reference" | "canonical" | undefined;
+        detail?: "canonical" | "reference" | undefined;
     }, GetSyntaxResult>;
     readonly getExamples: ai.Tool<{
         type: string;

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

@@ -1,5 +1,5 @@
 import * as ai from 'ai';
-import { c as DiagramListItem, g as GetSyntaxResult, e as GetExamplesResult, V as ValidateDslResult, R as RenderDslResult } from '../tools-CbBjmZVr.js';
+import { c as DiagramListItem, g as GetSyntaxResult, e as GetExamplesResult, V as ValidateDslResult, R as RenderDslResult } from '../tools-BbTuTWs_.js';
 import '../api-OED2jUVj.js';
 import '../diagnostics-hObcaaFC.js';
 
@@ -7,7 +7,7 @@ declare const schematexTools: {
     readonly listDiagrams: ai.Tool<{}, DiagramListItem[]>;
     readonly getSyntax: ai.Tool<{
         type: string;
-        detail?: "reference" | "canonical" | undefined;
+        detail?: "canonical" | "reference" | undefined;
     }, GetSyntaxResult>;
     readonly getExamples: ai.Tool<{
         type: string;

package/dist/ai/ai-sdk.js

@@ -1,4 +1,4 @@
-import { renderDsl, validateDsl, getExamples, getSyntax, listDiagrams } from '../chunk-FLDHD4RM.js';
+import { renderDsl, validateDsl, getExamples, getSyntax, listDiagrams } from '../chunk-PR6IAGVP.js';
 import '../chunk-LM5X7ZNR.js';
 import '../chunk-E3CAJGJM.js';
 import '../chunk-T3GV7OVF.js';

package/dist/ai/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkHWNVSNDJ_cjs = require('../chunk-HWNVSNDJ.cjs');
+var chunkHKOPXQYU_cjs = require('../chunk-HKOPXQYU.cjs');
 require('../chunk-UGB42BGK.cjs');
 require('../chunk-Q2YRJHFB.cjs');
 require('../chunk-JIJWGHRN.cjs');
@@ -25,51 +25,90 @@ require('../chunk-NZT5P2XZ.cjs');
 require('../chunk-VHDSPI6A.cjs');
 require('../chunk-3WNW5Y7P.cjs');
 
-
+// src/ai/prompt-context.ts
+function buildPromptContext(type, opts = {}) {
+  const resolved = chunkHKOPXQYU_cjs.resolveDiagramType(type) ?? type;
+  const detail = opts.detail ?? "canonical";
+  const limit = opts.examples ?? 2;
+  const { type: canonical, name, standard, syntax } = chunkHKOPXQYU_cjs.getSyntax(resolved, {
+    detail
+  });
+  const parts = [
+    `# ${name} (${canonical})`,
+    `Standard: ${standard}`,
+    "",
+    syntax.content
+  ];
+  let exampleCount = 0;
+  if (limit > 0) {
+    const examples = chunkHKOPXQYU_cjs.getExamples(canonical, {
+      preferFeatured: opts.preferFeatured ?? true,
+      limit,
+      maxComplexity: opts.maxComplexity
+    }).examples;
+    exampleCount = examples.length;
+    if (examples.length > 0) {
+      parts.push("", "## Worked examples");
+      for (const ex of examples) {
+        parts.push("", `### ${ex.title}`);
+        if (ex.description) parts.push(ex.description);
+        parts.push("```", ex.dsl.trim(), "```");
+      }
+    }
+  }
+  return {
+    type: canonical,
+    name,
+    standard,
+    text: parts.join("\n"),
+    exampleCount
+  };
+}
 
 Object.defineProperty(exports, "DIAGRAM_REGISTRY", {
   enumerable: true,
-  get: function () { return chunkHWNVSNDJ_cjs.DIAGRAM_REGISTRY; }
+  get: function () { return chunkHKOPXQYU_cjs.DIAGRAM_REGISTRY; }
 });
 Object.defineProperty(exports, "DIAGRAM_SINCE", {
   enumerable: true,
-  get: function () { return chunkHWNVSNDJ_cjs.DIAGRAM_SINCE; }
+  get: function () { return chunkHKOPXQYU_cjs.DIAGRAM_SINCE; }
 });
 Object.defineProperty(exports, "getAllDiagramTypes", {
   enumerable: true,
-  get: function () { return chunkHWNVSNDJ_cjs.getAllDiagramTypes; }
+  get: function () { return chunkHKOPXQYU_cjs.getAllDiagramTypes; }
 });
 Object.defineProperty(exports, "getDiagramMeta", {
   enumerable: true,
-  get: function () { return chunkHWNVSNDJ_cjs.getDiagramMeta; }
+  get: function () { return chunkHKOPXQYU_cjs.getDiagramMeta; }
 });
 Object.defineProperty(exports, "getDiagramSince", {
   enumerable: true,
-  get: function () { return chunkHWNVSNDJ_cjs.getDiagramSince; }
+  get: function () { return chunkHKOPXQYU_cjs.getDiagramSince; }
 });
 Object.defineProperty(exports, "getExamples", {
   enumerable: true,
-  get: function () { return chunkHWNVSNDJ_cjs.getExamples; }
+  get: function () { return chunkHKOPXQYU_cjs.getExamples; }
 });
 Object.defineProperty(exports, "getSyntax", {
   enumerable: true,
-  get: function () { return chunkHWNVSNDJ_cjs.getSyntax; }
+  get: function () { return chunkHKOPXQYU_cjs.getSyntax; }
 });
 Object.defineProperty(exports, "listDiagrams", {
   enumerable: true,
-  get: function () { return chunkHWNVSNDJ_cjs.listDiagrams; }
+  get: function () { return chunkHKOPXQYU_cjs.listDiagrams; }
 });
 Object.defineProperty(exports, "renderDsl", {
   enumerable: true,
-  get: function () { return chunkHWNVSNDJ_cjs.renderDsl; }
+  get: function () { return chunkHKOPXQYU_cjs.renderDsl; }
 });
 Object.defineProperty(exports, "resolveDiagramType", {
   enumerable: true,
-  get: function () { return chunkHWNVSNDJ_cjs.resolveDiagramType; }
+  get: function () { return chunkHKOPXQYU_cjs.resolveDiagramType; }
 });
 Object.defineProperty(exports, "validateDsl", {
   enumerable: true,
-  get: function () { return chunkHWNVSNDJ_cjs.validateDsl; }
+  get: function () { return chunkHKOPXQYU_cjs.validateDsl; }
 });
+exports.buildPromptContext = buildPromptContext;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/ai/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}
+{"version":3,"sources":["../../src/ai/prompt-context.ts"],"names":["resolveDiagramType","getSyntax","getExamples"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4CO,SAAS,kBAAA,CACd,IAAA,EACA,IAAA,GAAkC,EAAC,EACpB;AACf,EAAA,MAAM,QAAA,GAAWA,oCAAA,CAAmB,IAAI,CAAA,IAAK,IAAA;AAC7C,EAAA,MAAM,MAAA,GAAuB,KAAK,MAAA,IAAU,WAAA;AAC5C,EAAA,MAAM,KAAA,GAAQ,KAAK,QAAA,IAAY,CAAA;AAE/B,EAAA,MAAM,EAAE,MAAM,SAAA,EAAW,IAAA,EAAM,UAAU,MAAA,EAAO,GAAIC,4BAAU,QAAA,EAAU;AAAA,IACtE;AAAA,GACD,CAAA;AAED,EAAA,MAAM,KAAA,GAAkB;AAAA,IACtB,CAAA,EAAA,EAAK,IAAI,CAAA,EAAA,EAAK,SAAS,CAAA,CAAA,CAAA;AAAA,IACvB,aAAa,QAAQ,CAAA,CAAA;AAAA,IACrB,EAAA;AAAA,IACA,MAAA,CAAO;AAAA,GACT;AAEA,EAAA,IAAI,YAAA,GAAe,CAAA;AACnB,EAAA,IAAI,QAAQ,CAAA,EAAG;AACb,IAAA,MAAM,QAAA,GAAWC,8BAAY,SAAA,EAAW;AAAA,MACtC,cAAA,EAAgB,KAAK,cAAA,IAAkB,IAAA;AAAA,MACvC,KAAA;AAAA,MACA,eAAe,IAAA,CAAK;AAAA,KACrB,CAAA,CAAE,QAAA;AACH,IAAA,YAAA,GAAe,QAAA,CAAS,MAAA;AACxB,IAAA,IAAI,QAAA,CAAS,SAAS,CAAA,EAAG;AACvB,MAAA,KAAA,CAAM,IAAA,CAAK,IAAI,oBAAoB,CAAA;AACnC,MAAA,KAAA,MAAW,MAAM,QAAA,EAAU;AACzB,QAAA,KAAA,CAAM,IAAA,CAAK,EAAA,EAAI,CAAA,IAAA,EAAO,EAAA,CAAG,KAAK,CAAA,CAAE,CAAA;AAChC,QAAA,IAAI,EAAA,CAAG,WAAA,EAAa,KAAA,CAAM,IAAA,CAAK,GAAG,WAAW,CAAA;AAC7C,QAAA,KAAA,CAAM,KAAK,KAAA,EAAO,EAAA,CAAG,GAAA,CAAI,IAAA,IAAQ,KAAK,CAAA;AAAA,MACxC;AAAA,IACF;AAAA,EACF;AAEA,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,SAAA;AAAA,IACN,IAAA;AAAA,IACA,QAAA;AAAA,IACA,IAAA,EAAM,KAAA,CAAM,IAAA,CAAK,IAAI,CAAA;AAAA,IACrB;AAAA,GACF;AACF","file":"index.cjs","sourcesContent":["/**\n * Prompt-context builder — a convenience wrapper for single-shot LLM callers.\n *\n * Agentic callers can keep using `getSyntax` + `getExamples` as separate tool\n * round-trips. But a high-volume single-shot caller (e.g. a product backend\n * generating DSL with one model call, no tool loop) just wants ONE inject-ready\n * block: the canonical grammar card plus a couple of worked few-shot examples.\n *\n * This adds no new knowledge — it stitches `getSyntax(detail: \"canonical\")` and\n * `getExamples(preferFeatured)` into one string so the caller doesn't have to\n * know the recipe. Both primitives remain exported and usable on their own.\n */\nimport { resolveDiagramType } from \"./registry\";\nimport { getExamples, getSyntax } from \"./tools\";\nimport type { SyntaxDetail } from \"./syntax\";\n\nexport interface BuildPromptContextOptions {\n  /** How many few-shot examples to embed. Default 2. Set 0 to omit examples. */\n  examples?: number;\n  /** Syntax detail level. Default `\"canonical\"` (the compact first-shot card). */\n  detail?: SyntaxDetail;\n  /** Prefer `featured: true` examples first. Default true. */\n  preferFeatured?: boolean;\n  /** Cap embedded example complexity (1–5). */\n  maxComplexity?: number;\n}\n\nexport interface PromptContext {\n  type: string;\n  name: string;\n  standard: string;\n  /** One inject-ready markdown block: grammar card + worked examples. */\n  text: string;\n  /** Number of examples embedded in `text`. */\n  exampleCount: number;\n}\n\n/**\n * Build a single inject-ready prompt block for one diagram type.\n *\n * @example\n * const ctx = buildPromptContext(\"genogram\");\n * const systemPrompt = `Generate Schematex DSL.\\n\\n${ctx.text}`;\n */\nexport function buildPromptContext(\n  type: string,\n  opts: BuildPromptContextOptions = {}\n): PromptContext {\n  const resolved = resolveDiagramType(type) ?? type;\n  const detail: SyntaxDetail = opts.detail ?? \"canonical\";\n  const limit = opts.examples ?? 2;\n\n  const { type: canonical, name, standard, syntax } = getSyntax(resolved, {\n    detail,\n  });\n\n  const parts: string[] = [\n    `# ${name} (${canonical})`,\n    `Standard: ${standard}`,\n    \"\",\n    syntax.content,\n  ];\n\n  let exampleCount = 0;\n  if (limit > 0) {\n    const examples = getExamples(canonical, {\n      preferFeatured: opts.preferFeatured ?? true,\n      limit,\n      maxComplexity: opts.maxComplexity,\n    }).examples;\n    exampleCount = examples.length;\n    if (examples.length > 0) {\n      parts.push(\"\", \"## Worked examples\");\n      for (const ex of examples) {\n        parts.push(\"\", `### ${ex.title}`);\n        if (ex.description) parts.push(ex.description);\n        parts.push(\"```\", ex.dsl.trim(), \"```\");\n      }\n    }\n  }\n\n  return {\n    type: canonical,\n    name,\n    standard,\n    text: parts.join(\"\\n\"),\n    exampleCount,\n  };\n}\n"]}

package/dist/ai/index.d.cts

@@ -1,7 +1,36 @@
-export { D as DIAGRAM_REGISTRY, a as DIAGRAM_SINCE, b as DiagramCluster, c as DiagramListItem, d as DiagramMeta, E as Example, G as GetExamplesOptions, e as GetExamplesResult, f as GetSyntaxOptions, g as GetSyntaxResult, R as RenderDslResult, S as SchematexValidationError, h as SyntaxDetail, i as SyntaxDoc, V as ValidateDslResult, j as getAllDiagramTypes, k as getDiagramMeta, l as getDiagramSince, m as getExamples, n as getSyntax, o as listDiagrams, r as renderDsl, p as resolveDiagramType, v as validateDsl } from '../tools-CVgUmiGP.cjs';
+import { S as SyntaxDetail } from '../tools-D5dkAqNy.cjs';
+export { D as DIAGRAM_REGISTRY, a as DIAGRAM_SINCE, b as DiagramCluster, c as DiagramListItem, d as DiagramMeta, E as Example, G as GetExamplesOptions, e as GetExamplesResult, f as GetSyntaxOptions, g as GetSyntaxResult, R as RenderDslResult, h as SchematexValidationError, i as SyntaxDoc, V as ValidateDslResult, j as getAllDiagramTypes, k as getDiagramMeta, l as getDiagramSince, m as getExamples, n as getSyntax, o as listDiagrams, r as renderDsl, p as resolveDiagramType, v as validateDsl } from '../tools-D5dkAqNy.cjs';
 import { a as DiagramType } from '../diagnostics-hObcaaFC.cjs';
 import '../api-BDMaX1cT.cjs';
 
+interface BuildPromptContextOptions {
+    /** How many few-shot examples to embed. Default 2. Set 0 to omit examples. */
+    examples?: number;
+    /** Syntax detail level. Default `"canonical"` (the compact first-shot card). */
+    detail?: SyntaxDetail;
+    /** Prefer `featured: true` examples first. Default true. */
+    preferFeatured?: boolean;
+    /** Cap embedded example complexity (1–5). */
+    maxComplexity?: number;
+}
+interface PromptContext {
+    type: string;
+    name: string;
+    standard: string;
+    /** One inject-ready markdown block: grammar card + worked examples. */
+    text: string;
+    /** Number of examples embedded in `text`. */
+    exampleCount: number;
+}
+/**
+ * Build a single inject-ready prompt block for one diagram type.
+ *
+ * @example
+ * const ctx = buildPromptContext("genogram");
+ * const systemPrompt = `Generate Schematex DSL.\n\n${ctx.text}`;
+ */
+declare function buildPromptContext(type: string, opts?: BuildPromptContextOptions): PromptContext;
+
 interface GenerationProfile {
     /** Canonical type id from `listDiagrams()`. */
     type: DiagramType;
@@ -9,6 +38,12 @@ interface GenerationProfile {
     header: string;
     /** Short name for the preferred authoring mode when a parser has several. */
     mode: string;
+    /**
+     * Compact one-line vocabulary — the full set of keywords / operators / tokens
+     * the parser accepts, so a single-shot caller sees the whole surface without
+     * fetching the `reference` syntax. Optional.
+     */
+    keywords?: string;
     /** Forms that cover most first-shot generations for this type. */
     forms: readonly string[];
     /** Short grammar choices the model should make by default. */
@@ -19,4 +54,4 @@ interface GenerationProfile {
     repair: readonly string[];
 }
 
-export { DiagramType, type GenerationProfile };
+export { type BuildPromptContextOptions, DiagramType, type GenerationProfile, type PromptContext, SyntaxDetail, buildPromptContext };

package/dist/ai/index.d.ts

@@ -1,7 +1,36 @@
-export { D as DIAGRAM_REGISTRY, a as DIAGRAM_SINCE, b as DiagramCluster, c as DiagramListItem, d as DiagramMeta, E as Example, G as GetExamplesOptions, e as GetExamplesResult, f as GetSyntaxOptions, g as GetSyntaxResult, R as RenderDslResult, S as SchematexValidationError, h as SyntaxDetail, i as SyntaxDoc, V as ValidateDslResult, j as getAllDiagramTypes, k as getDiagramMeta, l as getDiagramSince, m as getExamples, n as getSyntax, o as listDiagrams, r as renderDsl, p as resolveDiagramType, v as validateDsl } from '../tools-CbBjmZVr.js';
+import { S as SyntaxDetail } from '../tools-BbTuTWs_.js';
+export { D as DIAGRAM_REGISTRY, a as DIAGRAM_SINCE, b as DiagramCluster, c as DiagramListItem, d as DiagramMeta, E as Example, G as GetExamplesOptions, e as GetExamplesResult, f as GetSyntaxOptions, g as GetSyntaxResult, R as RenderDslResult, h as SchematexValidationError, i as SyntaxDoc, V as ValidateDslResult, j as getAllDiagramTypes, k as getDiagramMeta, l as getDiagramSince, m as getExamples, n as getSyntax, o as listDiagrams, r as renderDsl, p as resolveDiagramType, v as validateDsl } from '../tools-BbTuTWs_.js';
 import { a as DiagramType } from '../diagnostics-hObcaaFC.js';
 import '../api-OED2jUVj.js';
 
+interface BuildPromptContextOptions {
+    /** How many few-shot examples to embed. Default 2. Set 0 to omit examples. */
+    examples?: number;
+    /** Syntax detail level. Default `"canonical"` (the compact first-shot card). */
+    detail?: SyntaxDetail;
+    /** Prefer `featured: true` examples first. Default true. */
+    preferFeatured?: boolean;
+    /** Cap embedded example complexity (1–5). */
+    maxComplexity?: number;
+}
+interface PromptContext {
+    type: string;
+    name: string;
+    standard: string;
+    /** One inject-ready markdown block: grammar card + worked examples. */
+    text: string;
+    /** Number of examples embedded in `text`. */
+    exampleCount: number;
+}
+/**
+ * Build a single inject-ready prompt block for one diagram type.
+ *
+ * @example
+ * const ctx = buildPromptContext("genogram");
+ * const systemPrompt = `Generate Schematex DSL.\n\n${ctx.text}`;
+ */
+declare function buildPromptContext(type: string, opts?: BuildPromptContextOptions): PromptContext;
+
 interface GenerationProfile {
     /** Canonical type id from `listDiagrams()`. */
     type: DiagramType;
@@ -9,6 +38,12 @@ interface GenerationProfile {
     header: string;
     /** Short name for the preferred authoring mode when a parser has several. */
     mode: string;
+    /**
+     * Compact one-line vocabulary — the full set of keywords / operators / tokens
+     * the parser accepts, so a single-shot caller sees the whole surface without
+     * fetching the `reference` syntax. Optional.
+     */
+    keywords?: string;
     /** Forms that cover most first-shot generations for this type. */
     forms: readonly string[];
     /** Short grammar choices the model should make by default. */
@@ -19,4 +54,4 @@ interface GenerationProfile {
     repair: readonly string[];
 }
 
-export { DiagramType, type GenerationProfile };
+export { type BuildPromptContextOptions, DiagramType, type GenerationProfile, type PromptContext, SyntaxDetail, buildPromptContext };

package/dist/ai/index.js

@@ -1,4 +1,5 @@
-export { DIAGRAM_REGISTRY, DIAGRAM_SINCE, getAllDiagramTypes, getDiagramMeta, getDiagramSince, getExamples, getSyntax, listDiagrams, renderDsl, resolveDiagramType, validateDsl } from '../chunk-FLDHD4RM.js';
+import { resolveDiagramType, getSyntax, getExamples } from '../chunk-PR6IAGVP.js';
+export { DIAGRAM_REGISTRY, DIAGRAM_SINCE, getAllDiagramTypes, getDiagramMeta, getDiagramSince, getExamples, getSyntax, listDiagrams, renderDsl, resolveDiagramType, validateDsl } from '../chunk-PR6IAGVP.js';
 import '../chunk-LM5X7ZNR.js';
 import '../chunk-E3CAJGJM.js';
 import '../chunk-T3GV7OVF.js';
@@ -22,5 +23,47 @@ import '../chunk-PIV2A3HG.js';
 import '../chunk-UK6HF6PE.js';
 import '../chunk-TO6PNBT3.js';
 import '../chunk-SYYBKDL7.js';
+
+// src/ai/prompt-context.ts
+function buildPromptContext(type, opts = {}) {
+  const resolved = resolveDiagramType(type) ?? type;
+  const detail = opts.detail ?? "canonical";
+  const limit = opts.examples ?? 2;
+  const { type: canonical, name, standard, syntax } = getSyntax(resolved, {
+    detail
+  });
+  const parts = [
+    `# ${name} (${canonical})`,
+    `Standard: ${standard}`,
+    "",
+    syntax.content
+  ];
+  let exampleCount = 0;
+  if (limit > 0) {
+    const examples = getExamples(canonical, {
+      preferFeatured: opts.preferFeatured ?? true,
+      limit,
+      maxComplexity: opts.maxComplexity
+    }).examples;
+    exampleCount = examples.length;
+    if (examples.length > 0) {
+      parts.push("", "## Worked examples");
+      for (const ex of examples) {
+        parts.push("", `### ${ex.title}`);
+        if (ex.description) parts.push(ex.description);
+        parts.push("```", ex.dsl.trim(), "```");
+      }
+    }
+  }
+  return {
+    type: canonical,
+    name,
+    standard,
+    text: parts.join("\n"),
+    exampleCount
+  };
+}
+
+export { buildPromptContext };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/ai/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}
+{"version":3,"sources":["../../src/ai/prompt-context.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AA4CO,SAAS,kBAAA,CACd,IAAA,EACA,IAAA,GAAkC,EAAC,EACpB;AACf,EAAA,MAAM,QAAA,GAAW,kBAAA,CAAmB,IAAI,CAAA,IAAK,IAAA;AAC7C,EAAA,MAAM,MAAA,GAAuB,KAAK,MAAA,IAAU,WAAA;AAC5C,EAAA,MAAM,KAAA,GAAQ,KAAK,QAAA,IAAY,CAAA;AAE/B,EAAA,MAAM,EAAE,MAAM,SAAA,EAAW,IAAA,EAAM,UAAU,MAAA,EAAO,GAAI,UAAU,QAAA,EAAU;AAAA,IACtE;AAAA,GACD,CAAA;AAED,EAAA,MAAM,KAAA,GAAkB;AAAA,IACtB,CAAA,EAAA,EAAK,IAAI,CAAA,EAAA,EAAK,SAAS,CAAA,CAAA,CAAA;AAAA,IACvB,aAAa,QAAQ,CAAA,CAAA;AAAA,IACrB,EAAA;AAAA,IACA,MAAA,CAAO;AAAA,GACT;AAEA,EAAA,IAAI,YAAA,GAAe,CAAA;AACnB,EAAA,IAAI,QAAQ,CAAA,EAAG;AACb,IAAA,MAAM,QAAA,GAAW,YAAY,SAAA,EAAW;AAAA,MACtC,cAAA,EAAgB,KAAK,cAAA,IAAkB,IAAA;AAAA,MACvC,KAAA;AAAA,MACA,eAAe,IAAA,CAAK;AAAA,KACrB,CAAA,CAAE,QAAA;AACH,IAAA,YAAA,GAAe,QAAA,CAAS,MAAA;AACxB,IAAA,IAAI,QAAA,CAAS,SAAS,CAAA,EAAG;AACvB,MAAA,KAAA,CAAM,IAAA,CAAK,IAAI,oBAAoB,CAAA;AACnC,MAAA,KAAA,MAAW,MAAM,QAAA,EAAU;AACzB,QAAA,KAAA,CAAM,IAAA,CAAK,EAAA,EAAI,CAAA,IAAA,EAAO,EAAA,CAAG,KAAK,CAAA,CAAE,CAAA;AAChC,QAAA,IAAI,EAAA,CAAG,WAAA,EAAa,KAAA,CAAM,IAAA,CAAK,GAAG,WAAW,CAAA;AAC7C,QAAA,KAAA,CAAM,KAAK,KAAA,EAAO,EAAA,CAAG,GAAA,CAAI,IAAA,IAAQ,KAAK,CAAA;AAAA,MACxC;AAAA,IACF;AAAA,EACF;AAEA,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,SAAA;AAAA,IACN,IAAA;AAAA,IACA,QAAA;AAAA,IACA,IAAA,EAAM,KAAA,CAAM,IAAA,CAAK,IAAI,CAAA;AAAA,IACrB;AAAA,GACF;AACF","file":"index.js","sourcesContent":["/**\n * Prompt-context builder — a convenience wrapper for single-shot LLM callers.\n *\n * Agentic callers can keep using `getSyntax` + `getExamples` as separate tool\n * round-trips. But a high-volume single-shot caller (e.g. a product backend\n * generating DSL with one model call, no tool loop) just wants ONE inject-ready\n * block: the canonical grammar card plus a couple of worked few-shot examples.\n *\n * This adds no new knowledge — it stitches `getSyntax(detail: \"canonical\")` and\n * `getExamples(preferFeatured)` into one string so the caller doesn't have to\n * know the recipe. Both primitives remain exported and usable on their own.\n */\nimport { resolveDiagramType } from \"./registry\";\nimport { getExamples, getSyntax } from \"./tools\";\nimport type { SyntaxDetail } from \"./syntax\";\n\nexport interface BuildPromptContextOptions {\n  /** How many few-shot examples to embed. Default 2. Set 0 to omit examples. */\n  examples?: number;\n  /** Syntax detail level. Default `\"canonical\"` (the compact first-shot card). */\n  detail?: SyntaxDetail;\n  /** Prefer `featured: true` examples first. Default true. */\n  preferFeatured?: boolean;\n  /** Cap embedded example complexity (1–5). */\n  maxComplexity?: number;\n}\n\nexport interface PromptContext {\n  type: string;\n  name: string;\n  standard: string;\n  /** One inject-ready markdown block: grammar card + worked examples. */\n  text: string;\n  /** Number of examples embedded in `text`. */\n  exampleCount: number;\n}\n\n/**\n * Build a single inject-ready prompt block for one diagram type.\n *\n * @example\n * const ctx = buildPromptContext(\"genogram\");\n * const systemPrompt = `Generate Schematex DSL.\\n\\n${ctx.text}`;\n */\nexport function buildPromptContext(\n  type: string,\n  opts: BuildPromptContextOptions = {}\n): PromptContext {\n  const resolved = resolveDiagramType(type) ?? type;\n  const detail: SyntaxDetail = opts.detail ?? \"canonical\";\n  const limit = opts.examples ?? 2;\n\n  const { type: canonical, name, standard, syntax } = getSyntax(resolved, {\n    detail,\n  });\n\n  const parts: string[] = [\n    `# ${name} (${canonical})`,\n    `Standard: ${standard}`,\n    \"\",\n    syntax.content,\n  ];\n\n  let exampleCount = 0;\n  if (limit > 0) {\n    const examples = getExamples(canonical, {\n      preferFeatured: opts.preferFeatured ?? true,\n      limit,\n      maxComplexity: opts.maxComplexity,\n    }).examples;\n    exampleCount = examples.length;\n    if (examples.length > 0) {\n      parts.push(\"\", \"## Worked examples\");\n      for (const ex of examples) {\n        parts.push(\"\", `### ${ex.title}`);\n        if (ex.description) parts.push(ex.description);\n        parts.push(\"```\", ex.dsl.trim(), \"```\");\n      }\n    }\n  }\n\n  return {\n    type: canonical,\n    name,\n    standard,\n    text: parts.join(\"\\n\"),\n    exampleCount,\n  };\n}\n"]}