@kekonic/diagrams-build 1.0.0-rc.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kekonic
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,9 @@
+# `@kekonic/diagrams-build`
+
+Shared build-time contracts for first-party KDiagram adapters. Most applications should install a
+host integration such as `@kekonic/diagrams-remark`,
+`@kekonic/diagrams-markdown-it`, or `@kekonic/diagrams-unplugin` instead.
+
+This package deliberately delegates parsing, layout, and rendering to the public
+`@kekonic/diagrams` facade. It owns portable build defaults, diagnostic offsets, and virtual
+module generation so integrations do not duplicate KDiagram behavior.

package/dist/index.d.mts

@@ -0,0 +1,27 @@
+import { Diagnostic, RenderOptions } from "@kekonic/diagrams";
+
+//#region src/index.d.ts
+type KDiagramBuildOptions = {
+  renderOptions?: RenderOptions;
+};
+type KDiagramBuildResult = {
+  svg?: string;
+  diagnostics: Diagnostic[];
+};
+type KDiagramModuleKind = "svg" | "source" | "react" | "element";
+/** Render portable static output through KDiagram's public facade. */
+declare function renderKDiagramForBuild(source: string, options?: KDiagramBuildOptions): Promise<KDiagramBuildResult>;
+/** Map a KDiagram-local diagnostic onto its containing host document. */
+declare function offsetKDiagramDiagnostic<T extends Diagnostic>(diagnostic: T, contentStartLine: number): T & {
+  hostLine: number;
+  hostEndLine: number;
+};
+/** Generate the JavaScript boundary for a non-asset `.kdiagram` import. */
+declare function createKDiagramModule(kind: KDiagramModuleKind, source: string, svg?: string): string;
+declare function createKDiagramDataUrl(svg: string): string;
+declare function formatKDiagramBuildError(diagnostics: Diagnostic[]): string;
+declare function escapeKDiagramHtml(value: string): string;
+declare function escapeKDiagramAttribute(value: string): string;
+//#endregion
+export { KDiagramBuildOptions, KDiagramBuildResult, KDiagramModuleKind, createKDiagramDataUrl, createKDiagramModule, escapeKDiagramAttribute, escapeKDiagramHtml, formatKDiagramBuildError, offsetKDiagramDiagnostic, renderKDiagramForBuild };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -0,0 +1,63 @@
+import { KDiagram } from "@kekonic/diagrams";
+//#region src/index.ts
+/** Render portable static output through KDiagram's public facade. */
+async function renderKDiagramForBuild(source, options = {}) {
+	return KDiagram.renderToSvg(source, {
+		snapshotTheme: true,
+		...options.renderOptions
+	});
+}
+/** Map a KDiagram-local diagnostic onto its containing host document. */
+function offsetKDiagramDiagnostic(diagnostic, contentStartLine) {
+	const sourceStart = diagnostic.range?.start.line ?? 1;
+	const sourceEnd = diagnostic.range?.end.line ?? sourceStart;
+	return {
+		...diagnostic,
+		hostLine: contentStartLine + sourceStart - 1,
+		hostEndLine: contentStartLine + sourceEnd - 1
+	};
+}
+/** Generate the JavaScript boundary for a non-asset `.kdiagram` import. */
+function createKDiagramModule(kind, source, svg) {
+	if (kind === "source") return `export default ${JSON.stringify(source)};\n`;
+	if (kind === "svg") {
+		if (svg === void 0) throw new Error("SVG output is required for a ?svg module");
+		return `export default ${JSON.stringify(svg)};\n`;
+	}
+	if (kind === "react") return [
+		"import { createElement } from \"react\";",
+		"import { KDiagramLive } from \"@kekonic/diagrams-ui\";",
+		`export const source = ${JSON.stringify(source)};`,
+		"export default function KDiagramImportedDiagram(props = {}) {",
+		"  return createElement(KDiagramLive, { ...props, source });",
+		"}",
+		""
+	].join("\n");
+	return [
+		"import { KDiagramElement } from \"@kekonic/diagrams-element\";",
+		`export const source = ${JSON.stringify(source)};`,
+		"export default class KDiagramImportedDiagram extends KDiagramElement {",
+		"  constructor() {",
+		"    super();",
+		"    this.source = source;",
+		"  }",
+		"}",
+		""
+	].join("\n");
+}
+function createKDiagramDataUrl(svg) {
+	return `data:image/svg+xml;charset=utf-8,${encodeURIComponent(svg)}`;
+}
+function formatKDiagramBuildError(diagnostics) {
+	return diagnostics.map((diagnostic) => diagnostic.message).join("; ") || "Unable to render diagram";
+}
+function escapeKDiagramHtml(value) {
+	return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
+}
+function escapeKDiagramAttribute(value) {
+	return escapeKDiagramHtml(value).replaceAll("\"", "&quot;");
+}
+//#endregion
+export { createKDiagramDataUrl, createKDiagramModule, escapeKDiagramAttribute, escapeKDiagramHtml, formatKDiagramBuildError, offsetKDiagramDiagnostic, renderKDiagramForBuild };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { KDiagram, type Diagnostic, type RenderOptions } from \"@kekonic/diagrams\";\n\nexport type KDiagramBuildOptions = {\n  renderOptions?: RenderOptions;\n};\n\nexport type KDiagramBuildResult = {\n  svg?: string;\n  diagnostics: Diagnostic[];\n};\n\nexport type KDiagramModuleKind = \"svg\" | \"source\" | \"react\" | \"element\";\n\n/** Render portable static output through KDiagram's public facade. */\nexport async function renderKDiagramForBuild(\n  source: string,\n  options: KDiagramBuildOptions = {},\n): Promise<KDiagramBuildResult> {\n  return KDiagram.renderToSvg(source, {\n    snapshotTheme: true,\n    ...options.renderOptions,\n  });\n}\n\n/** Map a KDiagram-local diagnostic onto its containing host document. */\nexport function offsetKDiagramDiagnostic<T extends Diagnostic>(\n  diagnostic: T,\n  contentStartLine: number,\n): T & { hostLine: number; hostEndLine: number } {\n  const sourceStart = diagnostic.range?.start.line ?? 1;\n  const sourceEnd = diagnostic.range?.end.line ?? sourceStart;\n  return {\n    ...diagnostic,\n    hostLine: contentStartLine + sourceStart - 1,\n    hostEndLine: contentStartLine + sourceEnd - 1,\n  };\n}\n\n/** Generate the JavaScript boundary for a non-asset `.kdiagram` import. */\nexport function createKDiagramModule(\n  kind: KDiagramModuleKind,\n  source: string,\n  svg?: string,\n): string {\n  if (kind === \"source\") return `export default ${JSON.stringify(source)};\\n`;\n  if (kind === \"svg\") {\n    if (svg === undefined) throw new Error(\"SVG output is required for a ?svg module\");\n    return `export default ${JSON.stringify(svg)};\\n`;\n  }\n  if (kind === \"react\") {\n    return [\n      'import { createElement } from \"react\";',\n      'import { KDiagramLive } from \"@kekonic/diagrams-ui\";',\n      `export const source = ${JSON.stringify(source)};`,\n      \"export default function KDiagramImportedDiagram(props = {}) {\",\n      \"  return createElement(KDiagramLive, { ...props, source });\",\n      \"}\",\n      \"\",\n    ].join(\"\\n\");\n  }\n  return [\n    'import { KDiagramElement } from \"@kekonic/diagrams-element\";',\n    `export const source = ${JSON.stringify(source)};`,\n    \"export default class KDiagramImportedDiagram extends KDiagramElement {\",\n    \"  constructor() {\",\n    \"    super();\",\n    \"    this.source = source;\",\n    \"  }\",\n    \"}\",\n    \"\",\n  ].join(\"\\n\");\n}\n\nexport function createKDiagramDataUrl(svg: string): string {\n  return `data:image/svg+xml;charset=utf-8,${encodeURIComponent(svg)}`;\n}\n\nexport function formatKDiagramBuildError(diagnostics: Diagnostic[]): string {\n  return (\n    diagnostics.map((diagnostic) => diagnostic.message).join(\"; \") || \"Unable to render diagram\"\n  );\n}\n\nexport function escapeKDiagramHtml(value: string): string {\n  return value.replaceAll(\"&\", \"&amp;\").replaceAll(\"<\", \"&lt;\").replaceAll(\">\", \"&gt;\");\n}\n\nexport function escapeKDiagramAttribute(value: string): string {\n  return escapeKDiagramHtml(value).replaceAll('\"', \"&quot;\");\n}\n"],"mappings":";;;AAcA,eAAsB,uBACpB,QACA,UAAgC,CAAC,GACH;CAC9B,OAAO,SAAS,YAAY,QAAQ;EAClC,eAAe;EACf,GAAG,QAAQ;CACb,CAAC;AACH;;AAGA,SAAgB,yBACd,YACA,kBAC+C;CAC/C,MAAM,cAAc,WAAW,OAAO,MAAM,QAAQ;CACpD,MAAM,YAAY,WAAW,OAAO,IAAI,QAAQ;CAChD,OAAO;EACL,GAAG;EACH,UAAU,mBAAmB,cAAc;EAC3C,aAAa,mBAAmB,YAAY;CAC9C;AACF;;AAGA,SAAgB,qBACd,MACA,QACA,KACQ;CACR,IAAI,SAAS,UAAU,OAAO,kBAAkB,KAAK,UAAU,MAAM,EAAE;CACvE,IAAI,SAAS,OAAO;EAClB,IAAI,QAAQ,KAAA,GAAW,MAAM,IAAI,MAAM,0CAA0C;EACjF,OAAO,kBAAkB,KAAK,UAAU,GAAG,EAAE;CAC/C;CACA,IAAI,SAAS,SACX,OAAO;EACL;EACA;EACA,yBAAyB,KAAK,UAAU,MAAM,EAAE;EAChD;EACA;EACA;EACA;CACF,CAAC,CAAC,KAAK,IAAI;CAEb,OAAO;EACL;EACA,yBAAyB,KAAK,UAAU,MAAM,EAAE;EAChD;EACA;EACA;EACA;EACA;EACA;EACA;CACF,CAAC,CAAC,KAAK,IAAI;AACb;AAEA,SAAgB,sBAAsB,KAAqB;CACzD,OAAO,oCAAoC,mBAAmB,GAAG;AACnE;AAEA,SAAgB,yBAAyB,aAAmC;CAC1E,OACE,YAAY,KAAK,eAAe,WAAW,OAAO,CAAC,CAAC,KAAK,IAAI,KAAK;AAEtE;AAEA,SAAgB,mBAAmB,OAAuB;CACxD,OAAO,MAAM,WAAW,KAAK,OAAO,CAAC,CAAC,WAAW,KAAK,MAAM,CAAC,CAAC,WAAW,KAAK,MAAM;AACtF;AAEA,SAAgB,wBAAwB,OAAuB;CAC7D,OAAO,mBAAmB,KAAK,CAAC,CAAC,WAAW,MAAK,QAAQ;AAC3D"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@kekonic/diagrams-build",
+  "version": "1.0.0-rc.4",
+  "description": "Shared build-time rendering contracts for KDiagram integrations.",
+  "keywords": [
+    "build",
+    "diagram",
+    "integration",
+    "kdiagram"
+  ],
+  "homepage": "https://github.com/kekonic/diagrams#readme",
+  "bugs": {
+    "url": "https://github.com/kekonic/diagrams/issues"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kekonic/diagrams.git",
+    "directory": "packages/diagrams-build"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@kekonic/diagrams": "1.0.0-rc.4"
+  },
+  "engines": {
+    "node": ">=22.18.0"
+  },
+  "scripts": {
+    "build": "vp pack",
+    "test": "vp test"
+  }
+}