@fern-api/fdr-sdk 1.2.20-d3269f39ac → 1.2.20-f9ee39a42e

package/dist/converters/read/convertDocsDefinitionToRead.js

@@ -0,0 +1,19 @@
+import { mapValues } from "es-toolkit/object";
+import { DocsV1Read } from "../../client";
+import { convertDbDocsConfigToRead } from "./convertDbDocsConfigToRead";
+export function convertDocsDefinitionToRead({ docsDbDefinition, filesV2, apis, id, apiNameToId }) {
+    return {
+        pages: docsDbDefinition.pages,
+        apis: Object.fromEntries(Object.entries(apis).map(([apiDefinitionId, api]) => [DocsV1Read.ApiDefinitionId(apiDefinitionId), api])),
+        apisV2: {},
+        apiNameToId: apiNameToId != null
+            ? mapValues(apiNameToId, (apiDefinitionId) => DocsV1Read.ApiDefinitionId(apiDefinitionId))
+            : undefined,
+        files: mapValues(filesV2, (fileV2) => fileV2.url),
+        filesV2,
+        jsFiles: docsDbDefinition.type === "v3" ? docsDbDefinition.jsFiles : undefined,
+        id: id != null ? DocsV1Read.DocsConfigId(id) : undefined,
+        config: convertDbDocsConfigToRead({ dbShape: docsDbDefinition.config })
+    };
+}
+//# sourceMappingURL=convertDocsDefinitionToRead.js.map

package/dist/converters/read/convertDocsDefinitionToRead.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convertDocsDefinitionToRead.js","sourceRoot":"","sources":["../../../src/converters/read/convertDocsDefinitionToRead.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAExE,MAAM,UAAU,2BAA2B,CAAC,EACxC,gBAAgB,EAChB,OAAO,EACP,IAAI,EACJ,EAAE,EACF,WAAW,EAOd;IACG,OAAO;QACH,KAAK,EAAE,gBAAgB,CAAC,KAAK;QAC7B,IAAI,EAAE,MAAM,CAAC,WAAW,CACpB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,eAAe,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,eAAe,CAAC,eAAe,CAAC,EAAE,GAAG,CAAC,CAAC,CAC3G;QACD,MAAM,EAAE,EAAE;QACV,WAAW,EACP,WAAW,IAAI,IAAI;YACf,CAAC,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,eAAe,EAAE,EAAE,CAAC,UAAU,CAAC,eAAe,CAAC,eAAe,CAAC,CAAC;YAC1F,CAAC,CAAC,SAAS;QACnB,KAAK,EAAE,SAAS,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,GAAqB,CAAC;QACnE,OAAO;QACP,OAAO,EAAE,gBAAgB,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;QAC9E,EAAE,EAAE,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS;QACxD,MAAM,EAAE,yBAAyB,CAAC,EAAE,OAAO,EAAE,gBAAgB,CAAC,MAAM,EAAE,CAAC;KAC1E,CAAC;AACN,CAAC"}

package/dist/converters/utils/colors.d.ts

@@ -0,0 +1,4 @@
+import type { DocsV1Read } from "../../client";
+export declare const DEFAULT_DARK_MODE_ACCENT_PRIMARY: DocsV1Read.RgbaColor;
+export declare const DEFAULT_LIGHT_MODE_ACCENT_PRIMARY: DocsV1Read.RgbaColor;
+//# sourceMappingURL=colors.d.ts.map

package/dist/converters/utils/colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../../../src/converters/utils/colors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,eAAO,MAAM,gCAAgC,EAAE,UAAU,CAAC,SAKzD,CAAC;AAEF,eAAO,MAAM,iCAAiC,EAAE,UAAU,CAAC,SAK1D,CAAC"}

package/dist/converters/utils/colors.js

@@ -0,0 +1,13 @@
+export const DEFAULT_DARK_MODE_ACCENT_PRIMARY = {
+    r: 129,
+    g: 140,
+    b: 248,
+    a: undefined
+};
+export const DEFAULT_LIGHT_MODE_ACCENT_PRIMARY = {
+    r: 129,
+    g: 140,
+    b: 248,
+    a: undefined
+};
+//# sourceMappingURL=colors.js.map

