@nuasite/nua 0.0.52 → 0.0.54

package/README.md

@@ -26,3 +26,47 @@ This ensures every developer machine and CI job installs the same stack that
 Nua Site uses when publishing your project. After installing, run your normal
 build command (for example `bunx nua-build` or `bun run build`) and the exact
 same toolchain will execute locally.
+
+## Usage
+
+Add the unified Astro integration to your `astro.config.mjs`:
+
+```js
+// astro.config.mjs
+import nua from '@nuasite/nua/integration'
+import { defineConfig } from 'astro/config'
+
+export default defineConfig({
+	integrations: [nua()],
+})
+```
+
+This single integration enables Tailwind CSS, MDX, sitemap generation,
+CMS markers, and page markdown output—all pre-configured.
+
+### Configuration options
+
+Each sub-integration can be disabled or customized:
+
+```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)
+		}),
+	],
+})
+```
+
+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] },
+})
+```

package/package.json

@@ -1,7 +1,20 @@
 {
   "name": "@nuasite/nua",
-  "version": "0.0.52",
+  "version": "0.0.54",
+  "type": "module",
   "license": "Apache-2.0",
+  "module": "src/index.ts",
+  "types": "src/index.ts",
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "import": "./src/index.ts"
+    },
+    "./integration": {
+      "types": "./src/integration.ts",
+      "import": "./src/integration.ts"
+    }
+  },
   "files": [
     "dist/**",
     "src/**",
@@ -22,10 +35,11 @@
     "@astrojs/mdx": "4.3.8",
     "@astrojs/rss": "4.0.13",
     "@astrojs/sitemap": "3.6.0",
-    "@nuasite/cli": "0.0.52",
-    "@nuasite/cms-marker": "0.0.52",
-    "@nuasite/components": "0.0.52",
-    "@nuasite/core": "0.0.52",
+    "@nuasite/page-markdown": "0.0.54",
+    "@nuasite/cli": "0.0.54",
+    "@nuasite/cms-marker": "0.0.54",
+    "@nuasite/components": "0.0.54",
+    "@nuasite/core": "0.0.54",
     "@tailwindcss/vite": "^4.1.11",
     "astro": "^5.16.6",
     "flowbite": "3.1.2",

package/src/index.ts

@@ -0,0 +1,2 @@
+export { default, default as nua } from './integration'
+export type { CmsMarkerOptions, MdxOptions, NuaIntegrationOptions, PageMarkdownOptions, ResolvedIntegrationOptions, SitemapOptions } from './types'

package/src/integration.ts

@@ -0,0 +1,57 @@
+import mdx from '@astrojs/mdx'
+import sitemap from '@astrojs/sitemap'
+import cmsMarker from '@nuasite/cms-marker'
+import pageMarkdown from '@nuasite/page-markdown'
+import tailwindcss from '@tailwindcss/vite'
+import type { AstroIntegration } from 'astro'
+import { type NuaIntegrationOptions, resolveOptions } from './types'
+
+export default function nua(options: NuaIntegrationOptions = {}): AstroIntegration {
+	const resolved = resolveOptions(options)
+
+	return {
+		name: '@nuasite/nua',
+		hooks: {
+			'astro:config:setup': ({ updateConfig, logger }) => {
+				const integrations: AstroIntegration[] = []
+				const vitePlugins: unknown[] = []
+
+				// Add Tailwind CSS Vite plugin
+				if (resolved.tailwindcss) {
+					vitePlugins.push(tailwindcss())
+					logger.info('Tailwind CSS enabled')
+				}
+
+				// Add nuasite integrations
+				if (resolved.cmsMarker !== false) {
+					integrations.push(cmsMarker(resolved.cmsMarker))
+					logger.info('CMS Marker enabled')
+				}
+
+				if (resolved.pageMarkdown !== false) {
+					integrations.push(pageMarkdown(resolved.pageMarkdown))
+					logger.info('Page Markdown enabled')
+				}
+
+				// Add official Astro integrations
+				if (resolved.mdx !== false) {
+					integrations.push(mdx(resolved.mdx))
+					logger.info('MDX enabled')
+				}
+
+				if (resolved.sitemap !== false) {
+					integrations.push(sitemap(resolved.sitemap))
+					logger.info('Sitemap enabled')
+				}
+
+				// Inject Vite plugins and integrations
+				updateConfig({
+					vite: {
+						plugins: vitePlugins,
+					},
+					integrations,
+				})
+			},
+		},
+	}
+}

package/src/types.ts

@@ -0,0 +1,49 @@
+import type { Options as MdxOptions } from '@astrojs/mdx'
+import type { SitemapOptions } from '@astrojs/sitemap'
+import type { CmsMarkerOptions } from '@nuasite/cms-marker'
+import type { PageMarkdownOptions } from '@nuasite/page-markdown'
+
+export type { Options as MdxOptions } from '@astrojs/mdx'
+export type { SitemapOptions } from '@astrojs/sitemap'
+export type { CmsMarkerOptions } from '@nuasite/cms-marker'
+export type { PageMarkdownOptions } from '@nuasite/page-markdown'
+
+export interface NuaIntegrationOptions {
+	/** Enable/disable or configure @nuasite/cms-marker (default: true) */
+	cmsMarker?: boolean | CmsMarkerOptions
+	/** Enable/disable or configure @nuasite/page-markdown (default: true) */
+	pageMarkdown?: boolean | PageMarkdownOptions
+	/** Enable/disable or configure @astrojs/mdx (default: true) */
+	mdx?: boolean | MdxOptions
+	/** Enable/disable or configure @astrojs/sitemap (default: true) */
+	sitemap?: boolean | SitemapOptions
+	/** Enable/disable @tailwindcss/vite plugin (default: true) */
+	tailwindcss?: boolean
+}
+
+export interface ResolvedIntegrationOptions {
+	cmsMarker: CmsMarkerOptions | false
+	pageMarkdown: PageMarkdownOptions | false
+	mdx: MdxOptions | false
+	sitemap: SitemapOptions | false
+	tailwindcss: boolean
+}
+
+/**
+ * Resolves a boolean | Options value to Options | false
+ */
+function resolveOption<T extends object>(value: boolean | T | undefined, defaultOptions: T = {} as T): T | false {
+	if (value === false) return false
+	if (value === true || value === undefined) return defaultOptions
+	return value
+}
+
+export function resolveOptions(options: NuaIntegrationOptions = {}): ResolvedIntegrationOptions {
+	return {
+		cmsMarker: resolveOption(options.cmsMarker),
+		pageMarkdown: resolveOption(options.pageMarkdown),
+		mdx: resolveOption(options.mdx),
+		sitemap: resolveOption(options.sitemap),
+		tailwindcss: options.tailwindcss !== false,
+	}
+}