schematex 0.5.0 → 0.5.2

package/dist/ai/index.d.ts

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

package/dist/ai/index.js

@@ -1,7 +1,7 @@
-export { DIAGRAM_REGISTRY, getAllDiagramTypes, getDiagramMeta, getExamples, getSyntax, listDiagrams, renderDsl, validateDsl } from '../chunk-IM4RCUHA.js';
-import '../chunk-GTDQAN2Z.js';
+export { DIAGRAM_REGISTRY, getAllDiagramTypes, getDiagramMeta, getExamples, getSyntax, listDiagrams, renderDsl, resolveDiagramType, validateDsl } from '../chunk-VKPCR7BG.js';
+import '../chunk-OK5ZS3LU.js';
 import '../chunk-I55HO32M.js';
-import '../chunk-HUPDIRBX.js';
+import '../chunk-VCH7RI5H.js';
 import '../chunk-EPKIJEH7.js';
 import '../chunk-IBRW3UOA.js';
 import '../chunk-6OSUNBZY.js';

package/dist/api-C5SECOxZ.d.cts

@@ -0,0 +1,69 @@
+import { q as DiagramType } from './types-WTr9W5Ud.cjs';
+
+type SchematexResultStatus = "valid" | "partial" | "invalid";
+interface SchematexDiagnostic {
+    severity: "error" | "warning";
+    code: string;
+    message: string;
+    line?: number;
+    column?: number;
+    source?: string;
+    hint?: string;
+    fatal: boolean;
+}
+type SchematexParseResult = {
+    ok: true;
+    status: "valid" | "partial";
+    type: DiagramType;
+    ast: unknown;
+    diagnostics: SchematexDiagnostic[];
+} | {
+    ok: false;
+    status: "invalid";
+    type: DiagramType | null;
+    diagnostics: SchematexDiagnostic[];
+};
+type SchematexRenderResult = {
+    ok: true;
+    status: "valid" | "partial";
+    type: DiagramType;
+    svg: string;
+    diagnostics: SchematexDiagnostic[];
+} | {
+    ok: false;
+    status: "invalid";
+    type: DiagramType | null;
+    svg: string;
+    diagnostics: SchematexDiagnostic[];
+};
+
+interface SchematexConfig {
+    type?: "genogram" | "ecomap" | "pedigree" | "phylo" | "sociogram" | "timing" | "logic" | "circuit" | "blockdiagram" | "ladder" | "sld" | "entity" | "fishbone" | "venn" | "flowchart" | "mindmap" | "matrix" | "orgchart" | "decisiontree" | "timeline" | "state" | "pid" | "erd" | "breadboard" | "bpmn" | "fbd" | "sfc" | "prisma" | "usecase" | "pert" | "sequence";
+    width?: number;
+    height?: number;
+    padding?: number;
+    theme?: string;
+    fontFamily?: string;
+    /**
+     * `strict` preserves the historical throw-on-error API.
+     * `preview` returns a visible diagnostic SVG instead of an empty surface.
+     */
+    mode?: "strict" | "preview";
+}
+/**
+ * Parse DSL text to the diagram's AST and return it as a plain object.
+ * Useful for JSON serialization, programmatic inspection, or custom renderers.
+ *
+ * @example
+ * ```ts
+ * const ast = parse('genogram\n  alice [female]');
+ * console.log(JSON.stringify(ast, null, 2));
+ * ```
+ */
+declare function parse(text: string, config?: SchematexConfig): unknown;
+declare function parseResult(text: string, config?: SchematexConfig): SchematexParseResult;
+declare function render(text: string, config?: SchematexConfig): string;
+declare function renderResult(text: string, config?: SchematexConfig): SchematexRenderResult;
+declare function renderPreview(text: string, config?: SchematexConfig): string;
+
+export { type SchematexConfig as S, type SchematexDiagnostic as a, type SchematexParseResult as b, type SchematexRenderResult as c, type SchematexResultStatus as d, parseResult as e, renderPreview as f, renderResult as g, parse as p, render as r };

package/dist/api-Cr_MxttI.d.ts