package/dist/converters/utils/colors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.js","sourceRoot":"","sources":["../../../src/converters/utils/colors.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,gCAAgC,GAAyB;IAClE,CAAC,EAAE,GAAG;IACN,CAAC,EAAE,GAAG;IACN,CAAC,EAAE,GAAG;IACN,CAAC,EAAE,SAAS;CACf,CAAC;AAEF,MAAM,CAAC,MAAM,iCAAiC,GAAyB;IACnE,CAAC,EAAE,GAAG;IACN,CAAC,EAAE,GAAG;IACN,CAAC,EAAE,GAAG;IACN,CAAC,EAAE,SAAS;CACf,CAAC"}

package/dist/docs/frontmatter.d.ts

@@ -0,0 +1,3 @@
+import type { Frontmatter } from "../client/docs-types/latest";
+export declare const EMPTY_FRONTMATTER: Frontmatter;
+//# sourceMappingURL=frontmatter.d.ts.map

package/dist/docs/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../src/docs/frontmatter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE/D,eAAO,MAAM,iBAAiB,EAAE,WA0C/B,CAAC"}

package/dist/docs/frontmatter.js

@@ -0,0 +1,44 @@
+export const EMPTY_FRONTMATTER = {
+    title: undefined,
+    headline: undefined,
+    description: undefined,
+    subtitle: undefined,
+    layout: undefined,
+    slug: undefined,
+    image: undefined,
+    "edit-this-page-url": undefined,
+    "hide-toc": undefined,
+    "force-toc": undefined,
+    "max-toc-depth": undefined,
+    "hide-nav-links": undefined,
+    "hide-feedback": undefined,
+    "hide-page-actions": undefined,
+    "no-image-zoom": undefined,
+    breadcrumb: undefined,
+    excerpt: undefined,
+    "canonical-url": undefined,
+    "og:site_name": undefined,
+    "og:title": undefined,
+    "og:description": undefined,
+    "og:url": undefined,
+    "og:image": undefined,
+    "og:image:width": undefined,
+    "og:image:height": undefined,
+    "og:locale": undefined,
+    "og:logo": undefined,
+    "twitter:title": undefined,
+    "twitter:description": undefined,
+    "twitter:handle": undefined,
+    "twitter:image": undefined,
+    "twitter:site": undefined,
+    "twitter:url": undefined,
+    "twitter:card": undefined,
+    noindex: undefined,
+    nofollow: undefined,
+    "jsonld:breadcrumb": undefined,
+    keywords: undefined,
+    logo: undefined,
+    tags: undefined,
+    "last-updated": undefined
+};
+//# sourceMappingURL=frontmatter.js.map

package/dist/docs/frontmatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../../src/docs/frontmatter.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,iBAAiB,GAAgB;IAC1C,KAAK,EAAE,SAAS;IAChB,QAAQ,EAAE,SAAS;IACnB,WAAW,EAAE,SAAS;IACtB,QAAQ,EAAE,SAAS;IACnB,MAAM,EAAE,SAAS;IACjB,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,SAAS;IAChB,oBAAoB,EAAE,SAAS;IAC/B,UAAU,EAAE,SAAS;IACrB,WAAW,EAAE,SAAS;IACtB,eAAe,EAAE,SAAS;IAC1B,gBAAgB,EAAE,SAAS;IAC3B,eAAe,EAAE,SAAS;IAC1B,mBAAmB,EAAE,SAAS;IAC9B,eAAe,EAAE,SAAS;IAC1B,UAAU,EAAE,SAAS;IACrB,OAAO,EAAE,SAAS;IAClB,eAAe,EAAE,SAAS;IAC1B,cAAc,EAAE,SAAS;IACzB,UAAU,EAAE,SAAS;IACrB,gBAAgB,EAAE,SAAS;IAC3B,QAAQ,EAAE,SAAS;IACnB,UAAU,EAAE,SAAS;IACrB,gBAAgB,EAAE,SAAS;IAC3B,iBAAiB,EAAE,SAAS;IAC5B,WAAW,EAAE,SAAS;IACtB,SAAS,EAAE,SAAS;IACpB,eAAe,EAAE,SAAS;IAC1B,qBAAqB,EAAE,SAAS;IAChC,gBAAgB,EAAE,SAAS;IAC3B,eAAe,EAAE,SAAS;IAC1B,cAAc,EAAE,SAAS;IACzB,aAAa,EAAE,SAAS;IACxB,cAAc,EAAE,SAAS;IACzB,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,SAAS;IACnB,mBAAmB,EAAE,SAAS;IAC9B,QAAQ,EAAE,SAAS;IACnB,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,SAAS;IACf,cAAc,EAAE,SAAS;CAC5B,CAAC"}

