@zenuml/core 4.0.0 → 4.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zenuml/core",
-  "version": "4.0.0",
+  "version": "4.1.0",
   "private": false,
   "license": "MIT",
   "repository": {
@@ -22,9 +22,10 @@
     "build:lsp:worker": "bun run --bun vite build -c vite.config.lsp-worker.ts",
     "build:lsp": "bun run build:lsp:node && bun run build:lsp:worker",
     "lsp": "bun src/parser-langium/lsp/main.ts --stdio",
-    "build": "bun run build:lib && bun run build:cli",
-    "build:release": "RELEASE=1 bun run build:lib && RELEASE=1 bun run build:cli && RELEASE=1 bun run build:lsp",
-    "build:analyze": "RELEASE=1 ANALYZE=1 bun run build:lib && RELEASE=1 bun run build:cli",
+    "build:parser": "bun run --bun vite build -c vite.config.parser.ts",
+    "build": "bun run build:lib && bun run build:cli && bun run build:parser",
+    "build:release": "RELEASE=1 bun run build:lib && RELEASE=1 bun run build:cli && RELEASE=1 bun run build:lsp && RELEASE=1 bun run build:parser",
+    "build:analyze": "RELEASE=1 ANALYZE=1 bun run build:lib && RELEASE=1 bun run build:cli && RELEASE=1 bun run build:parser",
     "changeset": "changeset",
     "changeset:version": "changeset version",
     "release": "bun run build:release && changeset publish",
@@ -80,7 +81,17 @@
       }
     },
     "./lsp-worker": "./dist/lsp/zenuml-server.worker.js",
-    "./lsp-server": "./dist/lsp/main.js"
+    "./lsp-server": "./dist/lsp/main.js",
+    "./parser": {
+      "import": {
+        "types": "./types/parser/index.d.ts",
+        "default": "./dist/parser/index.mjs"
+      },
+      "require": {
+        "types": "./types/parser/index.d.ts",
+        "default": "./dist/parser/index.cjs"
+      }
+    }
   },
   "engines": {
     "node": ">=20"
@@ -112,7 +123,7 @@
     "@changesets/changelog-github": "^0.7.0",
     "@changesets/cli": "^2.31.0",
     "@eslint/js": "^9.39.2",
-    "@happy-dom/global-registrator": "^18.0.1",
+    "@happy-dom/global-registrator": "^20.10.6",
     "@playwright/test": "^1.57.0",
     "@storybook/addon-docs": "^9.1.17",
     "@storybook/addon-onboarding": "^9.1.17",
@@ -135,7 +146,7 @@
     "eslint-plugin-react-refresh": "^0.4.26",
     "eslint-plugin-storybook": "^9.1.17",
     "globals": "^15.15.0",
-    "happy-dom": "^18.0.1",
+    "happy-dom": "^20.10.6",
     "jsdom": "^26.1.0",
     "langium": "4.2.4",
     "langium-cli": "4.2.1",

package/types/parser/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * `@zenuml/core/parser` — headless, server-safe ANTLR parsing/validation for
+ * ZenUML DSL. Unlike the default `@zenuml/core` entry (a browser/DOM bundle),
+ * this subpath imports cleanly in Node and is reentrant (safe to call
+ * repeatedly/concurrently — it does not touch any shared module state).
+ */
+
+export interface ErrorDetail {
+  /** 1-based line of the offending token. */
+  line: number;
+  /** 0-based column of the offending token. */
+  column: number;
+  /** ANTLR diagnostic message. */
+  msg: string;
+}
+
+export interface ParseResult {
+  /** True when the DSL parsed with no syntax errors. */
+  pass: boolean;
+  /** Structured syntax errors (empty when `pass` is true). */
+  errorDetails: ErrorDetail[];
+}
+
+export interface ParseTreeResult extends ParseResult {
+  /**
+   * ANTLR `ProgContext` parse tree. ANTLR error recovery still produces a
+   * best-effort tree even when `pass` is false, so this is generally present.
+   * Typed as `unknown` — cast to the ANTLR context type if you walk it.
+   */
+  rootContext: unknown;
+}
+
+/** Validate ZenUML DSL syntax without exposing the parse tree. */
+export declare function validate(code: string): ParseResult;
+
+/** Parse ZenUML DSL, returning the error-recovered tree plus structured errors. */
+export declare function parse(code: string): ParseTreeResult;