@codedrifters/configulator 0.0.309 → 0.0.310

package/lib/index.d.mts

@@ -10281,9 +10281,22 @@ interface StarlightEditLink {
     readonly baseUrl: string;
 }
 /**
- * Sidebar item accepted by Starlight's `sidebar` config. Covers the four
- * common shapes: link, group with nested items, autogenerated group, and
- * internal slug reference.
+ * Sidebar item accepted by Starlight's `sidebar` config.
+ *
+ * Covers the shapes Starlight 0.39+ accepts:
+ * - link (`{ label, link, badge? }`)
+ * - group with nested items (`{ label, collapsed?, items }`)
+ * - bare autogenerated entry, nested inside a group's `items` array
+ *   (`{ autogenerate: { directory, collapsed? } }`)
+ * - internal slug reference (`{ label, slug }`)
+ *
+ * Plus one legacy shape kept for one deprecation cycle:
+ * - top-level autogenerated group (`{ label, collapsed?, autogenerate }`).
+ *   Starlight v0.39.0 removed runtime support for this shape; the
+ *   `StarlightProject` emitter translates it to the nested form
+ *   `{ label, collapsed?, items: [{ autogenerate }] }` before writing
+ *   `astro.config.mjs`. Migrate to the nested form directly — this
+ *   variant will be removed in a future release.
  */
 type StarlightSidebarItem = {
     readonly label: string;
@@ -10297,6 +10310,12 @@ type StarlightSidebarItem = {
     readonly collapsed?: boolean;
     readonly items: ReadonlyArray<StarlightSidebarItem>;
 } | {
+    readonly autogenerate: {
+        readonly directory: string;
+        readonly collapsed?: boolean;
+    };
+} | {
+    /** @deprecated Use `{ label, items: [{ autogenerate }] }` instead. Translated by the emitter for one cycle. */
     readonly label: string;
     readonly collapsed?: boolean;
     readonly autogenerate: {

package/lib/index.d.ts

@@ -10330,9 +10330,22 @@ interface StarlightEditLink {
     readonly baseUrl: string;
 }
 /**
- * Sidebar item accepted by Starlight's `sidebar` config. Covers the four
- * common shapes: link, group with nested items, autogenerated group, and
- * internal slug reference.
+ * Sidebar item accepted by Starlight's `sidebar` config.
+ *
+ * Covers the shapes Starlight 0.39+ accepts:
+ * - link (`{ label, link, badge? }`)
+ * - group with nested items (`{ label, collapsed?, items }`)
+ * - bare autogenerated entry, nested inside a group's `items` array
+ *   (`{ autogenerate: { directory, collapsed? } }`)
+ * - internal slug reference (`{ label, slug }`)
+ *
+ * Plus one legacy shape kept for one deprecation cycle:
+ * - top-level autogenerated group (`{ label, collapsed?, autogenerate }`).
+ *   Starlight v0.39.0 removed runtime support for this shape; the
+ *   `StarlightProject` emitter translates it to the nested form
+ *   `{ label, collapsed?, items: [{ autogenerate }] }` before writing
+ *   `astro.config.mjs`. Migrate to the nested form directly — this
+ *   variant will be removed in a future release.
  */
 type StarlightSidebarItem = {
     readonly label: string;
@@ -10346,6 +10359,12 @@ type StarlightSidebarItem = {
     readonly collapsed?: boolean;
     readonly items: ReadonlyArray<StarlightSidebarItem>;
 } | {
+    readonly autogenerate: {
+        readonly directory: string;
+        readonly collapsed?: boolean;
+    };
+} | {
+    /** @deprecated Use `{ label, items: [{ autogenerate }] }` instead. Translated by the emitter for one cycle. */
     readonly label: string;
     readonly collapsed?: boolean;
     readonly autogenerate: {

package/lib/index.js

@@ -35662,7 +35662,7 @@ function buildStarlightConfig(options) {
     config.social = options.social;
   }
   if (options.sidebar !== void 0) {
-    config.sidebar = options.sidebar;
+    config.sidebar = options.sidebar.map(translateSidebarItem);
   }
   if (options.customCss !== void 0) {
     config.customCss = options.customCss;
@@ -35675,6 +35675,31 @@ function buildStarlightConfig(options) {
   }
   return config;
 }
+function translateSidebarItem(item) {
+  if (item === null || typeof item !== "object") {
+    return item;
+  }
+  const record = item;
+  if (typeof record.label === "string" && record.autogenerate !== void 0 && record.items === void 0) {
+    const translated = {
+      label: record.label,
+      items: [{ autogenerate: record.autogenerate }]
+    };
+    if (record.collapsed !== void 0) {
+      translated.collapsed = record.collapsed;
+    }
+    return translated;
+  }
+  if (Array.isArray(record.items)) {
+    return {
+      ...record,
+      items: record.items.map(
+        translateSidebarItem
+      )
+    };
+  }
+  return item;
+}
 var DEFAULT_INDEX_MDX = `---
 title: Welcome
 description: Starlight-powered documentation site.