package/dist/docs/index.d.ts

@@ -0,0 +1,4 @@
+export * from "../client/docs-types/latest";
+export * from "./frontmatter";
+export * from "./s3-docs-definition";
+//# sourceMappingURL=index.d.ts.map

package/dist/docs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/docs/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC"}

package/dist/docs/index.js

@@ -0,0 +1,4 @@
+export * from "../client/docs-types/latest";
+export * from "./frontmatter";
+export * from "./s3-docs-definition";
+//# sourceMappingURL=index.js.map

package/dist/docs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/docs/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC"}

package/dist/docs/s3-docs-definition.d.ts

@@ -0,0 +1,7 @@
+export declare function getS3KeyForV1DocsDefinition(domain: string, basepath?: string, locale?: string, defaultLocale?: string): string;
+export declare function getS3KeyForDynamicIr({ orgName, apiName, language }: {
+    orgName: string;
+    apiName: string;
+    language: string;
+}): string;
+//# sourceMappingURL=s3-docs-definition.d.ts.map

package/dist/docs/s3-docs-definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-docs-definition.d.ts","sourceRoot":"","sources":["../../src/docs/s3-docs-definition.ts"],"names":[],"mappings":"AAAA,wBAAgB,2BAA2B,CACvC,MAAM,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,EACf,aAAa,SAAO,GACrB,MAAM,CAWR;AAED,wBAAgB,oBAAoB,CAAC,EACjC,OAAO,EACP,OAAO,EACP,QAAQ,EACX,EAAE;IACC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CACpB,GAAG,MAAM,CAET"}

package/dist/docs/s3-docs-definition.js

