vite-plugin-veloz 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Julio Carneiro and Veloz contributors
+
+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

@@ -1,3 +1,18 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# vite-plugin-veloz
+
+Vite plugin for [Veloz](https://github.com/juliocarneiro/veloz): configures JSX for `@velozjs/dom`, and during SSR (dev `ssrLoadModule` and `vite build --ssr`) resolves your app's imports of `@velozjs/dom` to `@velozjs/ssr`, so the same components render to HTML.
+
+```bash
+npm install -D vite-plugin-veloz
+```
+
+```ts
+import { defineConfig } from 'vite';
+import veloz from 'vite-plugin-veloz';
+
+export default defineConfig({ plugins: [veloz()] });
+```
+
+Option: `exclude`, package names whose imports of `@velozjs/dom` should not be redirected during SSR (packages named `@velozjs/*` are always left alone).
+
+Documentation and the other packages: [github.com/juliocarneiro/veloz](https://github.com/juliocarneiro/veloz). MIT license.

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+import { Plugin } from 'vite';
+
+interface VelozPluginOptions {
+    /**
+     * Package names whose imports of `@velozjs/dom` are left alone during SSR.
+     * Packages named `@velozjs/*` are always excluded.
+     */
+    exclude?: string[];
+}
+/**
+ * Veloz for Vite: compiles JSX with the `@velozjs/dom` runtime, and during SSR
+ * (dev `ssrLoadModule` and `vite build --ssr`) resolves app imports of
+ * `@velozjs/dom` to `@velozjs/ssr`, so the same components render to HTML.
+ */
+declare function velozPlugin(options?: VelozPluginOptions): Plugin;
+
+export { type VelozPluginOptions, velozPlugin as default, velozPlugin };

package/dist/index.js

@@ -0,0 +1,66 @@
+import { existsSync, readFileSync } from 'fs';
+import { dirname, join } from 'path';
+
+// src/index.ts
+var SSR_REDIRECTS = {
+  "@velozjs/dom": "@velozjs/ssr",
+  "@velozjs/dom/jsx-runtime": "@velozjs/ssr/jsx-runtime",
+  "@velozjs/dom/jsx-dev-runtime": "@velozjs/ssr/jsx-dev-runtime"
+};
+var packageNameCache = /* @__PURE__ */ new Map();
+function packageNameOf(file) {
+  const path = file.split("?")[0].replace(/^\0/, "");
+  let dir = dirname(path);
+  const visited = [];
+  let name = null;
+  for (; ; ) {
+    const cached = packageNameCache.get(dir);
+    if (cached !== void 0) {
+      name = cached;
+      break;
+    }
+    visited.push(dir);
+    const pkg = join(dir, "package.json");
+    if (existsSync(pkg)) {
+      try {
+        name = JSON.parse(readFileSync(pkg, "utf8")).name ?? null;
+      } catch {
+        name = null;
+      }
+      break;
+    }
+    const parent = dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  for (const d of visited) packageNameCache.set(d, name);
+  return name;
+}
+function velozPlugin(options = {}) {
+  const exclude = new Set(options.exclude ?? []);
+  const isFrameworkModule = (importer) => {
+    if (!importer) return false;
+    const name = packageNameOf(importer);
+    return name != null && (name.startsWith("@velozjs/") || exclude.has(name));
+  };
+  return {
+    name: "vite-plugin-veloz",
+    enforce: "pre",
+    config() {
+      return {
+        esbuild: { jsx: "automatic", jsxImportSource: "@velozjs/dom" },
+        resolve: { dedupe: ["@velozjs/core", "@velozjs/dom", "@velozjs/css", "@velozjs/ssr"] }
+      };
+    },
+    async resolveId(source, importer, resolveOptions) {
+      if (!resolveOptions?.ssr) return null;
+      const target = SSR_REDIRECTS[source];
+      if (!target || isFrameworkModule(importer)) return null;
+      return this.resolve(target, importer, { ...resolveOptions, skipSelf: true });
+    }
+  };
+}
+
+export { velozPlugin as default, velozPlugin };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;;AAaA,IAAM,aAAA,GAAwC;AAAA,EAC5C,cAAA,EAAgB,cAAA;AAAA,EAChB,0BAAA,EAA4B,0BAAA;AAAA,EAC5B,8BAAA,EAAgC;AAClC,CAAA;AAEA,IAAM,gBAAA,uBAAuB,GAAA,EAA2B;AAGxD,SAAS,cAAc,IAAA,EAA6B;AAClD,EAAA,MAAM,IAAA,GAAO,KAAK,KAAA,CAAM,GAAG,EAAE,CAAC,CAAA,CAAE,OAAA,CAAQ,KAAA,EAAO,EAAE,CAAA;AACjD,EAAA,IAAI,GAAA,GAAM,QAAQ,IAAI,CAAA;AACtB,EAAA,MAAM,UAAoB,EAAC;AAC3B,EAAA,IAAI,IAAA,GAAsB,IAAA;AAE1B,EAAA,WAAS;AACP,IAAA,MAAM,MAAA,GAAS,gBAAA,CAAiB,GAAA,CAAI,GAAG,CAAA;AACvC,IAAA,IAAI,WAAW,MAAA,EAAW;AACxB,MAAA,IAAA,GAAO,MAAA;AACP,MAAA;AAAA,IACF;AACA,IAAA,OAAA,CAAQ,KAAK,GAAG,CAAA;AAChB,IAAA,MAAM,GAAA,GAAM,IAAA,CAAK,GAAA,EAAK,cAAc,CAAA;AACpC,IAAA,IAAI,UAAA,CAAW,GAAG,CAAA,EAAG;AACnB,MAAA,IAAI;AACF,QAAA,IAAA,GAAQ,KAAK,KAAA,CAAM,YAAA,CAAa,KAAK,MAAM,CAAC,EAAwB,IAAA,IAAQ,IAAA;AAAA,MAC9E,CAAA,CAAA,MAAQ;AACN,QAAA,IAAA,GAAO,IAAA;AAAA,MACT;AACA,MAAA;AAAA,IACF;AACA,IAAA,MAAM,MAAA,GAAS,QAAQ,GAAG,CAAA;AAC1B,IAAA,IAAI,WAAW,GAAA,EAAK;AACpB,IAAA,GAAA,GAAM,MAAA;AAAA,EACR;AAEA,EAAA,KAAA,MAAW,CAAA,IAAK,OAAA,EAAS,gBAAA,CAAiB,GAAA,CAAI,GAAG,IAAI,CAAA;AACrD,EAAA,OAAO,IAAA;AACT;AAOe,SAAR,WAAA,CAA6B,OAAA,GAA8B,EAAC,EAAW;AAC5E,EAAA,MAAM,UAAU,IAAI,GAAA,CAAI,OAAA,CAAQ,OAAA,IAAW,EAAE,CAAA;AAE7C,EAAA,MAAM,iBAAA,GAAoB,CAAC,QAAA,KAA0C;AACnE,IAAA,IAAI,CAAC,UAAU,OAAO,KAAA;AACtB,IAAA,MAAM,IAAA,GAAO,cAAc,QAAQ,CAAA;AACnC,IAAA,OAAO,IAAA,IAAQ,SAAS,IAAA,CAAK,UAAA,CAAW,WAAW,CAAA,IAAK,OAAA,CAAQ,IAAI,IAAI,CAAA,CAAA;AAAA,EAC1E,CAAA;AAEA,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,mBAAA;AAAA,IACN,OAAA,EAAS,KAAA;AAAA,IAET,MAAA,GAAS;AACP,MAAA,OAAO;AAAA,QACL,OAAA,EAAS,EAAE,GAAA,EAAK,WAAA,EAAa,iBAAiB,cAAA,EAAe;AAAA,QAC7D,OAAA,EAAS,EAAE,MAAA,EAAQ,CAAC,iBAAiB,cAAA,EAAgB,cAAA,EAAgB,cAAc,CAAA;AAAE,OACvF;AAAA,IACF,CAAA;AAAA,IAEA,MAAM,SAAA,CAAU,MAAA,EAAQ,QAAA,EAAU,cAAA,EAAgB;AAChD,MAAA,IAAI,CAAC,cAAA,EAAgB,GAAA,EAAK,OAAO,IAAA;AACjC,MAAA,MAAM,MAAA,GAAS,cAAc,MAAM,CAAA;AACnC,MAAA,IAAI,CAAC,MAAA,IAAU,iBAAA,CAAkB,QAAQ,GAAG,OAAO,IAAA;AACnD,MAAA,OAAO,IAAA,CAAK,QAAQ,MAAA,EAAQ,QAAA,EAAU,EAAE,GAAG,cAAA,EAAgB,QAAA,EAAU,IAAA,EAAM,CAAA;AAAA,IAC7E;AAAA,GACF;AACF","file":"index.js","sourcesContent":["import { existsSync, readFileSync } from 'node:fs';\r\nimport { dirname, join } from 'node:path';\r\nimport type { Plugin } from 'vite';\r\n\r\nexport interface VelozPluginOptions {\r\n  /**\r\n   * Package names whose imports of `@velozjs/dom` are left alone during SSR.\r\n   * Packages named `@velozjs/*` are always excluded.\r\n   */\r\n  exclude?: string[];\r\n}\r\n\r\n/** During SSR, these client modules resolve to their server counterparts. */\r\nconst SSR_REDIRECTS: Record<string, string> = {\r\n  '@velozjs/dom': '@velozjs/ssr',\r\n  '@velozjs/dom/jsx-runtime': '@velozjs/ssr/jsx-runtime',\r\n  '@velozjs/dom/jsx-dev-runtime': '@velozjs/ssr/jsx-dev-runtime',\r\n};\r\n\r\nconst packageNameCache = new Map<string, string | null>();\r\n\r\n/** Name of the nearest package.json above `file` (cached per directory). */\r\nfunction packageNameOf(file: string): string | null {\r\n  const path = file.split('?')[0].replace(/^\\0/, '');\r\n  let dir = dirname(path);\r\n  const visited: string[] = [];\r\n  let name: string | null = null;\r\n\r\n  for (;;) {\r\n    const cached = packageNameCache.get(dir);\r\n    if (cached !== undefined) {\r\n      name = cached;\r\n      break;\r\n    }\r\n    visited.push(dir);\r\n    const pkg = join(dir, 'package.json');\r\n    if (existsSync(pkg)) {\r\n      try {\r\n        name = (JSON.parse(readFileSync(pkg, 'utf8')) as { name?: string }).name ?? null;\r\n      } catch {\r\n        name = null;\r\n      }\r\n      break;\r\n    }\r\n    const parent = dirname(dir);\r\n    if (parent === dir) break;\r\n    dir = parent;\r\n  }\r\n\r\n  for (const d of visited) packageNameCache.set(d, name);\r\n  return name;\r\n}\r\n\r\n/**\r\n * Veloz for Vite: compiles JSX with the `@velozjs/dom` runtime, and during SSR\r\n * (dev `ssrLoadModule` and `vite build --ssr`) resolves app imports of\r\n * `@velozjs/dom` to `@velozjs/ssr`, so the same components render to HTML.\r\n */\r\nexport default function velozPlugin(options: VelozPluginOptions = {}): Plugin {\r\n  const exclude = new Set(options.exclude ?? []);\r\n\r\n  const isFrameworkModule = (importer: string | undefined): boolean => {\r\n    if (!importer) return false;\r\n    const name = packageNameOf(importer);\r\n    return name != null && (name.startsWith('@velozjs/') || exclude.has(name));\r\n  };\r\n\r\n  return {\r\n    name: 'vite-plugin-veloz',\r\n    enforce: 'pre',\r\n\r\n    config() {\r\n      return {\r\n        esbuild: { jsx: 'automatic', jsxImportSource: '@velozjs/dom' },\r\n        resolve: { dedupe: ['@velozjs/core', '@velozjs/dom', '@velozjs/css', '@velozjs/ssr'] },\r\n      };\r\n    },\r\n\r\n    async resolveId(source, importer, resolveOptions) {\r\n      if (!resolveOptions?.ssr) return null;\r\n      const target = SSR_REDIRECTS[source];\r\n      if (!target || isFrameworkModule(importer)) return null;\r\n      return this.resolve(target, importer, { ...resolveOptions, skipSelf: true });\r\n    },\r\n  };\r\n}\r\n\r\nexport { velozPlugin };\r\n"]}

package/package.json

@@ -1,6 +1,56 @@
 {
   "name": "vite-plugin-veloz",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Vite plugin for Veloz: JSX setup and SSR module resolution.",
+  "keywords": [
+    "vite",
+    "vite-plugin",
+    "veloz",
+    "velozjs",
+    "jsx",
+    "ssr"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "peerDependencies": {
+    "vite": ">=5.0.0"
+  },
+  "devDependencies": {
+    "vite": "^7.0.0"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "author": "Julio Carneiro (https://juliocarneiro.dev)",
+  "license": "MIT",
+  "homepage": "https://github.com/juliocarneiro/veloz#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/juliocarneiro/veloz.git",
+    "directory": "packages/vite-plugin"
+  },
+  "bugs": {
+    "url": "https://github.com/juliocarneiro/veloz/issues"
+  },
+  "scripts": {
+    "build": "tsup",
+    "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\""
+  }
 }