@baybreezy/docd 0.0.12 → 0.1.0

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.0",
   "description": "A Nuxt layer for building documentation sites with UI Thing.",
   "repository": {
     "type": "git",