ci: docs-sync에 MDX 검증 추가 및 플랫폼 ios/android/design 분리

.github/actions/generate-mobile-docs/action.yml

@@ -1,6 +1,11 @@
 name: Generate Mobile Docs
 description: Generate mobile docs from mobile document
 
+inputs:
+  platform:
+    description: Mobile platform to generate docs from (android | ios)
+    required: true
+
 runs:
   using: 'node24'
   main: 'dist/index.mjs'

.github/actions/generate-mobile-docs/dist/index.mjs

@@ -10672,6 +10672,14 @@ glob.glob = glob;
 
 // src/modules/base.ts
 var exec = __toESM(require_exec());
+
+// src/helpers.ts
+var normalizeFrontmatter = (content) => content.replace(
+  /^(---\n[\s\S]*?\n---)/,
+  (frontmatter) => frontmatter.replace(/`/g, "")
+);
+
+// src/modules/base.ts
 var BaseModule = class {
   tempFiles = {};
   PLATFORM;
@@ -10703,11 +10711,7 @@ var BaseModule = class {
         const designSlug = f.split("/");
         return designSlug.at(designSlug.length - 2).replace(/-/g, "") === (customTitle || title);
       });
-      let fileContent = fs.readFileSync(file, "utf8");
-      fileContent = fileContent.replace(
-        /^(---\n[\s\S]*?\n---)/,
-        (frontmatter) => frontmatter.replace(/`/g, "")
-      );
+      const fileContent = normalizeFrontmatter(fs.readFileSync(file, "utf8"));
       if (designFile) {
         this.tempFiles[designFile.replace(/design\.mdx$/, `${this.PLATFORM}.mdx`)] = fileContent;
       } else {
@@ -10759,7 +10763,7 @@ var BaseModule = class {
       if (!designFile) {
         continue;
       }
-      this.tempFiles[designFile.replace(/design\.mdx$/, `${this.PLATFORM}.mdx`)] = fs.readFileSync(file, "utf8");
+      this.tempFiles[designFile.replace(/design\.mdx$/, `${this.PLATFORM}.mdx`)] = normalizeFrontmatter(fs.readFileSync(file, "utf8"));
     }
   }
   getComponentTitle(file) {
@@ -10861,9 +10865,17 @@ ${parsedMatter.data.description}
 };
 
 // src/index.ts
+var MODULES = {
+  android: Android,
+  ios: IOS
+};
 var run = async () => {
-  (await new Android().gitClone()).load().convert().save().cleanup();
-  (await new IOS().gitClone()).load().convert().save().cleanup();
+  const platform = process.env.INPUT_PLATFORM ?? "";
+  const Module = MODULES[platform];
+  if (!Module) {
+    throw new Error(`Unknown platform: ${platform}`);
+  }
+  (await new Module().gitClone()).load().convert().save().cleanup();
 };
 run();
 /*! Bundled license information:

.github/actions/generate-mobile-docs/src/helpers.ts

@@ -0,0 +1,8 @@
+/**
+ * 모바일 문서 frontmatter의 백틱은 YAML 파싱을 깨뜨리므로 제거한다
+ * .github/actions/validate-docs/src/index.ts에 같은 코드가 있으므로 함께 수정한다
+ */
+export const normalizeFrontmatter = (content: string) =>
+  content.replace(/^(---\n[\s\S]*?\n---)/, (frontmatter) =>
+    frontmatter.replace(/`/g, ''),
+  );

.github/actions/generate-mobile-docs/src/index.ts

@@ -1,9 +1,20 @@
 import Android from './modules/android';
 import IOS from './modules/ios';
 
+const MODULES: Record<string, typeof Android | typeof IOS | undefined> = {
+  android: Android,
+  ios: IOS,
+};
+
 const run = async () => {
-  (await new Android().gitClone()).load().convert().save().cleanup();
-  (await new IOS().gitClone()).load().convert().save().cleanup();
+  const platform = process.env.INPUT_PLATFORM ?? '';
+  const Module = MODULES[platform];
+
+  if (!Module) {
+    throw new Error(`Unknown platform: ${platform}`);
+  }
+
+  (await new Module().gitClone()).load().convert().save().cleanup();
 };
 
 run();

.github/actions/generate-mobile-docs/src/modules/base.ts

@@ -4,6 +4,8 @@ import fs from 'node:fs';
 import { globSync } from 'glob';
 import * as exec from '@actions/exec';
 
+import { normalizeFrontmatter } from '../helpers';
+
 export type CustomComponentMap = Record<string, string>;
 export type CopyComponentMap = Record<string, Array<string>>;
 
@@ -61,12 +63,7 @@ export default abstract class BaseModule {
         );
       });
 
-      let fileContent = fs.readFileSync(file, 'utf8');
-
-      fileContent = fileContent.replace(
-        /^(---\n[\s\S]*?\n---)/,
-        (frontmatter) => frontmatter.replace(/`/g, ''),
-      );
+      const fileContent = normalizeFrontmatter(fs.readFileSync(file, 'utf8'));
 
       if (designFile) {
         this.tempFiles[
@@ -146,7 +143,7 @@ export default abstract class BaseModule {
 
       this.tempFiles[
         designFile.replace(/design\.mdx$/, `${this.PLATFORM}.mdx`)
-      ] = fs.readFileSync(file, 'utf8');
+      ] = normalizeFrontmatter(fs.readFileSync(file, 'utf8'));
     }
   }
 

.github/actions/validate-docs/.gitignore

@@ -0,0 +1 @@
+!dist

.github/actions/validate-docs/action.yml

@@ -0,0 +1,16 @@
+name: Validate Docs
+description: Compile md/mdx files the same way the docs build does and fail on errors
+
+inputs:
+  files:
+    description: Glob patterns of md/mdx files to validate (newline separated)
+    required: false
+    default: '**/*.{md,mdx}'
+  mobile-source:
+    description: Validate original docs from a mobile repository (applies the same transform as generate-mobile-docs)
+    required: false
+    default: 'false'
+
+runs:
+  using: 'node24'
+  main: 'dist/index.mjs'