docs(sdk): add spec format components and migrate check-ins

.gitignore

@@ -91,6 +91,9 @@ public/mdx-images/*
 public/og-images/*
 !public/og-images/README.md
 
+# Ignore LLM plans
+/docs/plans/
+
 # yalc
 .yalc
 yalc.lock

app/[[...path]]/page.tsx

@@ -11,6 +11,9 @@ import {Home} from 'sentry-docs/components/home';
 import {Include} from 'sentry-docs/components/include';
 import {PageLoadMetrics} from 'sentry-docs/components/pageLoadMetrics';
 import {PlatformContent} from 'sentry-docs/components/platformContent';
+import {SpecChangelog} from 'sentry-docs/components/specChangelog';
+import {isSpecStatus} from 'sentry-docs/components/specConstants';
+import {SpecMeta} from 'sentry-docs/components/specMeta';
 import {
   DocNode,
   getCurrentPlatformOrGuide,
@@ -47,23 +50,58 @@ export async function generateStaticParams() {
 export const dynamicParams = false;
 export const dynamic = 'force-static';
 
-const mdxComponentsWithWrapper = mdxComponents(
-  {Include, PlatformContent},
-  ({children, frontMatter, nextPage, previousPage}) => (
-    <DocPage
-      frontMatter={frontMatter}
-      nextPage={nextPage}
-      previousPage={previousPage}
-      fullWidth={frontMatter.fullWidth}
-    >
-      {children}
-    </DocPage>
-  )
-);
+function mdxComponentsForFrontMatter(frontMatter: Record<string, unknown>) {
+  const specOverrides: Record<string, unknown> = {};
+  const changelog = Array.isArray(frontMatter.spec_changelog)
+    ? (frontMatter.spec_changelog as Array<Record<string, unknown>>)
+        .filter(
+          entry => entry.version != null && entry.date != null && entry.summary != null
+        )
+        .map(entry => ({
+          version: String(entry.version),
+          date:
+            entry.date instanceof Date
+              ? entry.date.toISOString().split('T')[0]
+              : String(entry.date),
+          summary: String(entry.summary),
+        }))
+    : undefined;
+  if (changelog && changelog.length > 0) {
+    specOverrides.SpecChangelog = function () {
+      return <SpecChangelog changelog={changelog} />;
+    };
+  }
+  if (frontMatter.spec_version && isSpecStatus(frontMatter.spec_status)) {
+    const boundProps = {
+      version: String(frontMatter.spec_version),
+      status: frontMatter.spec_status,
+    };
+    specOverrides.SpecMeta = function () {
+      return <SpecMeta {...boundProps} />;
+    };
+  }
+  return mdxComponents(
+    {Include, PlatformContent, ...specOverrides},
+    ({children, frontMatter: fm, nextPage, previousPage}) => (
+      <DocPage
+        frontMatter={fm}
+        nextPage={nextPage}
+        previousPage={previousPage}
+        fullWidth={fm.fullWidth}
+      >
+        {children}
+      </DocPage>
+    )
+  );
+}
 
 function MDXLayoutRenderer({mdxSource, ...rest}) {
   const MDXLayout = useMemo(() => getMDXComponent(mdxSource), [mdxSource]);
-  return <MDXLayout components={mdxComponentsWithWrapper} {...rest} />;
+  const components = useMemo(
+    () => mdxComponentsForFrontMatter(rest.frontMatter || {}),
+    [rest.frontMatter]
+  );
+  return <MDXLayout components={components} {...rest} />;
 }
 
 export default async function Page(props: {params: Promise<{path?: string[]}>}) {