Skip to content

AI-native design editor. Open-source Figma alternative.

3.0 KB
Raw Blame
#!/usr/bin/env bun
import { resolve } from 'node:path'

import {
  DE,
  DE_PROG,
  EN,
  EN_PROG,
  ES,
  ES_PROG,
  FR,
  FR_PROG,
  IT,
  IT_PROG,
  PL,
  PL_PROG,
  RU,
  RU_PROG
} from '#docs-config/labels'
import type { ProgrammableLabels, SidebarLabels } from '#docs-config/labels'
import { sdkSidebar } from '#docs-config/sdk-sidebar'
import {
  developmentSidebar,
  guideSidebar,
  programmableSidebar,
  referenceSidebar,
  userGuideSidebar
} from '#docs-config/sidebars'

import { resolveWorkspaceRoot } from '@open-pencil/package-artifacts-tools'

import { checkGuideMap } from './guides'
import { checkDocsIntegrity } from './integrity'

interface SidebarItem {
  items?: SidebarItem[]
  link?: string
}

interface LocaleConfig {
  labels: SidebarLabels
  prefix: string
  programmable: ProgrammableLabels
}

const localeConfigs: LocaleConfig[] = [
  { labels: EN, prefix: '', programmable: EN_PROG },
  { labels: DE, prefix: '/de', programmable: DE_PROG },
  { labels: ES, prefix: '/es', programmable: ES_PROG },
  { labels: FR, prefix: '/fr', programmable: FR_PROG },
  { labels: IT, prefix: '/it', programmable: IT_PROG },
  { labels: PL, prefix: '/pl', programmable: PL_PROG },
  { labels: RU, prefix: '/ru', programmable: RU_PROG }
]

function sidebarLinks(items: SidebarItem[]): string[] {
  return items.flatMap((item) => [
    ...(item.link ? [item.link] : []),
    ...(item.items ? sidebarLinks(item.items) : [])
  ])
}

function localeSidebarLinks({ labels, prefix, programmable }: LocaleConfig): string[] {
  const developmentPrefix = prefix ? '' : prefix
  return sidebarLinks([
    ...guideSidebar(prefix, labels),
    ...userGuideSidebar(prefix, labels),
    ...programmableSidebar(prefix, programmable),
    ...sdkSidebar(prefix),
    ...referenceSidebar(prefix, 'Reference', labels),
    ...developmentSidebar(developmentPrefix, 'Development', labels)
  ])
}

const repoRoot = await resolveWorkspaceRoot(import.meta.dir)
const docsRoot = resolve(repoRoot, 'packages/docs')
const result = checkDocsIntegrity({
  docsRoot,
  localePrefixes: localeConfigs.slice(1).map(({ prefix }) => prefix.slice(1)),
  redirectsPath: resolve(docsRoot, 'public/_redirects'),
  sidebarLinks: localeConfigs.flatMap(localeSidebarLinks)
})

const missingCounts = Object.values(result.localeMissingPages).map((pages) => pages.length)
const translationCounts = missingCounts.map((missing) => result.canonicalPageCount - missing)
console.log(
  `Localized page presence: ${Math.min(...translationCounts)}–${Math.max(...translationCounts)} of ${result.canonicalPageCount} canonical routes per locale; content quality is audited separately.`
)

const guides = checkGuideMap({ repoRoot })
const errors = [...result.errors, ...guides.errors]

if (errors.length > 0) {
  console.error('\nDocumentation integrity check failed:')
  for (const error of errors) console.error(`- ${error}`)
  process.exit(1)
}

console.log(`Guide map check passed for ${guides.guides.length} AGENTS.md guides.`)

console.log(
  `Documentation integrity check passed for ${result.markdownFiles.length} Markdown files.`
)