astro-cljs-plugin 0.0.1

package/README.md

@@ -0,0 +1,42 @@
+# astro-cljs-plugin
+
+Zero-config ClojureScript integration for Astro.
+
+## Features
+- **Zero Config**: Automatically discovers and exports components from your `.cljs` files. No manual `:exports` required in `shadow-cljs.edn`.
+- **React-Powered**: Works seamlessly with [UIX](https://github.com/pitch-io/uix) and [Helix](https://github.com/lilactown/helix).
+- **Bundled Engine**: Internally bundles and manages the [shadow-cljs-vite-plugin](https://github.com/sean/clj-astro/tree/main/packages/shadow-cljs-vite-plugin) for a unified experience.
+
+## Prerequisites
+This integration **requires** the `@astrojs/react` plugin to be installed and configured in your Astro project to handle the underlying React rendering.
+
+## Installation
+```bash
+npm install astro-cljs-plugin
+```
+
+## Usage
+Add the integration to your `astro.config.mjs`:
+
+```js
+import { defineConfig } from 'astro/config';
+import react from '@astrojs/react';
+import cljs from 'astro-cljs-plugin';
+
+export default defineConfig({
+  integrations: [
+    react(), 
+    cljs({
+      buildIds: ['app']
+    })
+  ]
+});
+```
+
+## Configuration Options
+
+| Option | Type | Default | Description |
+| :--- | :--- | :--- | :--- |
+| `debug` | `boolean` | `false` | Enable verbose logging for the integration and Vite plugin. |
+| `buildIds` | `string[]` | `['app']` | The shadow-cljs build IDs defined in your config to watch/build. |
+| `configPath` | `string` | `'./shadow-cljs.edn'` | Path to your shadow-cljs configuration file. |

package/dist/index.d.ts

@@ -0,0 +1,41 @@
+import { AstroIntegration } from 'astro';
+import { Plugin } from 'vite';
+import { ShadowCljsOptions } from 'shadow-cljs-vite-plugin';
+
+interface ClojurePluginOptions {
+    debug?: boolean;
+    buildId?: string;
+}
+/**
+ * Vite plugin to handle .cljs file imports
+ */
+declare function clojurePlugin(options?: ClojurePluginOptions): Plugin;
+
+interface ClojureIntegrationOptions extends ClojurePluginOptions, Partial<ShadowCljsOptions> {
+    /**
+     * Enable debug logging
+     */
+    debug?: boolean;
+}
+/**
+ * Astro integration for ClojureScript support
+ *
+ * This works alongside shadow-cljs-vite-plugin:
+ * - shadow-cljs-vite-plugin manages shadow-cljs compilation and provides virtual modules
+ * - This plugin transforms .cljs imports into React wrappers that use those modules
+ *
+ * Prerequisites:
+ * - shadow-cljs.edn must have builds for SSR and client
+ *
+ * @example
+ * ```astro
+ * ---
+ * import MyComponent from '../components/MyComponent.cljs';
+ * ---
+ *
+ * <MyComponent client:load />
+ * ```
+ */
+declare function clojureIntegration(options?: ClojureIntegrationOptions): AstroIntegration;
+
+export { type ClojureIntegrationOptions, type ClojurePluginOptions, clojurePlugin, clojureIntegration as default };