@@ -0,0 +1,15 @@
+export function getS3KeyForV1DocsDefinition(domain, basepath, locale, defaultLocale = "en") {
+    const isLocalMode = process.env.LOCAL_MODE_OVERRIDE === "true";
+    const filename = locale == null || locale.toLowerCase() === defaultLocale.toLowerCase()
+        ? "fdr.json"
+        : `translations/${locale}.json`;
+    if (basepath != null) {
+        const cleanBasepath = basepath.replace(/^\//, "");
+        return isLocalMode ? `${cleanBasepath}/v1/${filename}` : `${domain}/${cleanBasepath}/v1/${filename}`;
+    }
+    return isLocalMode ? `v1/${filename}` : `${domain}/v1/${filename}`;
+}
+export function getS3KeyForDynamicIr({ orgName, apiName, language }) {
+    return `${orgName}/${apiName}/${language}.json`;
+}
+//# sourceMappingURL=s3-docs-definition.js.map

package/dist/docs/s3-docs-definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-docs-definition.js","sourceRoot":"","sources":["../../src/docs/s3-docs-definition.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,2BAA2B,CACvC,MAAc,EACd,QAAiB,EACjB,MAAe,EACf,aAAa,GAAG,IAAI;IAEpB,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,KAAK,MAAM,CAAC;IAC/D,MAAM,QAAQ,GACV,MAAM,IAAI,IAAI,IAAI,MAAM,CAAC,WAAW,EAAE,KAAK,aAAa,CAAC,WAAW,EAAE;QAClE,CAAC,CAAC,UAAU;QACZ,CAAC,CAAC,gBAAgB,MAAM,OAAO,CAAC;IACxC,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;QACnB,MAAM,aAAa,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAClD,OAAO,WAAW,CAAC,CAAC,CAAC,GAAG,aAAa,OAAO,QAAQ,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,aAAa,OAAO,QAAQ,EAAE,CAAC;IACzG,CAAC;IACD,OAAO,WAAW,CAAC,CAAC,CAAC,MAAM,QAAQ,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM,OAAO,QAAQ,EAAE,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,EACjC,OAAO,EACP,OAAO,EACP,QAAQ,EAKX;IACG,OAAO,GAAG,OAAO,IAAI,OAAO,IAAI,QAAQ,OAAO,CAAC;AACpD,CAAC"}

package/dist/docs/s3-docs-definition.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=s3-docs-definition.test.d.ts.map

package/dist/docs/s3-docs-definition.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-docs-definition.test.d.ts","sourceRoot":"","sources":["../../src/docs/s3-docs-definition.test.ts"],"names":[],"mappings":""}

package/dist/docs/s3-docs-definition.test.js

@@ -0,0 +1,29 @@
+import { describe, expect, it } from "vitest";
+import { getS3KeyForV1DocsDefinition } from "./s3-docs-definition";
+describe("getS3KeyForV1DocsDefinition", () => {
+    it("uses fdr.json when no locale is provided", () => {
+        expect(getS3KeyForV1DocsDefinition("docs.example.com")).toBe("docs.example.com/v1/fdr.json");
+    });
+    it("preserves en as the default locale when no default locale is provided", () => {
+        expect(getS3KeyForV1DocsDefinition("docs.example.com", undefined, "en")).toBe("docs.example.com/v1/fdr.json");
+    });
+    it("uses fdr.json for a non-en default locale", () => {
+        expect(getS3KeyForV1DocsDefinition("docs.example.com", undefined, "ja", "ja")).toBe("docs.example.com/v1/fdr.json");
+    });
+    it("uses a translation key for en when en is not the default locale", () => {
+        expect(getS3KeyForV1DocsDefinition("docs.example.com", undefined, "en", "ja")).toBe("docs.example.com/v1/translations/en.json");
+    });
+    it("includes basepath in the S3 key for non-default locale", () => {
+        expect(getS3KeyForV1DocsDefinition("buildwithfern.com", "/learn", "zh")).toBe("buildwithfern.com/learn/v1/translations/zh.json");
+    });
+    it("includes basepath in the S3 key for base (default) locale", () => {
+        expect(getS3KeyForV1DocsDefinition("buildwithfern.com", "/learn")).toBe("buildwithfern.com/learn/v1/fdr.json");
+    });
+    it("includes basepath in the S3 key for default locale explicitly passed", () => {
+        expect(getS3KeyForV1DocsDefinition("buildwithfern.com", "/learn", "en")).toBe("buildwithfern.com/learn/v1/fdr.json");
+    });
+    it("strips leading slash from basepath", () => {
+        expect(getS3KeyForV1DocsDefinition("example.com", "/docs", "zh")).toBe("example.com/docs/v1/translations/zh.json");
+    });
+});
+//# sourceMappingURL=s3-docs-definition.test.js.map

package/dist/docs/s3-docs-definition.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-docs-definition.test.js","sourceRoot":"","sources":["../../src/docs/s3-docs-definition.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AAEnE,QAAQ,CAAC,6BAA6B,EAAE,GAAG,EAAE;IACzC,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAChD,MAAM,CAAC,2BAA2B,CAAC,kBAAkB,CAAC,CAAC,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IACjG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uEAAuE,EAAE,GAAG,EAAE;QAC7E,MAAM,CAAC,2BAA2B,CAAC,kBAAkB,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IAClH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACjD,MAAM,CAAC,2BAA2B,CAAC,kBAAkB,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAC/E,8BAA8B,CACjC,CAAC;IACN,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;QACvE,MAAM,CAAC,2BAA2B,CAAC,kBAAkB,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAC/E,0CAA0C,CAC7C,CAAC;IACN,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAC9D,MAAM,CAAC,2BAA2B,CAAC,mBAAmB,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CACzE,iDAAiD,CACpD,CAAC;IACN,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;QACjE,MAAM,CAAC,2BAA2B,CAAC,mBAAmB,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;IACnH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sEAAsE,EAAE,GAAG,EAAE;QAC5E,MAAM,CAAC,2BAA2B,CAAC,mBAAmB,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CACzE,qCAAqC,CACxC,CAAC;IACN,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC1C,MAAM,CAAC,2BAA2B,CAAC,aAAa,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAClE,0CAA0C,CAC7C,CAAC;IACN,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * as ApiDefinition from "./api-definition";
+export * from "./client";
+export * from "./converters";
+export * as FernDocs from "./docs";
+export * as FernNavigation from "./navigation";
+export { obfuscateSecret } from "./utils/obfuscate-secret";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,aAAa,MAAM,kBAAkB,CAAC;AAClD,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,OAAO,KAAK,QAAQ,MAAM,QAAQ,CAAC;AACnC,OAAO,KAAK,cAAc,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export * as ApiDefinition from "./api-definition";
+export * from "./client";
+export * from "./converters";
+export * as FernDocs from "./docs";
+export * as FernNavigation from "./navigation";
+export { obfuscateSecret } from "./utils/obfuscate-secret";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,aAAa,MAAM,kBAAkB,CAAC;AAClD,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,OAAO,KAAK,QAAQ,MAAM,QAAQ,CAAC;AACnC,OAAO,KAAK,cAAc,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/js/navigation/ledger-root-builder.js

@@ -680,6 +680,18 @@ function metaBool(metadata, key) {
   }
   return void 0;
 }