@@ -0,0 +1,69 @@
+import { q as DiagramType } from './types-WTr9W5Ud.js';
+
+type SchematexResultStatus = "valid" | "partial" | "invalid";
+interface SchematexDiagnostic {
+    severity: "error" | "warning";
+    code: string;
+    message: string;
+    line?: number;
+    column?: number;
+    source?: string;
+    hint?: string;
+    fatal: boolean;
+}
+type SchematexParseResult = {
+    ok: true;
+    status: "valid" | "partial";
+    type: DiagramType;
+    ast: unknown;
+    diagnostics: SchematexDiagnostic[];
+} | {
+    ok: false;
+    status: "invalid";
+    type: DiagramType | null;
+    diagnostics: SchematexDiagnostic[];
+};
+type SchematexRenderResult = {
+    ok: true;
+    status: "valid" | "partial";
+    type: DiagramType;
+    svg: string;
+    diagnostics: SchematexDiagnostic[];
+} | {
+    ok: false;
+    status: "invalid";
+    type: DiagramType | null;
+    svg: string;
+    diagnostics: SchematexDiagnostic[];
+};
+
+interface SchematexConfig {
+    type?: "genogram" | "ecomap" | "pedigree" | "phylo" | "sociogram" | "timing" | "logic" | "circuit" | "blockdiagram" | "ladder" | "sld" | "entity" | "fishbone" | "venn" | "flowchart" | "mindmap" | "matrix" | "orgchart" | "decisiontree" | "timeline" | "state" | "pid" | "erd" | "breadboard" | "bpmn" | "fbd" | "sfc" | "prisma" | "usecase" | "pert" | "sequence";
+    width?: number;
+    height?: number;
+    padding?: number;
+    theme?: string;
+    fontFamily?: string;
+    /**
+     * `strict` preserves the historical throw-on-error API.
+     * `preview` returns a visible diagnostic SVG instead of an empty surface.
+     */
+    mode?: "strict" | "preview";
+}
+/**
+ * Parse DSL text to the diagram's AST and return it as a plain object.
+ * Useful for JSON serialization, programmatic inspection, or custom renderers.
+ *
+ * @example
+ * ```ts
+ * const ast = parse('genogram\n  alice [female]');
+ * console.log(JSON.stringify(ast, null, 2));
+ * ```
+ */
+declare function parse(text: string, config?: SchematexConfig): unknown;
+declare function parseResult(text: string, config?: SchematexConfig): SchematexParseResult;
+declare function render(text: string, config?: SchematexConfig): string;
+declare function renderResult(text: string, config?: SchematexConfig): SchematexRenderResult;
+declare function renderPreview(text: string, config?: SchematexConfig): string;
+
+export { type SchematexConfig as S, type SchematexDiagnostic as a, type SchematexParseResult as b, type SchematexRenderResult as c, type SchematexResultStatus as d, parseResult as e, renderPreview as f, renderResult as g, parse as p, render as r };

package/dist/browser.cjs

@@ -1,8 +1,8 @@
 'use strict';
 
-var chunk3YUUC6RN_cjs = require('./chunk-3YUUC6RN.cjs');
+var chunk4QPDZJAL_cjs = require('./chunk-4QPDZJAL.cjs');
 require('./chunk-QUKVGHN4.cjs');
-require('./chunk-XRCY75UV.cjs');
+require('./chunk-QMTWG6JL.cjs');
 require('./chunk-SUIDD2C5.cjs');
 require('./chunk-N7W5KZK7.cjs');
 require('./chunk-3M6WB62Y.cjs');
