@baybreezy/docd 0.0.11 → 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/content/prose/ProsePre.global.vue

@@ -59,11 +59,15 @@
      * Optional icon name to display next to the filename
      */
     icon?: string;
+    /**
+     * Format the filename: strip the file extension and apply title case
+     */
+    format?: boolean;
   }>();
 
   /**
    * Parse meta string and create a lowercase key map for easy checking
-   * Example: "noFormat hideHeader icon='lucide:code'" => Map { 'noformat' => true, 'hideheader' => true, 'icon' => 'lucide:code' }
+   * Example: "format hideHeader icon='lucide:code'" => Map { 'format' => true, 'hideheader' => true, 'icon' => 'lucide:code' }
    */
   const metaMap = computed(() => {
     const map = new Map<string, string | boolean>();
@@ -90,7 +94,7 @@
   });
 
   const hideCopyButton = ref(false);
-  const noFormatMeta = computed(() => metaMap.value.has("noformat"));
+  const formatMeta = computed(() => metaMap.value.has("format"));
   const hideHeaderMeta = computed(
     () => metaMap.value.has("hideheader") || metaMap.value.has("noheader")
   );
@@ -107,7 +111,7 @@
 
   const fileNameEdited = computed(() => {
     if (!props.filename) return;
-    if (noFormatMeta.value) return props.filename;
+    if (!props.format && !formatMeta.value) return props.filename;
 
     let processedName = props.filename;
 

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/useDocPage.ts

@@ -10,7 +10,7 @@ export const useDocPage = async () => {
 
   const [{ data: page }, { data: surround }, { data: navigation }] = await Promise.all([
     useAsyncData(
-      kebabCase(route.path),
+      kebabCase(route.path) || "root",
       () =>
         isLandingRoute
           ? queryCollection("landing" as keyof Collections)
@@ -22,7 +22,7 @@ export const useDocPage = async () => {
       { watch: [() => route.path] }
     ),
     useAsyncData(
-      `${kebabCase(route.path)}-surround`,
+      `${kebabCase(route.path) || "root"}-surround`,
       () => {
         if (isLandingRoute) {
           return Promise.resolve(null);

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