camelmind 0.1.0 → 0.2.0

package/template/lib/versions.ts

@@ -4,12 +4,20 @@ import yaml from "js-yaml"
 import { loadNav } from "./nav"
 import type { NavConfig } from "./nav-types"
 
+export type VersionApiReference = {
+  spec: string
+  nav_label?: string
+  languages?: string[]
+}
+
 export type Version = {
   id: string
   label: string
   stable: boolean
   badge?: string
   nav: string
+  // true/omitted = use site-level spec, false = hide, object = version-specific spec
+  api_reference?: boolean | VersionApiReference
 }
 
 export type VersionsConfig = {
@@ -49,6 +57,24 @@ export function getLatestVersion(): Version {
   return versions[0]
 }
 
+// Resolve which OpenAPI spec to use for a given version, with site-level fallback.
+// Returns null if api_reference is explicitly disabled for this version.
+export function getApiSpecForVersion(
+  versionId: string | null,
+  siteSpec: string,
+  siteLanguages?: string[]
+): { spec: string; languages?: string[] } | null {
+  if (!versionId) return { spec: siteSpec, languages: siteLanguages }
+  const { versions } = loadVersions()
+  const v = versions.find((v) => v.id === versionId)
+  if (!v) return { spec: siteSpec, languages: siteLanguages }
+
+  const ar = v.api_reference
+  if (ar === false) return null
+  if (!ar || ar === true) return { spec: siteSpec, languages: siteLanguages }
+  return { spec: ar.spec, languages: ar.languages ?? siteLanguages }
+}
+
 // Given a slug like /v1.9/getting-started/overview, return /getting-started/overview
 export function stripVersionPrefix(slug: string, versionId: string): string {
   return slug.replace(new RegExp(`^/${versionId}`), "") || "/"