@@ -26,7 +26,12 @@ require('./chunk-3WNW5Y7P.cjs');
 
 // src/browser.ts
 function renderToElement(text, config) {
-  const svgString = chunk3YUUC6RN_cjs.render(text, config);
+  return svgStringToElement(chunk4QPDZJAL_cjs.render(text, config));
+}
+function renderPreviewToElement(text, config) {
+  return svgStringToElement(chunk4QPDZJAL_cjs.renderPreview(text, config));
+}
+function svgStringToElement(svgString) {
   const parser = new DOMParser();
   const doc = parser.parseFromString(svgString, "image/svg+xml");
   const el = doc.documentElement;
@@ -37,13 +42,26 @@ function renderToElement(text, config) {
   return el;
 }
 function renderToContainer(text, container, config) {
-  container.innerHTML = chunk3YUUC6RN_cjs.render(text, config);
+  container.innerHTML = chunk4QPDZJAL_cjs.render(text, config);
+}
+function renderPreviewToContainer(text, container, config) {
+  container.innerHTML = chunk4QPDZJAL_cjs.renderPreview(text, config);
 }
 
 Object.defineProperty(exports, "render", {
   enumerable: true,
-  get: function () { return chunk3YUUC6RN_cjs.render; }
+  get: function () { return chunk4QPDZJAL_cjs.render; }
+});
+Object.defineProperty(exports, "renderPreview", {
+  enumerable: true,
+  get: function () { return chunk4QPDZJAL_cjs.renderPreview; }
+});
+Object.defineProperty(exports, "renderResult", {
+  enumerable: true,
+  get: function () { return chunk4QPDZJAL_cjs.renderResult; }
 });
+exports.renderPreviewToContainer = renderPreviewToContainer;
+exports.renderPreviewToElement = renderPreviewToElement;
 exports.renderToContainer = renderToContainer;
 exports.renderToElement = renderToElement;
 //# sourceMappingURL=browser.cjs.map

package/dist/browser.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/browser.ts"],"names":["render"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAmBO,SAAS,eAAA,CACd,MACA,MAAA,EACe;AACf,EAAA,MAAM,SAAA,GAAYA,wBAAA,CAAO,IAAA,EAAM,MAAM,CAAA;AACrC,EAAA,MAAM,MAAA,GAAS,IAAI,SAAA,EAAU;AAC7B,EAAA,MAAM,GAAA,GAAM,MAAA,CAAO,eAAA,CAAgB,SAAA,EAAW,eAAe,CAAA;AAC7D,EAAA,MAAM,KAAK,GAAA,CAAI,eAAA;AACf,EAAA,MAAM,UAAA,GAAa,GAAA,CAAI,aAAA,CAAc,aAAa,CAAA;AAClD,EAAA,IAAI,UAAA,EAAY;AACd,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,iBAAA,EAAoB,UAAA,CAAW,WAAW,CAAA,CAAE,CAAA;AAAA,EAC9D;AACA,EAAA,OAAO,EAAA;AACT;AAKO,SAAS,iBAAA,CACd,IAAA,EACA,SAAA,EACA,MAAA,EACM;AACN,EAAA,SAAA,CAAU,SAAA,GAAYA,wBAAA,CAAO,IAAA,EAAM,MAAM,CAAA;AAC3C","file":"browser.cjs","sourcesContent":["/**\n * Browser-specific utilities for Schematex.\n *\n * These APIs require a DOM environment. Do not import in SSR/Node contexts.\n *\n * @example\n * ```ts\n * import { renderToElement, renderToContainer } from 'schematex/browser';\n *\n * const svg = renderToElement('genogram\\n  alice [female]');\n * document.getElementById('diagram')!.appendChild(svg);\n * ```\n */\n\nimport { render, type SchematexConfig } from \"./core/api\";\n\n/**\n * Render DSL text to a live `SVGSVGElement` ready to insert into the DOM.\n */\nexport function renderToElement(\n  text: string,\n  config?: SchematexConfig\n): SVGSVGElement {\n  const svgString = render(text, config);\n  const parser = new DOMParser();\n  const doc = parser.parseFromString(svgString, \"image/svg+xml\");\n  const el = doc.documentElement;\n  const parseError = doc.querySelector(\"parsererror\");\n  if (parseError) {\n    throw new Error(`SVG parse error: ${parseError.textContent}`);\n  }\n  return el as unknown as SVGSVGElement;\n}\n\n/**\n * Render DSL text and inject SVG into a container element (replaces innerHTML).\n */\nexport function renderToContainer(\n  text: string,\n  container: Element,\n  config?: SchematexConfig\n): void {\n  container.innerHTML = render(text, config);\n}\n\nexport { render, type SchematexConfig } from \"./core/api\";\n"]}
+{"version":3,"sources":["../src/browser.ts"],"names":["render","renderPreview"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAuBO,SAAS,eAAA,CACd,MACA,MAAA,EACe;AACf,EAAA,OAAO,kBAAA,CAAmBA,wBAAA,CAAO,IAAA,EAAM,MAAM,CAAC,CAAA;AAChD;AAOO,SAAS,sBAAA,CACd,MACA,MAAA,EACe;AACf,EAAA,OAAO,kBAAA,CAAmBC,+BAAA,CAAc,IAAA,EAAM,MAAM,CAAC,CAAA;AACvD;AAEA,SAAS,mBAAmB,SAAA,EAAkC;AAC5D,EAAA,MAAM,MAAA,GAAS,IAAI,SAAA,EAAU;AAC7B,EAAA,MAAM,GAAA,GAAM,MAAA,CAAO,eAAA,CAAgB,SAAA,EAAW,eAAe,CAAA;AAC7D,EAAA,MAAM,KAAK,GAAA,CAAI,eAAA;AACf,EAAA,MAAM,UAAA,GAAa,GAAA,CAAI,aAAA,CAAc,aAAa,CAAA;AAClD,EAAA,IAAI,UAAA,EAAY;AACd,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,iBAAA,EAAoB,UAAA,CAAW,WAAW,CAAA,CAAE,CAAA;AAAA,EAC9D;AACA,EAAA,OAAO,EAAA;AACT;AAKO,SAAS,iBAAA,CACd,IAAA,EACA,SAAA,EACA,MAAA,EACM;AACN,EAAA,SAAA,CAAU,SAAA,GAAYD,wBAAA,CAAO,IAAA,EAAM,MAAM,CAAA;AAC3C;AAGO,SAAS,wBAAA,CACd,IAAA,EACA,SAAA,EACA,MAAA,EACM;AACN,EAAA,SAAA,CAAU,SAAA,GAAYC,+BAAA,CAAc,IAAA,EAAM,MAAM,CAAA;AAClD","file":"browser.cjs","sourcesContent":["/**\n * Browser-specific utilities for Schematex.\n *\n * These APIs require a DOM environment. Do not import in SSR/Node contexts.\n *\n * @example\n * ```ts\n * import { renderToElement, renderToContainer } from 'schematex/browser';\n *\n * const svg = renderToElement('genogram\\n  alice [female]');\n * document.getElementById('diagram')!.appendChild(svg);\n * ```\n */\n\nimport {\n  render,\n  renderPreview,\n  type SchematexConfig,\n} from \"./core/api\";\n\n/**\n * Render DSL text to a live `SVGSVGElement` ready to insert into the DOM.\n */\nexport function renderToElement(\n  text: string,\n  config?: SchematexConfig\n): SVGSVGElement {\n  return svgStringToElement(render(text, config));\n}\n\n/**\n * Render a live SVG element for an editing/AI-preview surface.\n *\n * Invalid DSL is represented as a diagnostic SVG instead of an empty surface.\n */\nexport function renderPreviewToElement(\n  text: string,\n  config?: SchematexConfig\n): SVGSVGElement {\n  return svgStringToElement(renderPreview(text, config));\n}\n\nfunction svgStringToElement(svgString: string): SVGSVGElement {\n  const parser = new DOMParser();\n  const doc = parser.parseFromString(svgString, \"image/svg+xml\");\n  const el = doc.documentElement;\n  const parseError = doc.querySelector(\"parsererror\");\n  if (parseError) {\n    throw new Error(`SVG parse error: ${parseError.textContent}`);\n  }\n  return el as unknown as SVGSVGElement;\n}\n\n/**\n * Render DSL text and inject SVG into a container element (replaces innerHTML).\n */\nexport function renderToContainer(\n  text: string,\n  container: Element,\n  config?: SchematexConfig\n): void {\n  container.innerHTML = render(text, config);\n}\n\n/** Replace a preview container with an SVG or a visible diagnostic fallback. */\nexport function renderPreviewToContainer(\n  text: string,\n  container: Element,\n  config?: SchematexConfig\n): void {\n  container.innerHTML = renderPreview(text, config);\n}\n\nexport {\n  render,\n  renderPreview,\n  renderResult,\n  type SchematexConfig,\n} from \"./core/api\";\n"]}

