@nuasite/nua 0.0.56 → 0.0.57

package/README.md

@@ -29,44 +29,66 @@ same toolchain will execute locally.
 
 ## Usage
 
-Add the unified Astro integration to your `astro.config.mjs`:
+Use the nua config wrapper for the simplest setup:
 
-```js
-// astro.config.mjs
-import nua from '@nuasite/nua/integration'
-import { defineConfig } from 'astro/config'
+```ts
+// astro.config.ts
+import { defineConfig } from '@nuasite/nua/config'
 
-export default defineConfig({
-	integrations: [nua()],
-})
+export default defineConfig()
 ```
 
-This single integration enables Tailwind CSS, MDX, sitemap generation,
-CMS markers, and page markdown output—all pre-configured.
+This single line gives you:
+
+- Tailwind CSS 4 via `@tailwindcss/vite`
+- MDX support via `@astrojs/mdx`
+- Sitemap generation via `@astrojs/sitemap`
+- CMS markers via `@nuasite/cms-marker`
+- Page markdown output via `@nuasite/page-markdown`
+- Sensible defaults: `site: 'http://localhost:4321'`, `vite.build.sourcemap: true`
 
 ### Configuration options
 
-Each sub-integration can be disabled or customized:
+Pass standard Astro config options, plus a `nua` key for integration settings:
+
+```ts
+import { defineConfig } from '@nuasite/nua/config'
 
-```js
 export default defineConfig({
-	integrations: [
-		nua({
-			tailwindcss: true, // Enable/disable Tailwind CSS (default: true)
-			mdx: true, // Enable/disable MDX support (default: true)
-			sitemap: true, // Enable/disable sitemap generation (default: true)
-			cmsMarker: true, // Enable/disable CMS markers (default: true)
-			pageMarkdown: true, // Enable/disable page markdown output (default: true)
-		}),
-	],
+	site: 'https://example.com',
+	nua: {
+		tailwindcss: true, // Enable/disable Tailwind CSS (default: true)
+		mdx: true, // Enable/disable MDX support (default: true)
+		sitemap: true, // Enable/disable sitemap generation (default: true)
+		cmsMarker: true, // Enable/disable CMS markers (default: true)
+		pageMarkdown: true, // Enable/disable page markdown output (default: true)
+	},
 })
 ```
 
 Pass `false` to disable a feature, or pass an options object to customize it:
 
-```js
-nua({
-	sitemap: { filter: (page) => !page.includes('/draft/') },
-	mdx: { remarkPlugins: [myRemarkPlugin] },
+```ts
+import { defineConfig } from '@nuasite/nua/config'
+
+export default defineConfig({
+	nua: {
+		sitemap: { filter: (page) => !page.includes('/draft/') },
+		mdx: { remarkPlugins: [myRemarkPlugin] },
+	},
+})
+```
+
+### Using the integration directly
+
+If you prefer more control, import the integration separately:
+
+```ts
+// astro.config.ts
+import nua from '@nuasite/nua/integration'
+import { defineConfig } from 'astro/config'
+
+export default defineConfig({
+	integrations: [nua()],
 })
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nuasite/nua",
-  "version": "0.0.56",
+  "version": "0.0.57",
   "type": "module",
   "license": "Apache-2.0",
   "module": "src/index.ts",
@@ -10,6 +10,10 @@
       "types": "./src/index.ts",
       "import": "./src/index.ts"
     },
+    "./config": {
+      "types": "./src/config.ts",
+      "import": "./src/config.ts"
+    },
     "./integration": {
       "types": "./src/integration.ts",
       "import": "./src/integration.ts"
@@ -35,11 +39,11 @@
     "@astrojs/mdx": "4.3.8",
     "@astrojs/rss": "4.0.13",
     "@astrojs/sitemap": "3.6.0",
-    "@nuasite/page-markdown": "0.0.56",
-    "@nuasite/cli": "0.0.56",
-    "@nuasite/cms-marker": "0.0.56",
-    "@nuasite/components": "0.0.56",
-    "@nuasite/core": "0.0.56",
+    "@nuasite/page-markdown": "0.0.57",
+    "@nuasite/cli": "0.0.57",
+    "@nuasite/cms-marker": "0.0.57",
+    "@nuasite/components": "0.0.57",
+    "@nuasite/core": "0.0.57",
     "@tailwindcss/vite": "^4.1.11",
     "astro": "^5.16.6",
     "flowbite": "3.1.2",

package/src/config.ts

@@ -0,0 +1,69 @@
+import { defineConfig as astroDefineConfig } from 'astro/config'
+import type { AstroUserConfig } from 'astro/config'
+import nua from './integration'
+import type { NuaIntegrationOptions } from './types'
+
+export type { NuaIntegrationOptions } from './types'
+
+export interface NuaConfig extends AstroUserConfig {
+	/**
+	 * Configure the nua integration options.
+	 * Set to `false` to disable the nua integration entirely.
+	 */
+	nua?: NuaIntegrationOptions | false
+}
+
+/**
+ * Wrapper around Astro's `defineConfig` with nua integration pre-configured.
+ *
+ * @example
+ * ```ts
+ * // astro.config.ts
+ * import { defineConfig } from '@nuasite/nua/config'
+ *
+ * export default defineConfig({
+ *   site: 'https://example.com',
+ * })
+ * ```
+ *
+ * @example
+ * ```ts
+ * // With nua options
+ * import { defineConfig } from '@nuasite/nua/config'
+ *
+ * export default defineConfig({
+ *   site: 'https://example.com',
+ *   nua: {
+ *     sitemap: false,
+ *     tailwindcss: true,
+ *   },
+ * })
+ * ```
+ */
+export function defineConfig(config: NuaConfig = {}) {
+	const { nua: nuaOptions, integrations = [], vite = {}, ...astroConfig } = config
+
+	const mergedVite = {
+		...vite,
+		build: {
+			sourcemap: true,
+			...vite.build,
+		},
+	}
+
+	const defaults = {
+		site: 'http://localhost:4321',
+		vite: mergedVite,
+	}
+
+	// If nua is explicitly disabled, just pass through to Astro
+	if (nuaOptions === false) {
+		return astroDefineConfig({ ...defaults, ...astroConfig, integrations })
+	}
+
+	return astroDefineConfig({
+		...defaults,
+		...astroConfig,
+		integrations: [nua(nuaOptions), ...integrations],
+	})
+}