@baybreezy/docd 0.0.12 → 0.1.1

package/app/app.config.ts

@@ -202,6 +202,14 @@ export type DocdConfig = {
      * The color mode to use for the site by default.
      */
     colorMode?: "light" | "dark";
+    /**
+     * Controls which collapsible sections in the navigation sidebar are expanded by default.
+     *
+     * - `true`: expand all collapsibles
+     * - `number`: expand the collapsible at this 1-based position (e.g. `2` = second group)
+     * - `number[]`: expand collapsibles at these 1-based positions (e.g. `[2, 3]` = second and third groups)
+     */
+    expandNav?: true | number | number[];
     /**
      * Page transition configuration. Set `name` to `"none"` to disable transitions entirely.
      *

package/app/components/docs/DocsNav.vue

@@ -50,7 +50,7 @@
         <!-- Collapsible item -->
         <UiCollapsible
           v-else
-          :default-open="route.path.includes(group.item.path)"
+          :default-open="isDefaultOpen(group.item, gi)"
           class="flex flex-col border-b pb-4"
           :class="[
             isDashed ? 'border-dashed' : '',
@@ -76,7 +76,12 @@
             <div
               class="relative pt-1 pl-8 before:absolute before:left-2 before:h-[calc(100%-23px)] before:w-px before:bg-border dark:before:bg-accent"
             >
-              <DocsNav class="gap-4 first:mt-2" :items="group.item.children!" :nested="true" />
+              <DocsNav
+                class="gap-4 first:mt-2"
+                :items="group.item.children!"
+                :nested="true"
+                :depth="(props.depth ?? 1) + 1"
+              />
             </div>
           </UiCollapsibleContent>
         </UiCollapsible>
@@ -127,10 +132,26 @@
   const props = defineProps<{
     items: ContentNavigationItem[];
     nested?: boolean;
+    depth?: number;
   }>();
 
   const route = useRoute();
   const { isDashed } = useDocd();
+  const expandNav = useUIConfig("expandNav");
+
+  function isDefaultOpen(item: ContentNavigationItem, gi: number): boolean {
+    if (route.path.includes(item.path)) return true;
+    const cfg = expandNav.value;
+    if (cfg === true) return true;
+    // 1-based index among collapsible groups only
+    let collapsibleIdx = 0;
+    for (let i = 0; i <= gi; i++) {
+      if (groups.value[i]?.type === "collapsible") collapsibleIdx++;
+    }
+    if (typeof cfg === "number") return collapsibleIdx === cfg;
+    if (Array.isArray(cfg)) return cfg.includes(collapsibleIdx);
+    return false;
+  }
 
   type Group =
     | { type: "flat"; items: ContentNavigationItem[] }

package/app/composables/useUIConfig.ts

@@ -17,6 +17,7 @@ interface DocdUIMap {
   borderType: BorderType;
   transition: DocdTransitionConfig;
   extraLinks: DocdExtraLink[];
+  expandNav: true | number | number[] | undefined;
 }
 
 export function useUIConfig<K extends keyof DocdUIMap>(section: K): ComputedRef<DocdUIMap[K]> {
@@ -33,4 +34,5 @@ const defaultValues: DocdUIMap = {
   borderType: "dashed",
   transition: { name: "fade", duration: 0.35, easing: "easeOut" },
   extraLinks: [],
+  expandNav: undefined,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@baybreezy/docd",
-  "version": "0.0.12",
+  "version": "0.1.1",
   "description": "A Nuxt layer for building documentation sites with UI Thing.",
   "repository": {
     "type": "git",
@@ -31,16 +31,16 @@
   },
   "dependencies": {
     "@baybreezy/file-extension-icon": "^0.0.4",
-    "@iconify-json/lucide": "^1.2.103",
-    "@iconify-json/material-icon-theme": "^1.2.60",
-    "@iconify-json/simple-icons": "^1.2.79",
+    "@iconify-json/lucide": "^1.2.105",
+    "@iconify-json/material-icon-theme": "^1.2.62",
+    "@iconify-json/simple-icons": "^1.2.80",
     "@iconify/utils": "^3.1.1",
     "@morev/vue-transitions": "^3.0.5",
     "@nuxt/content": "3.13.0",
     "@nuxt/fonts": "^0.14.0",
     "@nuxt/icon": "^2.2.1",
     "@nuxt/image": "2.0.0",
-    "@nuxt/kit": "^4.4.2",
+    "@nuxt/kit": "^4.4.4",
     "@nuxtjs/color-mode": "^4.0.0",
     "@nuxtjs/mcp-toolkit": "^0.14.0",
     "@nuxtjs/mdc": "^0.21.1",
@@ -49,8 +49,8 @@
     "@tailwindcss/typography": "^0.5.19",
     "@tailwindcss/vite": "^4.2.4",
     "@takumi-rs/core": "^1.1.2",
-    "@vueuse/core": "^14.2.1",
-    "@vueuse/nuxt": "^14.2.1",
+    "@vueuse/core": "^14.3.0",
+    "@vueuse/nuxt": "^14.3.0",
     "better-sqlite3": "^12.9.0",
     "defu": "^6.1.7",
     "git-url-parse": "^16.1.0",
@@ -60,23 +60,23 @@
     "nuxt-component-meta": "^0.17.2",
     "nuxt-gtag": "4.1.0",
     "nuxt-llms": "^0.2.0",
-    "nuxt-og-image": "^6.4.8",
-    "pkg-types": "^2.3.0",
+    "nuxt-og-image": "^6.4.9",
+    "pkg-types": "^2.3.1",
     "reka-ui": "^2.9.6",
     "shiki": "^4.0.2",
     "tailwind-merge": "^3.5.0",
     "tailwind-variants": "^3.2.2",
     "tailwindcss": "^4.2.4",
     "tw-animate-css": "^1.4.0",
-    "ufo": "^1.6.3",
+    "ufo": "^1.6.4",
     "vaul-vue": "^0.4.1",
     "vue-sonner": "^2.0.9",
     "yaml": "^2.8.3",
-    "zod": "^4.3.6"
+    "zod": "^4.4.1"
   },
   "devDependencies": {
     "@types/lodash-es": "^4.17.12",
-    "nuxt": "^4.4.2",
+    "nuxt": "^4.4.4",
     "typescript": "^6.0.3",
     "vue": "latest",
     "vue-router": "^5.0.6"