package/dist/browser.d.cts

@@ -1,5 +1,6 @@
-import { S as SchematexConfig } from './api-C5UcmT7n.cjs';
-export { r as render } from './api-C5UcmT7n.cjs';
+import { S as SchematexConfig } from './api-C5SECOxZ.cjs';
+export { r as render, f as renderPreview, g as renderResult } from './api-C5SECOxZ.cjs';
+import './types-WTr9W5Ud.cjs';
 
 /**
  * Browser-specific utilities for Schematex.
@@ -19,9 +20,17 @@ export { r as render } from './api-C5UcmT7n.cjs';
  * Render DSL text to a live `SVGSVGElement` ready to insert into the DOM.
  */
 declare function renderToElement(text: string, config?: SchematexConfig): SVGSVGElement;
+/**
+ * Render a live SVG element for an editing/AI-preview surface.
+ *
+ * Invalid DSL is represented as a diagnostic SVG instead of an empty surface.
+ */
+declare function renderPreviewToElement(text: string, config?: SchematexConfig): SVGSVGElement;
 /**
  * Render DSL text and inject SVG into a container element (replaces innerHTML).
  */
 declare function renderToContainer(text: string, container: Element, config?: SchematexConfig): void;
+/** Replace a preview container with an SVG or a visible diagnostic fallback. */
+declare function renderPreviewToContainer(text: string, container: Element, config?: SchematexConfig): void;
 
