feat!: migrate to tsdown, vitest, and oxc tooling

Author: JBBianchi

.lintstagedrc.json

@@ -1,3 +1,5 @@
 {
-  "*.{js,json,md,mjs,ts,yaml,yml}": "prettier --write"
+  "*.{js,mjs,ts}": ["oxlint -c ./.oxlintrc.json", "oxfmt --config ./.oxfmtrc.json --write"],
+  "vitest.config.mjs": "oxfmt --config ./.oxfmtrc.json --write",
+  "tsdown.config.mjs": "oxfmt --config ./.oxfmtrc.json --write"
 }

.oxfmtrc.json

@@ -0,0 +1,12 @@
+{
+  "endOfLine": "lf",
+  "printWidth": 120,
+  "singleQuote": true,
+  "trailingComma": "all",
+  "ignorePatterns": [
+    "node_modules",
+    "dist",
+    "coverage",
+    "*.tgz"
+  ]
+}

.oxlintrc.json

@@ -0,0 +1,59 @@
+{
+  "$schema": "./node_modules/oxlint/configuration_schema.json",
+  "env": {
+    "browser": true,
+    "node": true
+  },
+  "plugins": ["typescript"],
+  "ignorePatterns": ["dist/**", "coverage/**"],
+  "rules": {
+    "no-unused-vars": ["error", { "argsIgnorePattern": "^_", "varsIgnorePattern": "^_" }]
+  },
+  "overrides": [
+    {
+      "files": ["**/*.ts"],
+      "rules": {
+        "no-unused-vars": "off",
+        "typescript/ban-ts-comment": "error",
+        "typescript/no-inferrable-types": "off",
+        "typescript/no-unused-vars": ["error", { "argsIgnorePattern": "^_", "varsIgnorePattern": "^_" }],
+        "typescript/no-explicit-any": "error"
+      }
+    },
+    {
+      "files": ["src/lib/lifecycle-hooks.ts"],
+      "rules": {
+        "typescript/no-explicit-any": "off"
+      }
+    },
+    {
+      "files": ["tests/**/*.ts"],
+      "globals": {
+        "afterAll": "readonly",
+        "afterEach": "readonly",
+        "beforeAll": "readonly",
+        "beforeEach": "readonly",
+        "describe": "readonly",
+        "expect": "readonly",
+        "it": "readonly",
+        "test": "readonly"
+      },
+      "rules": {
+        "typescript/no-explicit-any": "off"
+      }
+    },
+    {
+      "files": ["tools/**/*.ts"],
+      "rules": {
+        "typescript/no-explicit-any": "off"
+      }
+    },
+    {
+      "files": ["src/lib/generated/**/*.ts"],
+      "rules": {
+        "typescript/no-explicit-any": "off",
+        "typescript/no-unused-vars": "off"
+      }
+    }
+  ]
+}

.prettierignore

@@ -19,10 +19,10 @@ npm run build
 npm run validate:package
 ```
 
-- `npm run lint` checks the ESLint and Prettier baselines.
-- `npm run test` runs the manual-code typecheck, the test TypeScript compile, and Jest.
+- `npm run lint` checks the Oxlint and Oxfmt baselines.
+- `npm run test` runs the manual-code typecheck and Vitest.
 - `npm run build` creates the distributable package under `dist/`.
-- `npm run validate:package` builds the package, validates the packaged manifest, and smoke-tests the packed tarball.
+- `npm run validate:package` builds the package, runs package-shape validation, and smoke-tests the packed tarball.
 
 ### Generated code workflow
 
@@ -44,7 +44,7 @@ The tooling architecture and generator rationale are documented in [tools/README
 
 ### Browser examples
 
-The package still ships a standalone browser bundle for direct script usage. To build the bundle and open the browser examples locally:
+The package ships browser examples for both the native ESM build and the standalone UMD bundle. To build the package and open the browser examples locally:
 
 ```sh
 npm run serve

.prettierrc.js

@@ -30,7 +30,7 @@ With this SDK, you can:
 - Parse workflow definitions in JSON and YAML formats
 - Programmatically build workflow definitions
 - Validate workflow definitions
-- Consume the SDK from Node.js runtimes and modern browsers, including a standalone browser bundle
+- Consume the SDK from Node.js runtimes and modern browsers through CommonJS, native ESM, and a standalone UMD bundle
 
 ## Status
 
@@ -369,7 +369,7 @@ flowchart TD
 classDef hidden width: 1px, height: 0px, opacity: 0;
 ```
 
-You can refer to the Mermaid browser example for a live demo. The top-level [`examples/browser`](./examples/browser) samples use native ESM imports, while the legacy standalone bundle samples are preserved under [`examples/browser/umd`](./examples/browser/umd).
+You can refer to the Mermaid browser examples for a live demo. The browser samples under [`examples/browser`](./examples/browser) include native ESM examples and legacy UMD-global examples under [`examples/browser/umd`](./examples/browser/umd).
 
 ### Building Locally
 
@@ -384,13 +384,13 @@ npm run test
 npm run validate:package
 ```
 
-You can also build the standalone browser bundle and run the browser examples by executing:
+You can also build the package and run the browser examples by executing:
 
 ```sh
 npm run serve
 ```
 
-This serves the ESM-first examples in [`examples/browser`](./examples/browser). If you want to compare them with the legacy standalone bundle usage, open the matching files under [`examples/browser/umd`](./examples/browser/umd).
+This serves the browser examples in [`examples/browser`](./examples/browser), including both native ESM samples and UMD-global samples in [`examples/browser/umd`](./examples/browser/umd).
 
 Generated files live under `src/lib/generated/` and should be refreshed with:
 

CONTRIBUTING.md

@@ -6,6 +6,6 @@
 4. Run `npm run test`.
 5. Run `npm run validate:package`.
 6. Run `npm run codegen:check` if generator or schema inputs changed.
-7. Review the packed `dist/package.json` and confirm the public API shape is unchanged for `1.x`.
-8. Update release notes with any consumer-facing packaging, runtime, or migration details.
+7. Review the packed `dist/package.json` and confirm the documented `import`, `require`, `browser`, and `types` entrypoints are correct.
+8. Update release notes with any consumer-facing packaging, runtime, or migration details, especially browser ESM and UMD guidance.
 9. Create the GitHub release tag and let the publish workflow release from CI.

README.md

@@ -13,7 +13,7 @@
     <div id="diagram-container"></div>
     <pre id="output"></pre>
     <script type="module">
-      import { Classes, convertToMermaidCode } from '../../dist/esm/index.js';
+      import { Classes, convertToMermaidCode } from '../../dist/index.mjs';
       import mermaid from 'https://cdn.jsdelivr.net/npm/mermaid@11/dist/mermaid.esm.min.mjs';
 
       (async () => {