schematex 0.1.0 → 0.2.0

package/README.md

@@ -1,10 +1,11 @@
 <p align="center">
   <strong>Schematex</strong><br>
-  <em>Standards-as-code for professional diagrams.</em>
+  <em>Every diagram a doctor, engineer, or lawyer would actually use.</em><br>
+  <em>Free. Fully open source. Made for AI.</em>
 </p>
 
 <p align="center">
-  McGoldrick genograms · NSGC pedigrees · IEC 61131-3 ladder logic · IEEE 315 single-line diagrams · Newick phylogenetic trees · Moreno sociograms · and 7 more — all from a tiny text DSL, with zero runtime dependencies.
+  McGoldrick genograms · NSGC pedigrees · IEC 61131-3 ladder logic · IEEE 315 single-line diagrams · Newick phylogenetic trees · Howard-Raiffa decision trees · Moreno sociograms · and more — all from a tiny text DSL, with zero runtime dependencies.
 </p>
 
 <p align="center">
@@ -22,18 +23,23 @@
   <a href="./LICENSE"><img src="https://img.shields.io/badge/license-AGPL--3.0-blue" alt="license"></a>
 </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">
+</p>
+
 ---
 
-**Schematex** is the open-source rendering engine for diagrams that follow real industry standards. Thirteen diagram families across four domains:
+**Schematex** is the open-source rendering engine for the diagrams professionals actually use — medical, electrical, legal, and analytical. 20 diagram families across five domains:
 
 - 👪 **Relationships** — genograms, ecomaps, pedigrees, sociograms, phylogenetic trees
 - ⚡ **Electrical & Industrial** — ladder logic, single-line diagrams, circuit schematics, logic gates, timing, block diagrams
 - 🏢 **Corporate & Legal** — entity structures, cap tables
-- 🐟 **Causality & Analysis** — fishbone / Ishikawa
+- 🐟 **Causality & Analysis** — fishbone / Ishikawa, decision trees (Howard-Raiffa EV · CART/sklearn · taxonomy)
+- 📅 **Timelines** — proportional / equidistant / log axis · swimlane · gantt · lollipop · BC dates · geological Ma scale
 
-Mermaid draws generic flowcharts. Schematex draws the diagrams your domain experts actually sign off on — a genogram a genetic counselor accepts clinically, ladder logic that maps 1:1 to IEC 61131-3, a cap table that survives a Series A review.
+Mermaid draws generic flowcharts. Schematex draws the diagrams doctors, engineers, and lawyers actually use — a genogram a genetic counselor accepts clinically, ladder logic that maps 1:1 to IEC 61131-3, a cap table that survives a Series A review.
 
-⚡ **Zero runtime dependencies** · 📐 **10+ industry standards** · 🤖 **LLM-native DSL** · 🌱 **SSR-ready pure SVG**
+🆓 **Free & fully open source** · 📐 **10+ industry standards** · 🤖 **Made for AI** · 🌱 **SSR-ready pure SVG · Zero deps**
 
 ## Install
 
@@ -64,7 +70,7 @@ import { render } from 'schematex/genogram';
 
 ## Gallery
 