-export { SchematexConfig, renderToContainer, renderToElement };
+export { SchematexConfig, renderPreviewToContainer, renderPreviewToElement, renderToContainer, renderToElement };

package/dist/browser.d.ts

@@ -1,5 +1,6 @@
-import { S as SchematexConfig } from './api-C5UcmT7n.js';
-export { r as render } from './api-C5UcmT7n.js';
+import { S as SchematexConfig } from './api-Cr_MxttI.js';
+export { r as render, f as renderPreview, g as renderResult } from './api-Cr_MxttI.js';
+import './types-WTr9W5Ud.js';
 
 /**
  * Browser-specific utilities for Schematex.
@@ -19,9 +20,17 @@ export { r as render } from './api-C5UcmT7n.js';
  * Render DSL text to a live `SVGSVGElement` ready to insert into the DOM.
  */
 declare function renderToElement(text: string, config?: SchematexConfig): SVGSVGElement;
+/**
+ * Render a live SVG element for an editing/AI-preview surface.
+ *
+ * Invalid DSL is represented as a diagnostic SVG instead of an empty surface.
+ */
+declare function renderPreviewToElement(text: string, config?: SchematexConfig): SVGSVGElement;
 /**
  * Render DSL text and inject SVG into a container element (replaces innerHTML).
  */
 declare function renderToContainer(text: string, container: Element, config?: SchematexConfig): void;
+/** Replace a preview container with an SVG or a visible diagnostic fallback. */
+declare function renderPreviewToContainer(text: string, container: Element, config?: SchematexConfig): void;
 
-export { SchematexConfig, renderToContainer, renderToElement };
+export { SchematexConfig, renderPreviewToContainer, renderPreviewToElement, renderToContainer, renderToElement };

package/dist/browser.js

@@ -1,7 +1,7 @@
-import { render } from './chunk-GTDQAN2Z.js';
-export { render } from './chunk-GTDQAN2Z.js';
+import { render, renderPreview } from './chunk-OK5ZS3LU.js';
+export { render, renderPreview, renderResult } from './chunk-OK5ZS3LU.js';
 import './chunk-I55HO32M.js';
