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

docs(site): add Slider and Tooltip API reference pages (#862)

Browse Source 
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Darius Cepulis
2026-03-16 14:05:33 -05:00
committed by GitHub
co-authored by Claude Opus 4.6
parent 487be3ea96
commit 7a5ce94bca
44 changed files with 1126 additions and 48 deletions
Download Patch File Download Diff File Expand all files Collapse all files
site/scripts/api-docs-builder/src/parts-handler.ts
+45 -17
View File
@@ -77,8 +77,10 @@ export function extractPartDescription(filePath: string, program: ts.Program, pa
/**
* Extract custom React-specific props from a sub-part's Props interface.
*
* Walks syntactic own members of `{localName}Props` (excluding inherited
* `UIComponentProps` members and `children`).
* Walks syntactic own members of `{localName}Props`, then also includes
* members from any extended interface declared within the project (i.e., not
* from `node_modules`). This picks up props from project types like
* `TooltipGroupProps` while excluding inherited React DOM attributes.
*/
export function extractSubPartProps(filePath: string, program: ts.Program, localName: string): Record<string, PropDef> {
const sourceFile = program.getSourceFile(filePath);
@@ -86,27 +88,53 @@ export function extractSubPartProps(filePath: string, program: ts.Program, local
const checker = program.getTypeChecker();
const props: Record<string, PropDef> = {};
const SKIP_PROPS = new Set(['children']);
function collectFromMembers(members: ts.NodeArray<ts.TypeElement>) {
for (const member of members) {
if (!ts.isPropertySignature(member) || !member.name || !ts.isIdentifier(member.name)) continue;
const name = member.name.text;
if (SKIP_PROPS.has(name) || !member.type) continue;
let typeStr = checker.typeToString(checker.getTypeFromTypeNode(member.type));
if (member.questionToken) typeStr = typeStr.replace(/ \| undefined$/, '');
const propDef: PropDef = { type: typeStr };
const symbol = checker.getSymbolAtLocation(member.name);
if (symbol) {
const docs = symbol.getDocumentationComment(checker);
const desc = docs.map((d) => d.text).join('');
if (desc) propDef.description = desc;
}
props[name] = propDef;
}
}
ts.forEachChild(sourceFile, function visit(node) {
if (ts.isInterfaceDeclaration(node) && node.name.text === `${localName}Props`) {
for (const member of node.members) {
if (!ts.isPropertySignature(member) || !member.name || !ts.isIdentifier(member.name)) continue;
const name = member.name.text;
if (name === 'children' || !member.type) continue;
// Collect own syntactic members.
collectFromMembers(node.members);
let typeStr = checker.typeToString(checker.getTypeFromTypeNode(member.type));
// Only strips trailing ` | undefined`; other orderings (e.g., `undefined | string`) pass through.
if (member.questionToken) typeStr = typeStr.replace(/ \| undefined$/, '');
// Walk extends clause and include members from project-local interfaces.
if (node.heritageClauses) {
for (const clause of node.heritageClauses) {
for (const expr of clause.types) {
const type = checker.getTypeAtLocation(expr);
const symbol = type.getSymbol();
const decl = symbol?.declarations?.[0];
if (!decl) continue;
const propDef: PropDef = { type: typeStr };
// Only include if declared in project sources (not node_modules).
const declFile = decl.getSourceFile().fileName;
if (declFile.includes('node_modules')) continue;
const symbol = checker.getSymbolAtLocation(member.name);
if (symbol) {
const docs = symbol.getDocumentationComment(checker);
const desc = docs.map((d) => d.text).join('');
if (desc) propDef.description = desc;
if (ts.isInterfaceDeclaration(decl)) {
collectFromMembers(decl.members);
}
}
}
props[name] = propDef;
}
}
ts.forEachChild(node, visit);