-Thirteen diagram types, one unified pipeline. **Try any of these live at [schematex.dev/playground](https://schematex.dev/playground).**
+20 diagram types, one unified pipeline. **Try any of these live at [schematex.dev/playground](https://schematex.dev/playground).**
 
 ### 👪 Genogram — *McGoldrick family-systems standard*
 
@@ -166,19 +172,30 @@ phylo "Bacterial Diversity"
 Social network diagrams with mutual choices, rejections, and group coloring. Force-directed or hierarchical layout. Auto-detects stars, isolates, cliques.
 
 ```
-sociogram "Playground Dynamics"
+sociogram "Operation Sunset - Communication Network"
   config: layout = force-directed
-  group boys [label: "Boys", color: "#42A5F5"]
-    tom; jack; mike; leo
-  group girls [label: "Girls", color: "#EF5350"]
-    anna; beth; chloe; diana
-  tom <-> jack
-  mike -x> leo [label: "conflict"]
-  anna <-> beth
-  diana -.- tom
+  boss [label: "Subject Alpha"]
+  lt1 [label: "Lieutenant 1"]
+  lt2 [label: "Lieutenant 2"]
+  courier1 [label: "Courier A"]
+  courier2 [label: "Courier B"]
+  contact1 [label: "External Contact 1"]
+  contact2 [label: "External Contact 2"]
+  associate1 [label: "Associate 1"]
+  associate2 [label: "Associate 2"]
+  boss <-> lt1 [weight: 4]
+  boss <-> lt2 [weight: 4]
+  lt1 -> courier1
+  lt1 -> courier2
+  lt2 -> associate1
+  lt2 -> associate2
+  courier1 -> contact1 [label: "supplier"]
+  courier2 -> contact2 [label: "distributor"]
+  lt1 <-> lt2 [weight: 2]
+  associate1 -.- courier1
 ```
 
-![Playground Dynamics Sociogram](examples/sociogram/playground-dynamics.svg)
+![Operation Sunset Sociogram](examples/sociogram/criminal-network.svg)
 
 [Sociogram syntax →](https://schematex.dev/docs/sociogram)
 
@@ -196,6 +213,8 @@ MOSI:  x=======  data: ["0xAB","0xCD","0xEF","0x01","0x02","0x03","0x04","0x05"]
 MISO:  zzzz====  data: ["","","","","0xFF","0x12","0x34","0x56"]
 ```
 
+![SPI Transaction Timing Diagram](examples/timing/spi-transaction.svg)
+
 [Timing syntax →](https://schematex.dev/docs/timing)
 
 ---
@@ -215,6 +234,8 @@ c2 = AND(s1, Cin)
 Cout = OR(c1, c2)
 ```
 
+![1-bit Full Adder Logic Gate](examples/logic/full-adder.svg)
+
 [Logic gate syntax →](https://schematex.dev/docs/logic)
 
 ---
@@ -264,17 +285,26 @@ rung 1 "Set Auto, reset Manual":
 Substation and distribution one-line diagrams with transformers, breakers, buses, and protective relays.
 
 ```
-sld "13.8 kV Substation"
-utility [label: "Grid 138 kV"]
-xfmr1 [type: transformer, kva: 15000, primary: 138, secondary: 13.8]
-bus_hv [type: bus, voltage: 138]
-bus_mv [type: bus, voltage: 13.8]
-brk1 [type: breaker, amps: 1200]
-utility -> bus_hv
-bus_hv -> xfmr1 -> bus_mv
-bus_mv -> brk1
+sld "Utility with generator backup"
+UTIL = utility [voltage: "480V", label: "Utility"]
+GEN = generator [rating: "500 kW", voltage: "480V", label: "Emergency Gen"]
+ATS1 = ats [rating: "800A", label: "ATS-1"]
+BUS1 = bus [voltage: "480V", label: "Critical Load Bus"]
+CB1 = breaker [rating: "200A"]
+CB2 = breaker [rating: "200A"]
+L1 = load [rating: "100A", label: "Critical Load 1"]
+L2 = load [rating: "100A", label: "Critical Load 2"]
+UTIL -> ATS1
+GEN -> ATS1
+ATS1 -> BUS1
+BUS1 -> CB1
+BUS1 -> CB2
+CB1 -> L1
+CB2 -> L2
 ```
 
+![Utility with Generator Backup SLD](examples/sld/generator-ats.svg)
+
 [SLD syntax →](https://schematex.dev/docs/sld)
 
 ---
@@ -294,17 +324,162 @@ entity "Acme Holdings"
   acme_inc --60%--> acme_fund
 ```
 
+![Acme Holdings Entity Structure](examples/entity/holding-company.svg)
+
 [Entity syntax →](https://schematex.dev/docs/entity)
 
 ---
 
-### 📦 Block diagram & 🐟 Fishbone
+### 📦 Block diagram
+
+Signal-flow block diagrams with summing junctions, gain blocks, and feedback loops.
+
+```
+blockdiagram "Nested Feedback Loops"
+G1 = block("G1(s)") [role: plant]
+G2 = block("G2(s)") [role: plant]
+G3 = block("G3(s)") [role: plant]
+H1 = block("H1(s)") [role: sensor]
+H2 = block("H2(s)") [role: sensor, route: above]
+s1 = sum(+R, -h2)
+s2 = sum(+a, -h1)
+in -> s1 ["R(s)"]
+s1 -> G1 -> s2
+s2 -> G2 -> G3
+G3 -> out ["Y(s)"]
+G2 -> H1
+H1 -> s2
+G3 -> H2
+H2 -> s1
+```
+
+![Nested Feedback Loops Block Diagram](examples/block/nested-feedback.svg)
+
+[Block syntax →](https://schematex.dev/docs/block)
+
+---
+
+### 🐟 Fishbone — *Ishikawa cause-and-effect*
+
+Cause-and-effect diagrams with auto-categorized branches and alternating rib layout.
+
+```
+fishbone "Website Traffic Drop — Root Cause Analysis"
+effect "Traffic Drop"
+category content "Content"
+category tech "Technical"
+category links "Backlinks"
+category ux "UX"
+category competition "Competition"
+category algo "Algorithm"
+content : "Lower update frequency" : "Thin content" : "Keyword gaps"
+tech : "Poor Core Web Vitals" : "WAF blocking crawlers"
+links : "High-DA backlink loss" : "Referring domain plateau"
+ux : "Bounce rate spike" : "Slow LCP" : "Intrusive interstitials"
+competition : "New entrants" : "AI overviews displacing clicks"
+algo : "Core Update penalty" : "Weak E-E-A-T signals" : "SGE traffic diversion"
+```
+
+![Website Traffic Drop Fishbone](examples/fishbone/website-traffic-drop.svg)
+
+[Fishbone syntax →](https://schematex.dev/docs/fishbone)
+
+### 🌳 Decision Tree — *Howard-Raiffa · CART/sklearn · Taxonomy*
+
+Three modes in one DSL. Decision analysis with EV rollback (Howard-Raiffa), ML tree visualization (sklearn `plot_tree` style), and yes/no taxonomy trees. Diagonal edge routing, payoff-aligned columns, optimal-path highlighting.
+
+**Decision analysis — EV rollback:**
+```
+decisiontree:decision "Oil drilling"
+
+decision "Drill or sell rights?"
+  choice "Sell rights"
+    end payoff=90000 "Guaranteed sale"
+  choice "Drill"
+    chance "Well outcome"
+      prob 0.3 end payoff=500000 "Major strike"
+      prob 0.5 end payoff=50000  "Minor strike"
+      prob 0.2 end payoff=-200000 "Dry hole"
+```
+
+**ML tree — sklearn CART style:**
+```
+decisiontree:ml "Iris classification"
+classes: setosa, versicolor, virginica
+impurity: gini
+branchLabels: relation
+
+split feature=petal_width op=<= threshold=0.8 samples=120 value=[50,35,35] gini=0.66
+  true leaf samples=50 value=[50,0,0] gini=0 class=setosa
+  false split feature=petal_width op=<= threshold=1.75 samples=70 value=[0,35,35] gini=0.5
+    true leaf samples=36 value=[0,32,4] gini=0.198 class=versicolor
+    false leaf samples=34 value=[0,3,31] gini=0.162 class=virginica
+```
+
+**Taxonomy — yes/no classification:**
+```
+decisiontree:taxonomy "ED Triage Level"
+direction: left-right
+
+q "Airway compromise?"
+  yes: a "Level 1 — Resuscitation"
+  no: q "Vital signs unstable?"
+    yes: a "Level 2 — Emergent"
+    no: q "Multiple resources needed?"
+      yes: a "Level 3 — Urgent"
+      no: a "Level 4/5 — Less urgent"
+```
+
+[Decision Tree syntax →](https://schematex.dev/docs/decisiontree)
+
+---
+
+### 📅 Timeline
+
+Historical events, biographical lifelines, product roadmaps, and geological timescales on a proportional / equidistant / log axis. Three visual styles: **swimlane** (multi-track biographies), **gantt** (project plan with pins + category lanes + legend), and **lollipop** (alternating above/below cards on a center axis). Supports BC/AD dates, quarter dates (`2026-Q1`), and geological mega-year (`Ma`) scale.
+
+```
+timeline "Apollo program"
+
+1961-05-25: milestone "Kennedy Moon speech"
+1967-01-27: "Apollo 1 fire"
+1968-12-21 - 1968-12-27: "Apollo 8 — first lunar orbit"
+1969-07-16 - 1969-07-24: "Apollo 11 — Moon landing" [icon:🚀]
+1970-04-11 - 1970-04-17: "Apollo 13 — abort"
+1972-12-07 - 1972-12-19: "Apollo 17 — last crewed Moon mission"
+```
 
-Signal-flow block diagrams (summing junctions, gain blocks, feedback loops) and Ishikawa cause-and-effect fishbones with auto-categorized branches.
+```
+timeline "Brand story"
+config: style = lollipop
+
+era 2015 - 2019: "Scrappy startup"
+era 2019 - 2023: "Scale-up"
+era 2023 - 2027: "Enterprise era"
+
+2015: "Founded in a coffee shop" [icon:☕]
+2017: milestone "First 1000 users" [icon:👥]
+2019: "Series A" [icon:💰]
+2021: "Opened NYC office" [icon:🏙]
+2023: milestone "Crossed $50M ARR" [icon:📊]
+2025: "Acquired Acme Inc." [icon:🤝]
+```
 
-[Block syntax →](https://schematex.dev/docs/block) · [Fishbone syntax →](https://schematex.dev/docs/fishbone)
+```
+timeline "Q2 Launch plan"
+config: style = gantt
+
+2026-04-01: milestone "Kickoff"
+2026-06-30: milestone "GA launch" [icon:🚀]
 
-## Why Schematex?
+2026-04-01 - 2026-04-30: "Research & specs" [category: "Design"]
+2026-04-10 - 2026-06-10: "API build" [category: "Eng"]
+2026-05-15 - 2026-06-25: "Campaign prep" [category: "Marketing"]
+```
+
+[Timeline syntax →](https://schematex.dev/docs/timeline)
+
+## Why SchemaTex?
 
 **Generic flowchart tools can't draw professional diagrams.** Every diagram domain has published standards — symbol conventions, layout rules, labelling grammars — and when you ignore them, domain experts reject the output:
 
@@ -313,13 +488,13 @@ Signal-flow block diagrams (summing junctions, gain blocks, feedback loops) and
 - **Single-line diagrams** follow [IEEE 315](https://standards.ieee.org/ieee/315/5052/) — protective device clustering, voltage-tier hierarchy, transformer symbology.
 - **Pedigrees** follow NSGC human-pedigree nomenclature; **phylogenetic trees** roundtrip Newick + NHX; **cap tables** compute tier-aware ownership rollup.
 
-Schematex treats each standard as a first-class citizen with its own parser, layout algorithm, and SVG renderer — **standards-as-code**, not generic shapes with domain labels.
+SchemaTex treats each standard as a first-class citizen with its own parser, layout algorithm, and SVG renderer — **standards-as-code**, not generic shapes with domain labels.
 
 No existing open-source library covers this spread. GoJS has isolated samples but costs **$7k+/seat**. Schemdraw is Python-only. draw.io is a heavyweight GUI. Everything else is proprietary or abandoned.
 
 ### Designed for LLM code generation
 
-Schematex DSLs are small, consistent, and shaped by what LLMs get wrong:
+SchemaTex DSLs are small, consistent, and shaped by what LLMs get wrong:
 
 - Each diagram type has a minimal, documented grammar an LLM can learn from a single example.
 - Error messages are AI-readable — line number plus specific fix suggestion, not `Parse error at line 42`.
@@ -339,22 +514,36 @@ Written by humans, shaped by what LLMs get wrong.
 ## API
 
 ```ts
-// Universal entry — dispatches by first keyword
+// Universal entry — auto-detects diagram type from first keyword
 import { render, parse } from 'schematex';
 
-render(text: string, config?: SchematexConfig): string;
-parse(text: string, config?: SchematexConfig): AST;
+const svg = render(text, config?);      // → SVG string
+const ast = parse(text, config?);       // → AST (JSON-serializable)
+
+// Per-diagram tree-shaking
+import { render } from 'schematex/genogram';
+
+// Browser DOM
+import { renderToElement, renderToContainer } from 'schematex/browser';
+container.appendChild(renderToElement(dsl));
+
+// React
+import { SchematexDiagram } from 'schematex/react';
+// <SchematexDiagram dsl="genogram ..." theme="monochrome" />
 
-// Per-diagram (tree-shakable)
-import { render as renderGenogram } from 'schematex/genogram';
-import { render as renderLadder } from 'schematex/ladder';
+// Export (browser Canvas)
+import { svgToPngBlob, downloadBlob, printSvgAsPdf } from 'schematex/export';
+const blob = await svgToPngBlob(svg, { scale: 2 });
+downloadBlob(blob, 'diagram.png');
 ```
 
 See the [API reference →](https://schematex.dev/docs/api).
 
 ## Ecosystem
 
-- **React** — `@schematex/react` *(coming soon)*
+- **React** — `schematex/react` — `<SchematexDiagram dsl="..." />` component
+- **Browser** — `schematex/browser` — `renderToElement()` / `renderToContainer()`
+- **Export** — `schematex/export` — PNG (@2×) + print-to-PDF via browser Canvas
 - **Obsidian** — code-block renderer plugin *(coming soon)*
 - **Markdown-it / remark** — diagram fence support *(coming soon)*
 - **CLI** — `npx schematex input.txt > output.svg` *(coming soon)*
@@ -374,6 +563,6 @@ npm run build
 
 ## License
 
-[AGPL-3.0](./LICENSE) for open-source use. For commercial use without AGPL obligations (embedding Schematex into proprietary or closed-source products), a commercial license is available — contact **victor@mymap.ai**.
+[AGPL-3.0](./LICENSE) for open-source use. For commercial use without AGPL obligations (embedding SchemaTex into proprietary or closed-source products), a commercial license is available — contact **victor@mymap.ai**.
 
 <p align="center"><sub>Built by <a href="https://mymap.ai">MyMap.ai</a>.</sub></p>

package/dist/api-bQZ98gkJ.d.cts

@@ -0,0 +1,22 @@
+interface SchematexConfig {
+    type?: "genogram" | "ecomap" | "pedigree" | "phylo" | "sociogram" | "timing" | "logic" | "circuit" | "blockdiagram" | "ladder" | "sld" | "entity" | "fishbone" | "venn" | "flowchart" | "mindmap" | "matrix" | "orgchart" | "decisiontree" | "timeline";
+    width?: number;
+    height?: number;
+    padding?: number;
+    theme?: string;
+    fontFamily?: string;
+}
+/**
+ * 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 render(text: string, config?: SchematexConfig): string;
+
+export { type SchematexConfig as S, parse as p, render as r };

package/dist/api-bQZ98gkJ.d.ts

@@ -0,0 +1,22 @@
+interface SchematexConfig {
+    type?: "genogram" | "ecomap" | "pedigree" | "phylo" | "sociogram" | "timing" | "logic" | "circuit" | "blockdiagram" | "ladder" | "sld" | "entity" | "fishbone" | "venn" | "flowchart" | "mindmap" | "matrix" | "orgchart" | "decisiontree" | "timeline";
+    width?: number;
+    height?: number;
+    padding?: number;
+    theme?: string;
+    fontFamily?: string;
+}
+/**
+ * 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 render(text: string, config?: SchematexConfig): string;
+
+export { type SchematexConfig as S, parse as p, render as r };

package/dist/browser.cjs

@@ -0,0 +1,46 @@
+'use strict';
+
+var chunkVP54YPOX_cjs = require('./chunk-VP54YPOX.cjs');
+require('./chunk-IY52OWPG.cjs');
+require('./chunk-HKRYKEOV.cjs');
+require('./chunk-LXNFVHDT.cjs');
+require('./chunk-LKHWBDWZ.cjs');
+require('./chunk-ULERCTGS.cjs');
+require('./chunk-PIQG2Z5N.cjs');
+require('./chunk-IMHR3S5H.cjs');
+require('./chunk-3M7QWADF.cjs');
+require('./chunk-HAIBAF6J.cjs');
+require('./chunk-CEV3GZA3.cjs');
+require('./chunk-ZGKEFVJQ.cjs');
+require('./chunk-AMP2FFES.cjs');
+require('./chunk-YKO7DY2F.cjs');
+require('./chunk-DTMCQXXC.cjs');
+require('./chunk-ZO77FHBF.cjs');
+require('./chunk-4HPT4BOI.cjs');
+require('./chunk-S6VPECM3.cjs');
+require('./chunk-HDKDQAEQ.cjs');
+
+// src/browser.ts
+function renderToElement(text, config) {
+  const svgString = chunkVP54YPOX_cjs.render(text, config);
+  const parser = new DOMParser();
+  const doc = parser.parseFromString(svgString, "image/svg+xml");
+  const el = doc.documentElement;
+  const parseError = doc.querySelector("parsererror");
+  if (parseError) {
+    throw new Error(`SVG parse error: ${parseError.textContent}`);
+  }
+  return el;
+}
+function renderToContainer(text, container, config) {
+  container.innerHTML = chunkVP54YPOX_cjs.render(text, config);
+}
+
+Object.defineProperty(exports, "render", {
+  enumerable: true,
+  get: function () { return chunkVP54YPOX_cjs.render; }
+});
+exports.renderToContainer = renderToContainer;
+exports.renderToElement = renderToElement;
+//# sourceMappingURL=browser.cjs.map
+//# sourceMappingURL=browser.cjs.map

package/dist/browser.cjs.map

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

package/dist/browser.d.cts

@@ -0,0 +1,27 @@
+import { S as SchematexConfig } from './api-bQZ98gkJ.cjs';
+export { r as render } from './api-bQZ98gkJ.cjs';
+
+/**
+ * Browser-specific utilities for Schematex.
+ *
+ * These APIs require a DOM environment. Do not import in SSR/Node contexts.
+ *
+ * @example
+ * ```ts
+ * import { renderToElement, renderToContainer } from 'schematex/browser';
+ *
+ * const svg = renderToElement('genogram\n  alice [female]');
+ * document.getElementById('diagram')!.appendChild(svg);
+ * ```
+ */
+
+/**
+ * Render DSL text to a live `SVGSVGElement` ready to insert into the DOM.
+ */
+declare function renderToElement(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;
+
+export { SchematexConfig, renderToContainer, renderToElement };

package/dist/browser.d.ts

@@ -0,0 +1,27 @@
+import { S as SchematexConfig } from './api-bQZ98gkJ.js';
+export { r as render } from './api-bQZ98gkJ.js';
+
+/**
+ * Browser-specific utilities for Schematex.
+ *
+ * These APIs require a DOM environment. Do not import in SSR/Node contexts.
+ *
+ * @example
+ * ```ts
+ * import { renderToElement, renderToContainer } from 'schematex/browser';
+ *
+ * const svg = renderToElement('genogram\n  alice [female]');
+ * document.getElementById('diagram')!.appendChild(svg);
+ * ```
+ */
+
+/**
+ * Render DSL text to a live `SVGSVGElement` ready to insert into the DOM.
+ */
+declare function renderToElement(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;
+
+export { SchematexConfig, renderToContainer, renderToElement };

package/dist/browser.js

@@ -0,0 +1,40 @@
+import { render } from './chunk-M6AMNXQ7.js';
+export { render } from './chunk-M6AMNXQ7.js';
+import './chunk-7WXAAVR3.js';
+import './chunk-2OIW3MAE.js';
+import './chunk-5SH5NUDW.js';
+import './chunk-L6IHSTPP.js';
+import './chunk-A74ZCP5I.js';
+import './chunk-MRGS54WN.js';
+import './chunk-IQIJ6WW6.js';
+import './chunk-MXJ6FHSY.js';
+import './chunk-JZGFSRVT.js';
+import './chunk-HLYA4QBB.js';
+import './chunk-RQX53J6M.js';
+import './chunk-TPA36ULU.js';
+import './chunk-4TS5NB7L.js';
+import './chunk-YO4GU6JX.js';
+import './chunk-GEPBET4L.js';
+import './chunk-SPIW4VWP.js';
+import './chunk-TIGP2OEJ.js';
+import './chunk-KLJEK547.js';
+
+// src/browser.ts
+function renderToElement(text, config) {
+  const svgString = render(text, config);
+  const parser = new DOMParser();
+  const doc = parser.parseFromString(svgString, "image/svg+xml");
+  const el = doc.documentElement;
+  const parseError = doc.querySelector("parsererror");
+  if (parseError) {
+    throw new Error(`SVG parse error: ${parseError.textContent}`);
+  }
+  return el;
+}
+function renderToContainer(text, container, config) {
+  container.innerHTML = render(text, config);
+}
+
+export { renderToContainer, renderToElement };
+//# sourceMappingURL=browser.js.map
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

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

package/dist/{chunk-XXU36667.js → chunk-2OIW3MAE.js}

@@ -1,4 +1,4 @@
-import { resolveIndustrialTheme } from './chunk-IX554O5K.js';
+import { resolveIndustrialTheme } from './chunk-TIGP2OEJ.js';
 import { text, svgRoot, title, desc, defs, el, group, circle, escapeXml } from './chunk-KLJEK547.js';
 
 // src/diagrams/circuit/netlist.ts
@@ -1833,6 +1833,7 @@ var circuit = {
     const first = text2.trim().split("\n")[0]?.trim().toLowerCase() ?? "";
     return first.startsWith("circuit");
   },
+  parse: parseCircuit,
   render(text2, config) {
     const ast = parseCircuit(text2);
     return renderCircuit(ast, config);
@@ -1840,5 +1841,5 @@ var circuit = {
 };
 
 export { circuit, layoutCircuit, layoutCircuitNetlist, parseCircuit, parseNetlist, renderCircuit };
-//# sourceMappingURL=chunk-XXU36667.js.map
-//# sourceMappingURL=chunk-XXU36667.js.map
+//# sourceMappingURL=chunk-2OIW3MAE.js.map
+//# sourceMappingURL=chunk-2OIW3MAE.js.map