-import './chunk-HUPDIRBX.js';
+import './chunk-VCH7RI5H.js';
 import './chunk-EPKIJEH7.js';
 import './chunk-IBRW3UOA.js';
 import './chunk-6OSUNBZY.js';
@@ -25,7 +25,12 @@ import './chunk-SYYBKDL7.js';
 
 // src/browser.ts
 function renderToElement(text, config) {
-  const svgString = render(text, config);
+  return svgStringToElement(render(text, config));
+}
+function renderPreviewToElement(text, config) {
+  return svgStringToElement(renderPreview(text, config));
+}
+function svgStringToElement(svgString) {
   const parser = new DOMParser();
   const doc = parser.parseFromString(svgString, "image/svg+xml");
   const el = doc.documentElement;
@@ -38,7 +43,10 @@ function renderToElement(text, config) {
 function renderToContainer(text, container, config) {
   container.innerHTML = render(text, config);
 }
+function renderPreviewToContainer(text, container, config) {
+  container.innerHTML = renderPreview(text, config);
+}
 
-export { renderToContainer, renderToElement };
+export { renderPreviewToContainer, renderPreviewToElement, renderToContainer, renderToElement };
 //# sourceMappingURL=browser.js.map
 //# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/browser.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAmBO,SAAS,eAAA,CACd,MACA,MAAA,EACe;AACf,EAAA,MAAM,SAAA,GAAY,MAAA,CAAO,IAAA,EAAM,MAAM,CAAA;AACrC,EAAA,MAAM,MAAA,GAAS,IAAI,SAAA,EAAU;AAC7B,EAAA,MAAM,GAAA,GAAM,MAAA,CAAO,eAAA,CAAgB,SAAA,EAAW,eAAe,CAAA;AAC7D,EAAA,MAAM,KAAK,GAAA,CAAI,eAAA;AACf,EAAA,MAAM,UAAA,GAAa,GAAA,CAAI,aAAA,CAAc,aAAa,CAAA;AAClD,EAAA,IAAI,UAAA,EAAY;AACd,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,iBAAA,EAAoB,UAAA,CAAW,WAAW,CAAA,CAAE,CAAA;AAAA,EAC9D;AACA,EAAA,OAAO,EAAA;AACT;AAKO,SAAS,iBAAA,CACd,IAAA,EACA,SAAA,EACA,MAAA,EACM;AACN,EAAA,SAAA,CAAU,SAAA,GAAY,MAAA,CAAO,IAAA,EAAM,MAAM,CAAA;AAC3C","file":"browser.js","sourcesContent":["/**\n * Browser-specific utilities for Schematex.\n *\n * These APIs require a DOM environment. Do not import in SSR/Node contexts.\n *\n * @example\n * ```ts\n * import { renderToElement, renderToContainer } from 'schematex/browser';\n *\n * const svg = renderToElement('genogram\\n  alice [female]');\n * document.getElementById('diagram')!.appendChild(svg);\n * ```\n */\n\nimport { render, type SchematexConfig } from \"./core/api\";\n\n/**\n * Render DSL text to a live `SVGSVGElement` ready to insert into the DOM.\n */\nexport function renderToElement(\n  text: string,\n  config?: SchematexConfig\n): SVGSVGElement {\n  const svgString = render(text, config);\n  const parser = new DOMParser();\n  const doc = parser.parseFromString(svgString, \"image/svg+xml\");\n  const el = doc.documentElement;\n  const parseError = doc.querySelector(\"parsererror\");\n  if (parseError) {\n    throw new Error(`SVG parse error: ${parseError.textContent}`);\n  }\n  return el as unknown as SVGSVGElement;\n}\n\n/**\n * Render DSL text and inject SVG into a container element (replaces innerHTML).\n */\nexport function renderToContainer(\n  text: string,\n  container: Element,\n  config?: SchematexConfig\n): void {\n  container.innerHTML = render(text, config);\n}\n\nexport { render, type SchematexConfig } from \"./core/api\";\n"]}
+{"version":3,"sources":["../src/browser.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAuBO,SAAS,eAAA,CACd,MACA,MAAA,EACe;AACf,EAAA,OAAO,kBAAA,CAAmB,MAAA,CAAO,IAAA,EAAM,MAAM,CAAC,CAAA;AAChD;AAOO,SAAS,sBAAA,CACd,MACA,MAAA,EACe;AACf,EAAA,OAAO,kBAAA,CAAmB,aAAA,CAAc,IAAA,EAAM,MAAM,CAAC,CAAA;AACvD;AAEA,SAAS,mBAAmB,SAAA,EAAkC;AAC5D,EAAA,MAAM,MAAA,GAAS,IAAI,SAAA,EAAU;AAC7B,EAAA,MAAM,GAAA,GAAM,MAAA,CAAO,eAAA,CAAgB,SAAA,EAAW,eAAe,CAAA;AAC7D,EAAA,MAAM,KAAK,GAAA,CAAI,eAAA;AACf,EAAA,MAAM,UAAA,GAAa,GAAA,CAAI,aAAA,CAAc,aAAa,CAAA;AAClD,EAAA,IAAI,UAAA,EAAY;AACd,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,iBAAA,EAAoB,UAAA,CAAW,WAAW,CAAA,CAAE,CAAA;AAAA,EAC9D;AACA,EAAA,OAAO,EAAA;AACT;AAKO,SAAS,iBAAA,CACd,IAAA,EACA,SAAA,EACA,MAAA,EACM;AACN,EAAA,SAAA,CAAU,SAAA,GAAY,MAAA,CAAO,IAAA,EAAM,MAAM,CAAA;AAC3C;AAGO,SAAS,wBAAA,CACd,IAAA,EACA,SAAA,EACA,MAAA,EACM;AACN,EAAA,SAAA,CAAU,SAAA,GAAY,aAAA,CAAc,IAAA,EAAM,MAAM,CAAA;AAClD","file":"browser.js","sourcesContent":["/**\n * Browser-specific utilities for Schematex.\n *\n * These APIs require a DOM environment. Do not import in SSR/Node contexts.\n *\n * @example\n * ```ts\n * import { renderToElement, renderToContainer } from 'schematex/browser';\n *\n * const svg = renderToElement('genogram\\n  alice [female]');\n * document.getElementById('diagram')!.appendChild(svg);\n * ```\n */\n\nimport {\n  render,\n  renderPreview,\n  type SchematexConfig,\n} from \"./core/api\";\n\n/**\n * Render DSL text to a live `SVGSVGElement` ready to insert into the DOM.\n */\nexport function renderToElement(\n  text: string,\n  config?: SchematexConfig\n): SVGSVGElement {\n  return svgStringToElement(render(text, config));\n}\n\n/**\n * Render a live SVG element for an editing/AI-preview surface.\n *\n * Invalid DSL is represented as a diagnostic SVG instead of an empty surface.\n */\nexport function renderPreviewToElement(\n  text: string,\n  config?: SchematexConfig\n): SVGSVGElement {\n  return svgStringToElement(renderPreview(text, config));\n}\n\nfunction svgStringToElement(svgString: string): SVGSVGElement {\n  const parser = new DOMParser();\n  const doc = parser.parseFromString(svgString, \"image/svg+xml\");\n  const el = doc.documentElement;\n  const parseError = doc.querySelector(\"parsererror\");\n  if (parseError) {\n    throw new Error(`SVG parse error: ${parseError.textContent}`);\n  }\n  return el as unknown as SVGSVGElement;\n}\n\n/**\n * Render DSL text and inject SVG into a container element (replaces innerHTML).\n */\nexport function renderToContainer(\n  text: string,\n  container: Element,\n  config?: SchematexConfig\n): void {\n  container.innerHTML = render(text, config);\n}\n\n/** Replace a preview container with an SVG or a visible diagnostic fallback. */\nexport function renderPreviewToContainer(\n  text: string,\n  container: Element,\n  config?: SchematexConfig\n): void {\n  container.innerHTML = renderPreview(text, config);\n}\n\nexport {\n  render,\n  renderPreview,\n  renderResult,\n  type SchematexConfig,\n} from \"./core/api\";\n"]}