@kismet-ux/constellation 1.0.0

package/vite-plugin.mjs

@@ -0,0 +1,95 @@
+import { resolve } from 'node:path';
+import { existsSync, readFileSync } from 'node:fs';
+import { loadEnv } from 'vite';
+
+/**
+ * Vite plugin for local Constellation development.
+ *
+ * Auto-generates resolve aliases from Constellation's package.json exports so
+ * consuming apps don't need to maintain a manual alias list.
+ *
+ * @param {object} [options]
+ * @param {boolean} [options.enabled] - Force enable/disable. Defaults to reading CONSTELLATION_LOCAL env var.
+ * @param {string}  [options.root]    - Explicit path to local Constellation checkout.
+ * @returns {import('vite').Plugin}
+ */
+export default function constellationLocal(options = {}) {
+  let constellationRoot;
+  let enabled;
+  let aliases;
+
+  return {
+    name: 'constellation-local',
+    enforce: 'pre',
+
+    config(_, { mode }) {
+      // Load all env vars (including unprefixed) so .env CONSTELLATION_LOCAL is visible
+      const env = loadEnv(mode, process.cwd(), '');
+
+      // Determine whether the plugin is enabled
+      enabled = options.enabled ?? ((env.CONSTELLATION_LOCAL ?? process.env.CONSTELLATION_LOCAL) === 'true');
+      if (!enabled) {
+        return { define: { __CONSTELLATION_LOCAL__: false } };
+      }
+
+      // Resolve the constellation root directory
+      if (options.root) {
+        constellationRoot = resolve(options.root);
+      } else {
+        const candidates = [
+          resolve(process.cwd(), '../@kismet-ux/constellation'),
+          resolve(process.cwd(), '../constellation'),
+          resolve(process.cwd(), 'constellation'),
+        ];
+        constellationRoot = candidates.find(p => existsSync(resolve(p, 'dist')));
+      }
+
+      if (!constellationRoot || !existsSync(resolve(constellationRoot, 'dist'))) {
+        console.warn(
+          '[constellation-local] CONSTELLATION_LOCAL is set but no local Constellation dist found. Falling back to node_modules.'
+        );
+        return { define: { __CONSTELLATION_LOCAL__: false } };
+      }
+
+      // Read package.json exports from local checkout (not the installed copy)
+      const pkgPath = resolve(constellationRoot, 'package.json');
+      const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+      const exports = pkg.exports || {};
+
+      // Build alias entries from exports (skip wildcard patterns)
+      aliases = [];
+      for (const [key, conditions] of Object.entries(exports)) {
+        if (key.includes('*')) continue;
+
+        const name =
+          key === '.' ? pkg.name : `${pkg.name}/${key.replace(/^\.\//, '')}`;
+
+        const target =
+          conditions.import ?? conditions.default ?? null;
+        if (!target) continue;
+
+        aliases.push({
+          find: name,
+          replacement: resolve(constellationRoot, target),
+        });
+      }
+
+      // Sort longest-first so specific paths match before the catch-all
+      aliases.sort((a, b) => b.find.length - a.find.length);
+
+      console.log(
+        `[constellation-local] Enabled with root: ${constellationRoot} (${aliases.length} aliases)`
+      );
+
+      return {
+        define: { __CONSTELLATION_LOCAL__: true },
+        resolve: { alias: aliases },
+        server: {
+          fs: {
+            allow: [constellationRoot],
+          },
+        },
+      };
+    },
+  };
+}