@iyulab/declart-web 0.18.0

package/index.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Renders a TOML or JSON diagram declaration to SVG.
+ * @param input - TOML or JSON declaration string (format auto-detected)
+ * @param theme - Theme name: 'default', 'monochrome', 'accessible', 'warm' (defaults to 'default')
+ * @param width - Optional canvas width in pixels (height scales proportionally)
+ * @returns SVG string
+ * @throws If the declaration is invalid
+ */
+export function render(input: string, theme?: string, width?: number): string;
+
+/**
+ * Renders a JSON diagram declaration to SVG.
+ * @param input - JSON declaration string
+ * @param theme - Theme name (defaults to 'default')
+ * @param width - Optional canvas width in pixels
+ * @returns SVG string
+ * @throws If the JSON declaration is invalid
+ */
+export function renderJson(input: string, theme?: string, width?: number): string;
+
+/**
+ * Renders a TOML or JSON diagram declaration with a custom theme TOML.
+ * @param input - TOML or JSON declaration string
+ * @param themeToml - TOML theme definition string
+ * @param width - Optional canvas width in pixels
+ * @returns SVG string
+ * @throws If the declaration or theme is invalid
+ */
+export function renderWithThemeToml(input: string, themeToml: string, width?: number): string;
+
+/**
+ * Validates a TOML or JSON diagram declaration without rendering.
+ * @param input - TOML or JSON declaration string
+ * @throws If the declaration is invalid
+ */
+export function validate(input: string): void;
+
+/**
+ * Returns the list of supported theme names.
+ */
+export function themes(): string[];
+
+/**
+ * Returns the list of supported diagram kind names.
+ */
+export function kinds(): string[];

package/index.js

@@ -0,0 +1,30 @@
+import {
+  render as wasmRender,
+  render_json,
+  render_with_theme_toml,
+  validate,
+  themes as wasmThemes,
+  kinds as wasmKinds,
+} from './wasm/declart_wasm.js';
+
+export { validate };
+
+export function render(input, theme = 'default', width) {
+  return wasmRender(input, theme, width ?? undefined);
+}
+
+export function renderJson(input, theme = 'default', width) {
+  return render_json(input, theme, width ?? undefined);
+}
+
+export function renderWithThemeToml(input, themeToml, width) {
+  return render_with_theme_toml(input, themeToml, width ?? undefined);
+}
+
+export function themes() {
+  return wasmThemes().split(',');
+}
+
+export function kinds() {
+  return wasmKinds().split(',');
+}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@iyulab/declart-web",
+  "version": "0.18.0",
+  "description": "Declarative diagram engine for browsers and bundlers (Vite, webpack, Rollup) — declare what to show, the engine renders SVG",
+  "license": "MIT",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/iyulab/declart"
+  },
+  "main": "index.js",
+  "types": "index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.js"
+    }
+  },
+  "files": [
+    "index.js",
+    "index.d.ts",
+    "wasm/declart_wasm.js",
+    "wasm/declart_wasm.d.ts",
+    "wasm/declart_wasm_bg.wasm"
+  ],
+  "scripts": {
+    "build": "wasm-pack build ../../crates/declart-wasm --target bundler --out-dir ../../packages/declart-web/wasm"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": ["diagram", "svg", "wasm", "browser", "vite", "declart"]
+}

package/wasm/declart_wasm.d.ts

@@ -0,0 +1,52 @@
+/* tslint:disable */
+/* eslint-disable */
+
+/**
+ * Returns a comma-separated list of supported diagram kind names.
+ */
+export function kinds(): string;
+
+/**
+ * Renders a TOML or JSON diagram declaration to SVG.
+ *
+ * - `input`: TOML or JSON declaration string (auto-detected by leading `{`)
+ * - `theme`: `"default"`, `"monochrome"`, `"accessible"`, or `"warm"` (unknown values fall back to `"default"`)
+ * - `width`: optional canvas width in pixels (height scales proportionally)
+ *
+ * Returns the SVG string on success, or a `JsError` with a descriptive message on failure.
+ */
+export function render(input: string, theme: string, width?: number | null): string;
+
+/**
+ * Renders a JSON diagram declaration to SVG with a named theme.
+ *
+ * - `input`: JSON declaration string
+ * - `theme`: `"default"`, `"monochrome"`, `"accessible"`, or `"warm"`
+ * - `width`: optional canvas width in pixels
+ *
+ * Returns the SVG string on success, or a `JsError` on failure.
+ */
+export function render_json(input: string, theme: string, width?: number | null): string;
+
+/**
+ * Renders a TOML or JSON diagram declaration with a custom theme defined as a TOML string.
+ *
+ * - `input`: TOML or JSON declaration string (auto-detected)
+ * - `theme_toml`: TOML theme string (see [`Theme::from_toml`])
+ * - `width`: optional canvas width in pixels
+ *
+ * Returns the SVG string on success, or a `JsError` on parse/validation failure.
+ */
+export function render_with_theme_toml(input: string, theme_toml: string, width?: number | null): string;
+
+/**
+ * Returns a comma-separated list of supported theme names.
+ */
+export function themes(): string;
+
+/**
+ * Validates a TOML or JSON diagram declaration without rendering.
+ *
+ * Returns `Ok(())` if valid, or a `JsError` with the parse/validation error message.
+ */
+export function validate(input: string): void;

package/wasm/declart_wasm.js

@@ -0,0 +1,9 @@
+/* @ts-self-types="./declart_wasm.d.ts" */
+import * as wasm from "./declart_wasm_bg.wasm";
+import { __wbg_set_wasm } from "./declart_wasm_bg.js";
+
+__wbg_set_wasm(wasm);
+wasm.__wbindgen_start();
+export {
+    kinds, render, render_json, render_with_theme_toml, themes, validate
+} from "./declart_wasm_bg.js";