zoriya/v10
1
0
Fork 0
mirror of https://github.com/zoriya/v10.git synced 2026-08-16 02:45:09 +00:00
Code Issues Packages Projects Releases Wiki Activity

feat(site): API reference pages for media elements (#1342)

Browse Source
This commit is contained in:
Darius Cepulis
2026-06-19 09:44:54 -07:00
committed by GitHub
parent 1512729365
commit d799be1063
95 changed files with 3219 additions and 210 deletions
Download Patch File Download Diff File Expand all files Collapse all files
site/scripts/api-docs-builder/src/index.ts
+47 -2
View File
@@ -1,6 +1,12 @@
import * as fs from 'node:fs';
import * as path from 'node:path';
import { generateComponentReferences, generateFeatureReferences, generatePresetReferences } from './pipeline.js';
import { MediaReferenceSchema } from '../../../src/types/media-reference.js';
import {
generateComponentReferences,
generateFeatureReferences,
generateMediaElementReferences,
generatePresetReferences,
} from './pipeline.js';
import { ComponentReferenceSchema, FeatureReferenceSchema, PresetReferenceSchema } from './types.js';
import { generateUtilReferences } from './util-handler.js';
@@ -19,6 +25,7 @@ const MONOREPO_ROOT = path.resolve(import.meta.dirname, '../../../../');
const COMPONENT_OUTPUT_PATH = path.join(MONOREPO_ROOT, 'site/src/content/generated-component-reference');
const UTIL_OUTPUT_PATH = path.join(MONOREPO_ROOT, 'site/src/content/generated-util-reference');
const FEATURE_OUTPUT_PATH = path.join(MONOREPO_ROOT, 'site/src/content/generated-feature-reference');
const MEDIA_OUTPUT_PATH = path.join(MONOREPO_ROOT, 'site/src/content/generated-media-reference');
const PRESET_OUTPUT_PATH = path.join(MONOREPO_ROOT, 'site/src/content/generated-preset-reference');
/**
@@ -36,7 +43,13 @@ function main() {
};
// Ensure output directories exist
for (const dir of [COMPONENT_OUTPUT_PATH, UTIL_OUTPUT_PATH, FEATURE_OUTPUT_PATH, PRESET_OUTPUT_PATH]) {
for (const dir of [
COMPONENT_OUTPUT_PATH,
UTIL_OUTPUT_PATH,
FEATURE_OUTPUT_PATH,
MEDIA_OUTPUT_PATH,
PRESET_OUTPUT_PATH,
]) {
if (!fs.existsSync(dir)) {
fs.mkdirSync(dir, { recursive: true });
}
@@ -116,6 +129,38 @@ function main() {
log.info(`Done! Generated ${featureSuccessCount} feature files.`);
// Generate media element references
const mediaResults = generateMediaElementReferences(MONOREPO_ROOT);
if (mediaResults.length === 0) {
log.info('No media elements found.');
} else {
log.info(`Found ${mediaResults.length} media elements. Processing...`);
}
let mediaSuccessCount = 0;
for (const result of mediaResults) {
const validated = MediaReferenceSchema.safeParse(result.reference);
if (!validated.success) {
log.error(`Schema validation failed for media element ${result.name}:`);
for (const issue of validated.error.issues) {
log.error(` - ${issue.path.join('.')}: ${issue.message}`);
}
errorCount++;
continue;
}
const outputFile = path.join(MEDIA_OUTPUT_PATH, `${validated.data.tagName}.json`);
const json = `${JSON.stringify(validated.data, null, 2)}\n`;
fs.writeFileSync(outputFile, json);
log.success(`✅ Generated ${path.basename(outputFile)}`);
mediaSuccessCount++;
successCount++;
}
log.info(`Done! Generated ${mediaSuccessCount} media element files.`);
// Generate preset references
const presetResults = generatePresetReferences(MONOREPO_ROOT);