+function metaCollapsed(metadata) {
+  if (metadata != null && typeof metadata === "object" && "collapsed" in metadata) {
+    const v = metadata.collapsed;
+    if (typeof v === "boolean") {
+      return v;
+    }
+    if (v === "open-by-default") {
+      return "open-by-default";
+    }
+  }
+  return void 0;
+}
 function metaStrArr(metadata, key) {
   if (metadata != null && typeof metadata === "object" && key in metadata) {
     const v = metadata[key];
@@ -886,16 +898,18 @@ function sectionNode(ctx, scoped, sectionChildren) {
   const overviewPageId = overview != null ? metaStr(overview.metadata, "pageId") : void 0;
   const slug = ctx.contentSlug(overview?.fullPath ?? seg.section);
   const leafChildren = nav.map((r) => artifactToNode(ctx, r)).filter((n) => n != null);
+  const defaults = withMetadataDefaults({
+    id: ctx.nodeId(`section:${slug}`),
+    title: metaStr(seg.metadata, "title") ?? "",
+    slug,
+    icon: metaStr(seg.metadata, "icon"),
+    hidden: seg.hidden,
+    viewers: toViewers(metaStrArr(seg.metadata, "viewers"))
+  });
   return {
     type: "section",
-    ...withMetadataDefaults({
-      id: ctx.nodeId(`section:${slug}`),
-      title: metaStr(seg.metadata, "title") ?? "",
-      slug,
-      icon: metaStr(seg.metadata, "icon"),
-      hidden: seg.hidden,
-      viewers: toViewers(metaStrArr(seg.metadata, "viewers"))
-    }),
+    ...defaults,
+    collapsed: metaCollapsed(seg.metadata) ?? defaults.collapsed,
     overviewPageId: overviewPageId != null ? PageId(overviewPageId) : void 0,
     noindex: void 0,
     collapsible: metaBool(seg.metadata, "collapsible"),
@@ -1116,7 +1130,10 @@ function groupSidebarRootChildren(ctx, children) {
     }
   };
   for (const child of children) {
-    if (child.type === "section" || child.type === "apiReference" || child.type === "varianted") {
+    if (child.type === "apiReference" || child.type === "varianted") {
+      flushRun();
+      out.push(child);
+    } else if (child.type === "section" && (child.collapsible === false || child.collapsible == null && child.collapsed === false)) {
       flushRun();
       out.push(child);
     } else {