schematex 0.3.2 → 0.3.4

package/README.md

@@ -534,12 +534,31 @@ import { SchematexDiagram } from 'schematex/react';
 
 // Export (browser Canvas)
 import { svgToPngBlob, downloadBlob, printSvgAsPdf } from 'schematex/export';
-const blob = await svgToPngBlob(svg, { scale: 2 });
+const blob = await svgToPngBlob(svg, { scale: 2 });           // transparent PNG
+const opaque = await svgToPngBlob(svg, { background: 'white' }); // opt-in fill
 downloadBlob(blob, 'diagram.png');
 ```
 
 See the [API reference →](https://schematex.dev/docs/api).
 
+### Backgrounds & dark mode
+
+Schematex SVGs are **background-agnostic by default** — no fill is baked into the
+output, so a diagram inherits whatever color its host element provides. This
+keeps the same SVG embeddable in light pages, dark canvases, or print PDFs.
+
+When using `theme: "dark"`, the diagram's strokes and text are designed for a
+dark surface — wrap the SVG in a container with a dark background, e.g.:
+
+```html
+<div style="background: #0f172a; padding: 16px;">
+  <!-- schematex SVG with theme: "dark" -->
+</div>
+```
+
+PNG export (`svgToPngBlob`) defaults to a transparent background. Pass
+`background: 'white'` (or any color) to bake one in.
+
 ## Ecosystem
 
 - **React** — `schematex/react` — `<SchematexDiagram dsl="..." />` component

package/dist/ai/ai-sdk.cjs

@@ -1,26 +1,26 @@
 'use strict';
 
-var chunkRODV6PC4_cjs = require('../chunk-RODV6PC4.cjs');
-require('../chunk-YTEEZV6J.cjs');
-require('../chunk-L2KUGWFR.cjs');
-require('../chunk-XUEROLSB.cjs');
-require('../chunk-2UJAVPA4.cjs');
-require('../chunk-MKKFIPKU.cjs');
-require('../chunk-EYHD7LV3.cjs');
-require('../chunk-XI6JOG76.cjs');
-require('../chunk-3YXXZ4LT.cjs');
-require('../chunk-W7GIQTJV.cjs');
-require('../chunk-GYTWJ6VB.cjs');
-require('../chunk-BUN3CRMP.cjs');
-require('../chunk-UK7JF5QB.cjs');
-require('../chunk-KUXOHLGC.cjs');
-require('../chunk-OK5RYX55.cjs');
-require('../chunk-C3IVD7DI.cjs');
-require('../chunk-75BMFCP5.cjs');
-require('../chunk-K5QG53GT.cjs');
-require('../chunk-7MVDN5UC.cjs');
+var chunkJ3Y2QDJR_cjs = require('../chunk-J3Y2QDJR.cjs');
+require('../chunk-DBMZEZLF.cjs');
+require('../chunk-T47A6XUK.cjs');
+require('../chunk-4THC4VUA.cjs');
+require('../chunk-CS67UBP3.cjs');
+require('../chunk-IFR34VTL.cjs');
+require('../chunk-H5JYZ5YS.cjs');
+require('../chunk-V4OVUBLA.cjs');
+require('../chunk-6WORZSL3.cjs');
+require('../chunk-MIKCKV27.cjs');
+require('../chunk-6ULC3UHJ.cjs');
+require('../chunk-K6RAUXRQ.cjs');
+require('../chunk-3MJKJX27.cjs');
+require('../chunk-O5POCPXZ.cjs');
+require('../chunk-CQP5YHVK.cjs');
+require('../chunk-WIFGBWET.cjs');
+require('../chunk-5UCXMYE7.cjs');
+require('../chunk-5COUZTVA.cjs');
+require('../chunk-XSNNGYXZ.cjs');
 require('../chunk-D7EHZFK4.cjs');
-require('../chunk-LFZZ4NCP.cjs');
+require('../chunk-3WNW5Y7P.cjs');
 var ai = require('ai');
 var zod = require('zod');
 
@@ -28,7 +28,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 () => chunkRODV6PC4_cjs.listDiagrams()
+    execute: async () => chunkJ3Y2QDJR_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.",
@@ -37,7 +37,7 @@ var schematexTools = {
         "Diagram type id from listDiagrams (e.g. 'genogram', 'sld', 'fishbone')."
       )
     }),
-    execute: async ({ type }) => chunkRODV6PC4_cjs.getSyntax(type)
+    execute: async ({ type }) => chunkJ3Y2QDJR_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.",
@@ -47,7 +47,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) => chunkRODV6PC4_cjs.getExamples(args.type, {
+    execute: async (args) => chunkJ3Y2QDJR_cjs.getExamples(args.type, {
       limit: args.limit,
       preferFeatured: args.preferFeatured,
       maxComplexity: args.maxComplexity
@@ -61,7 +61,7 @@ var schematexTools = {
       ),
       dsl: zod.z.string().describe("The DSL source text to validate.")
     }),
-    execute: async ({ type, dsl }) => chunkRODV6PC4_cjs.validateDsl(type, dsl)
+    execute: async ({ type, dsl }) => chunkJ3Y2QDJR_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.",
@@ -76,7 +76,7 @@ var schematexTools = {
       dsl,
       theme,
       padding
-    }) => chunkRODV6PC4_cjs.renderDsl(type, dsl, { theme, padding })
+    }) => chunkJ3Y2QDJR_cjs.renderDsl(type, dsl, { theme, padding })
   })
 };
 

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

@@ -1,7 +1,7 @@
 import * as ai from 'ai';
 import { DiagramListItem, GetSyntaxResult, GetExamplesResult, ValidateDslResult, RenderDslResult } from './index.cjs';
 import '../api-BuFilDQB.cjs';
-import '../types-BtiUg7Gx.cjs';
+import '../types-DnU2UlWz.cjs';
 
 declare const schematexTools: {
     readonly listDiagrams: ai.Tool<{}, DiagramListItem[]>;

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

@@ -1,7 +1,7 @@
 import * as ai from 'ai';
 import { DiagramListItem, GetSyntaxResult, GetExamplesResult, ValidateDslResult, RenderDslResult } from './index.js';
 import '../api-BuFilDQB.js';
-import '../types-BtiUg7Gx.js';
+import '../types-DnU2UlWz.js';
 
 declare const schematexTools: {
     readonly listDiagrams: ai.Tool<{}, DiagramListItem[]>;

package/dist/ai/ai-sdk.js

@@ -1,24 +1,24 @@
-import { renderDsl, validateDsl, getExamples, getSyntax, listDiagrams } from '../chunk-H4CJTKEH.js';
-import '../chunk-RNGYXGHS.js';
-import '../chunk-SFSZUOFT.js';
-import '../chunk-ZNLEUL7T.js';
-import '../chunk-F6OROIHS.js';
-import '../chunk-M3R6RCXY.js';
-import '../chunk-BJWMPPEA.js';
-import '../chunk-NFT6VW73.js';
-import '../chunk-7BEJHG43.js';
-import '../chunk-BJ65PKDU.js';
-import '../chunk-2J2QWNGI.js';
-import '../chunk-SE23X5OE.js';
-import '../chunk-IT2TVXC7.js';
-import '../chunk-6BKUD5EJ.js';
-import '../chunk-X4F6VVEJ.js';
-import '../chunk-56LXBM45.js';
-import '../chunk-ZTSO3S4P.js';
-import '../chunk-HIQPEAL7.js';
-import '../chunk-M5ZC3LFJ.js';
+import { renderDsl, validateDsl, getExamples, getSyntax, listDiagrams } from '../chunk-DNZV4V4R.js';
+import '../chunk-HKJRHXGZ.js';
+import '../chunk-TWAC2IIS.js';
+import '../chunk-5SKT7RYR.js';
+import '../chunk-5CTERELC.js';
+import '../chunk-ZKDL6Y3O.js';
+import '../chunk-PWI4NFYR.js';
+import '../chunk-DHKKDIVT.js';
+import '../chunk-YWDODCW2.js';
+import '../chunk-IURM4ZWE.js';
+import '../chunk-VRE5VWDQ.js';
+import '../chunk-WHNIK4LK.js';
+import '../chunk-LPKVIRYT.js';
+import '../chunk-6XGSEG3K.js';
+import '../chunk-I6VEXSUK.js';
+import '../chunk-ZQZNWAHH.js';
+import '../chunk-FO7BLCEW.js';
+import '../chunk-3RAVPXLN.js';
+import '../chunk-IZMAZOQI.js';
 import '../chunk-2VNMKOUO.js';
-import '../chunk-WHJXRLFD.js';
+import '../chunk-SYYBKDL7.js';
 import { tool } from 'ai';
 import { z } from 'zod';
 

package/dist/ai/index.cjs

@@ -1,60 +1,60 @@
 'use strict';
 
-var chunkRODV6PC4_cjs = require('../chunk-RODV6PC4.cjs');
-require('../chunk-YTEEZV6J.cjs');
-require('../chunk-L2KUGWFR.cjs');
-require('../chunk-XUEROLSB.cjs');
-require('../chunk-2UJAVPA4.cjs');
-require('../chunk-MKKFIPKU.cjs');
-require('../chunk-EYHD7LV3.cjs');
-require('../chunk-XI6JOG76.cjs');
-require('../chunk-3YXXZ4LT.cjs');
-require('../chunk-W7GIQTJV.cjs');
-require('../chunk-GYTWJ6VB.cjs');
-require('../chunk-BUN3CRMP.cjs');
-require('../chunk-UK7JF5QB.cjs');
-require('../chunk-KUXOHLGC.cjs');
-require('../chunk-OK5RYX55.cjs');
-require('../chunk-C3IVD7DI.cjs');
-require('../chunk-75BMFCP5.cjs');
-require('../chunk-K5QG53GT.cjs');
-require('../chunk-7MVDN5UC.cjs');
+var chunkJ3Y2QDJR_cjs = require('../chunk-J3Y2QDJR.cjs');
+require('../chunk-DBMZEZLF.cjs');
+require('../chunk-T47A6XUK.cjs');
+require('../chunk-4THC4VUA.cjs');
+require('../chunk-CS67UBP3.cjs');
+require('../chunk-IFR34VTL.cjs');
+require('../chunk-H5JYZ5YS.cjs');
+require('../chunk-V4OVUBLA.cjs');
+require('../chunk-6WORZSL3.cjs');
+require('../chunk-MIKCKV27.cjs');
+require('../chunk-6ULC3UHJ.cjs');
+require('../chunk-K6RAUXRQ.cjs');
+require('../chunk-3MJKJX27.cjs');
+require('../chunk-O5POCPXZ.cjs');
+require('../chunk-CQP5YHVK.cjs');
+require('../chunk-WIFGBWET.cjs');
+require('../chunk-5UCXMYE7.cjs');
+require('../chunk-5COUZTVA.cjs');
+require('../chunk-XSNNGYXZ.cjs');
 require('../chunk-D7EHZFK4.cjs');
-require('../chunk-LFZZ4NCP.cjs');
+require('../chunk-3WNW5Y7P.cjs');
 
 
 
 Object.defineProperty(exports, "DIAGRAM_REGISTRY", {
   enumerable: true,
-  get: function () { return chunkRODV6PC4_cjs.DIAGRAM_REGISTRY; }
+  get: function () { return chunkJ3Y2QDJR_cjs.DIAGRAM_REGISTRY; }
 });
 Object.defineProperty(exports, "getAllDiagramTypes", {
   enumerable: true,
-  get: function () { return chunkRODV6PC4_cjs.getAllDiagramTypes; }
+  get: function () { return chunkJ3Y2QDJR_cjs.getAllDiagramTypes; }
 });
 Object.defineProperty(exports, "getDiagramMeta", {
   enumerable: true,
-  get: function () { return chunkRODV6PC4_cjs.getDiagramMeta; }
+  get: function () { return chunkJ3Y2QDJR_cjs.getDiagramMeta; }
 });
 Object.defineProperty(exports, "getExamples", {
   enumerable: true,
-  get: function () { return chunkRODV6PC4_cjs.getExamples; }
+  get: function () { return chunkJ3Y2QDJR_cjs.getExamples; }
 });
 Object.defineProperty(exports, "getSyntax", {
   enumerable: true,
-  get: function () { return chunkRODV6PC4_cjs.getSyntax; }
+  get: function () { return chunkJ3Y2QDJR_cjs.getSyntax; }
 });
 Object.defineProperty(exports, "listDiagrams", {
   enumerable: true,
-  get: function () { return chunkRODV6PC4_cjs.listDiagrams; }
+  get: function () { return chunkJ3Y2QDJR_cjs.listDiagrams; }
 });
 Object.defineProperty(exports, "renderDsl", {
   enumerable: true,
-  get: function () { return chunkRODV6PC4_cjs.renderDsl; }
+  get: function () { return chunkJ3Y2QDJR_cjs.renderDsl; }
 });
 Object.defineProperty(exports, "validateDsl", {
   enumerable: true,
-  get: function () { return chunkRODV6PC4_cjs.validateDsl; }
+  get: function () { return chunkJ3Y2QDJR_cjs.validateDsl; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/ai/index.d.cts

@@ -1,5 +1,5 @@
 import { S as SchematexConfig } from '../api-BuFilDQB.cjs';
-import { q as DiagramType } from '../types-BtiUg7Gx.cjs';
+import { q as DiagramType } from '../types-DnU2UlWz.cjs';
 
 /**
  * Diagram registry — metadata for every diagram type Schematex supports.

package/dist/ai/index.d.ts

@@ -1,5 +1,5 @@
 import { S as SchematexConfig } from '../api-BuFilDQB.js';
-import { q as DiagramType } from '../types-BtiUg7Gx.js';
+import { q as DiagramType } from '../types-DnU2UlWz.js';
 
 /**
  * Diagram registry — metadata for every diagram type Schematex supports.

package/dist/ai/index.js

@@ -1,23 +1,23 @@
-export { DIAGRAM_REGISTRY, getAllDiagramTypes, getDiagramMeta, getExamples, getSyntax, listDiagrams, renderDsl, validateDsl } from '../chunk-H4CJTKEH.js';
-import '../chunk-RNGYXGHS.js';
-import '../chunk-SFSZUOFT.js';
-import '../chunk-ZNLEUL7T.js';
-import '../chunk-F6OROIHS.js';
-import '../chunk-M3R6RCXY.js';
-import '../chunk-BJWMPPEA.js';
-import '../chunk-NFT6VW73.js';
-import '../chunk-7BEJHG43.js';
-import '../chunk-BJ65PKDU.js';
-import '../chunk-2J2QWNGI.js';
-import '../chunk-SE23X5OE.js';
-import '../chunk-IT2TVXC7.js';
-import '../chunk-6BKUD5EJ.js';
-import '../chunk-X4F6VVEJ.js';
-import '../chunk-56LXBM45.js';
-import '../chunk-ZTSO3S4P.js';
-import '../chunk-HIQPEAL7.js';
-import '../chunk-M5ZC3LFJ.js';
+export { DIAGRAM_REGISTRY, getAllDiagramTypes, getDiagramMeta, getExamples, getSyntax, listDiagrams, renderDsl, validateDsl } from '../chunk-DNZV4V4R.js';
+import '../chunk-HKJRHXGZ.js';
+import '../chunk-TWAC2IIS.js';
+import '../chunk-5SKT7RYR.js';
+import '../chunk-5CTERELC.js';
+import '../chunk-ZKDL6Y3O.js';
+import '../chunk-PWI4NFYR.js';
+import '../chunk-DHKKDIVT.js';
+import '../chunk-YWDODCW2.js';
+import '../chunk-IURM4ZWE.js';
+import '../chunk-VRE5VWDQ.js';
+import '../chunk-WHNIK4LK.js';
+import '../chunk-LPKVIRYT.js';
+import '../chunk-6XGSEG3K.js';
+import '../chunk-I6VEXSUK.js';
+import '../chunk-ZQZNWAHH.js';
+import '../chunk-FO7BLCEW.js';
+import '../chunk-3RAVPXLN.js';
+import '../chunk-IZMAZOQI.js';
 import '../chunk-2VNMKOUO.js';
-import '../chunk-WHJXRLFD.js';
+import '../chunk-SYYBKDL7.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/browser.cjs

@@ -1,29 +1,29 @@
 'use strict';
 
-var chunkYTEEZV6J_cjs = require('./chunk-YTEEZV6J.cjs');
-require('./chunk-L2KUGWFR.cjs');
-require('./chunk-XUEROLSB.cjs');
-require('./chunk-2UJAVPA4.cjs');
-require('./chunk-MKKFIPKU.cjs');
-require('./chunk-EYHD7LV3.cjs');
-require('./chunk-XI6JOG76.cjs');
-require('./chunk-3YXXZ4LT.cjs');
-require('./chunk-W7GIQTJV.cjs');
-require('./chunk-GYTWJ6VB.cjs');
-require('./chunk-BUN3CRMP.cjs');
-require('./chunk-UK7JF5QB.cjs');
-require('./chunk-KUXOHLGC.cjs');
-require('./chunk-OK5RYX55.cjs');
-require('./chunk-C3IVD7DI.cjs');
-require('./chunk-75BMFCP5.cjs');
-require('./chunk-K5QG53GT.cjs');
-require('./chunk-7MVDN5UC.cjs');
+var chunkDBMZEZLF_cjs = require('./chunk-DBMZEZLF.cjs');
+require('./chunk-T47A6XUK.cjs');
+require('./chunk-4THC4VUA.cjs');
+require('./chunk-CS67UBP3.cjs');
+require('./chunk-IFR34VTL.cjs');
+require('./chunk-H5JYZ5YS.cjs');
+require('./chunk-V4OVUBLA.cjs');
+require('./chunk-6WORZSL3.cjs');
+require('./chunk-MIKCKV27.cjs');
+require('./chunk-6ULC3UHJ.cjs');
+require('./chunk-K6RAUXRQ.cjs');
+require('./chunk-3MJKJX27.cjs');
+require('./chunk-O5POCPXZ.cjs');
+require('./chunk-CQP5YHVK.cjs');
+require('./chunk-WIFGBWET.cjs');
+require('./chunk-5UCXMYE7.cjs');
+require('./chunk-5COUZTVA.cjs');
+require('./chunk-XSNNGYXZ.cjs');
 require('./chunk-D7EHZFK4.cjs');
-require('./chunk-LFZZ4NCP.cjs');
+require('./chunk-3WNW5Y7P.cjs');
 
 // src/browser.ts
 function renderToElement(text, config) {
-  const svgString = chunkYTEEZV6J_cjs.render(text, config);
+  const svgString = chunkDBMZEZLF_cjs.render(text, config);
   const parser = new DOMParser();
   const doc = parser.parseFromString(svgString, "image/svg+xml");
   const el = doc.documentElement;
@@ -34,12 +34,12 @@ function renderToElement(text, config) {
   return el;
 }
 function renderToContainer(text, container, config) {
-  container.innerHTML = chunkYTEEZV6J_cjs.render(text, config);
+  container.innerHTML = chunkDBMZEZLF_cjs.render(text, config);
 }
 
 Object.defineProperty(exports, "render", {
   enumerable: true,
-  get: function () { return chunkYTEEZV6J_cjs.render; }
+  get: function () { return chunkDBMZEZLF_cjs.render; }
 });
 exports.renderToContainer = renderToContainer;
 exports.renderToElement = renderToElement;

package/dist/browser.js

@@ -1,24 +1,24 @@
-import { render } from './chunk-RNGYXGHS.js';
-export { render } from './chunk-RNGYXGHS.js';
-import './chunk-SFSZUOFT.js';
-import './chunk-ZNLEUL7T.js';
-import './chunk-F6OROIHS.js';
-import './chunk-M3R6RCXY.js';
-import './chunk-BJWMPPEA.js';
-import './chunk-NFT6VW73.js';
-import './chunk-7BEJHG43.js';
-import './chunk-BJ65PKDU.js';
-import './chunk-2J2QWNGI.js';
-import './chunk-SE23X5OE.js';
-import './chunk-IT2TVXC7.js';
-import './chunk-6BKUD5EJ.js';
-import './chunk-X4F6VVEJ.js';
-import './chunk-56LXBM45.js';
-import './chunk-ZTSO3S4P.js';
-import './chunk-HIQPEAL7.js';
-import './chunk-M5ZC3LFJ.js';
+import { render } from './chunk-HKJRHXGZ.js';
+export { render } from './chunk-HKJRHXGZ.js';
+import './chunk-TWAC2IIS.js';
+import './chunk-5SKT7RYR.js';
+import './chunk-5CTERELC.js';
+import './chunk-ZKDL6Y3O.js';
+import './chunk-PWI4NFYR.js';
+import './chunk-DHKKDIVT.js';
+import './chunk-YWDODCW2.js';
+import './chunk-IURM4ZWE.js';
+import './chunk-VRE5VWDQ.js';
+import './chunk-WHNIK4LK.js';
+import './chunk-LPKVIRYT.js';
+import './chunk-6XGSEG3K.js';
+import './chunk-I6VEXSUK.js';
+import './chunk-ZQZNWAHH.js';
+import './chunk-FO7BLCEW.js';
+import './chunk-3RAVPXLN.js';
+import './chunk-IZMAZOQI.js';
 import './chunk-2VNMKOUO.js';
-import './chunk-WHJXRLFD.js';
+import './chunk-SYYBKDL7.js';
 
 // src/browser.ts
 function renderToElement(text, config) {