@theholocron/astro-config 7.8.0 → 7.9.0

package/README.md

@@ -5,36 +5,44 @@ An [Astro configuration](https://docs.astro.build/en/reference/configuration-ref
 ## Installation
 
 ```bash
-npm install --save-dev @theholocron/astro-config
+pnpm add -D @theholocron/astro-config
 ```
 
 ## Usage
 
-Replace `astro/config`'s `defineConfig` with this package's `defineConfig` and pass a `docs` config object and `importMetaUrl`:
+Pass `starlight` and `docsTheme` from your own imports alongside the docs config. This keeps Astro's module loader in control of those framework imports:
 
 ```ts
 // astro.config.ts
+import starlight from "@astrojs/starlight";
+import { docsTheme } from "@theholocron/docs-theme";
 import { defineConfig } from "@theholocron/astro-config";
 import clientsConfig from "@theholocron/clients-docs";
 
 export default defineConfig({
-  docs: clientsConfig,
-  importMetaUrl: import.meta.url,
+	docs: clientsConfig,
+	importMetaUrl: import.meta.url,
+	starlight,
+	docsTheme,
 });
 ```
 
 ### Custom sidebar label
 
-By default the sidebar group label is derived from `docs.sidebar[1].label`. Override it when the group label in the docs config differs from what the site should show:
+By default the sidebar group label is derived from `docs.sidebar[1].label`. Override it when the label differs:
 
 ```ts
+import starlight from "@astrojs/starlight";
+import { docsTheme } from "@theholocron/docs-theme";
 import { defineConfig } from "@theholocron/astro-config";
 import holocronConfig from "@theholocron/holocron-docs";
 
 export default defineConfig({
-  docs: holocronConfig,
-  importMetaUrl: import.meta.url,
-  sidebarLabel: "Reference",
+	docs: holocronConfig,
+	importMetaUrl: import.meta.url,
+	starlight,
+	docsTheme,
+	sidebarLabel: "Reference",
 });
 ```
 

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+import starlight from "@astrojs/starlight";
+import { docsTheme } from "@theholocron/docs-theme";
 //#region index.d.ts
 interface DocsConfig {
   slug: string;
@@ -13,8 +15,10 @@ interface DocsConfig {
 interface DocsConfigInput {
   docs: DocsConfig;
   importMetaUrl: string;
+  starlight: typeof starlight;
+  docsTheme: typeof docsTheme;
   sidebarLabel?: string;
 }
-declare function defineConfig({ docs, importMetaUrl, sidebarLabel }: DocsConfigInput): import("astro").AstroUserConfig<never, never, never>;
+declare function defineConfig({ docs, importMetaUrl, starlight, docsTheme, sidebarLabel }: DocsConfigInput): import("astro").AstroUserConfig<never, never, never>;
 //#endregion
 export { DocsConfig, DocsConfigInput, defineConfig };

package/dist/index.js

@@ -1,10 +1,8 @@
 import { relative } from "node:path";
 import { fileURLToPath } from "node:url";
-import starlight from "@astrojs/starlight";
-import { docsTheme } from "@theholocron/docs-theme";
 import { defineConfig as defineConfig$1 } from "astro/config";
 //#region index.ts
-function defineConfig({ docs, importMetaUrl, sidebarLabel }) {
+function defineConfig({ docs, importMetaUrl, starlight, docsTheme, sidebarLabel }) {
 	const contentRelDir = relative(fileURLToPath(new URL(".", importMetaUrl)), fileURLToPath(new URL(`../packages/${docs.slug}-docs/content`, importMetaUrl)));
 	const secondItem = docs.sidebar[1];
 	const defaultLabel = secondItem !== void 0 && "items" in secondItem ? secondItem.label : "Contents";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theholocron/astro-config",
-  "version": "7.8.0",
+  "version": "7.9.0",
   "description": "Astro configuration factory for theholocron docs sites.",
   "keywords": [
     "astro",
@@ -31,18 +31,16 @@
     "dist/"
   ],
   "devDependencies": {
-    "@astrojs/starlight": "^0.41.5",
+    "@astrojs/starlight": "^0.41.6",
     "@theholocron/docs-theme": "^1.2.2",
     "@vitest/coverage-v8": "^4.1.10",
     "astro": "^7.1.5",
     "tsdown": "^0.22.14",
     "typescript": "^5.9.3",
     "vitest": "^4.1.10",
-    "@theholocron/tsconfig": "7.8.0"
+    "@theholocron/tsconfig": "7.9.0"
   },
   "peerDependencies": {
-    "@astrojs/starlight": ">=0.30.0",
-    "@theholocron/docs-theme": ">=1.2.2",
     "astro": ">=5.0.0"
   },
   "engines": {
@@ -56,6 +54,7 @@
   "scripts": {
     "build": "tsdown",
     "test": "vitest run",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit",
+    "test:coverage": "vitest run --coverage"
   }
 }