sizuku 0.3.2 → 0.4.0

package/dist/src/generator/mermaid-er/validator/parse-table-info.js

@@ -1,91 +0,0 @@
-import { Node, Project } from 'ts-morph';
-/**
- * Get the base builder name from an expression.
- *
- * @param expr - The expression to get the builder name from.
- * @returns The base builder name.
- */
-function baseBuilderName(expr) {
-    if (Node.isIdentifier(expr))
-        return expr.getText();
-    if (Node.isCallExpression(expr) || Node.isPropertyAccessExpression(expr))
-        return baseBuilderName(expr.getExpression());
-    return '';
-}
-/**
- * Type guard for FieldInfo.
- *
- * @param v - The value to check.
- * @returns True if the value is a FieldInfo.
- */
-function isFieldInfo(v) {
-    return v !== null;
-}
-/**
- * Parse table information from code.
- *
- * @param code - The code to parse.
- * @returns Array of table information.
- */
-export function parseTableInfo(code) {
-    const source = code.join('\n');
-    const file = new Project({ useInMemoryFileSystem: true }).createSourceFile('temp.ts', source);
-    return file
-        .getVariableStatements()
-        .filter((stmt) => stmt.isExported())
-        .flatMap((stmt) => {
-        const decl = stmt.getDeclarations()[0];
-        if (!Node.isVariableDeclaration(decl))
-            return [];
-        const varName = decl.getName();
-        if (varName.toLowerCase().includes('relation'))
-            return [];
-        const init = decl.getInitializer();
-        if (!(init && Node.isCallExpression(init)))
-            return [];
-        const callee = init.getExpression().getText();
-        if (!callee.endsWith('Table') || callee === 'relations')
-            return [];
-        const objLit = init.getArguments()[1];
-        if (!(objLit && Node.isObjectLiteralExpression(objLit)))
-            return [];
-        const fields = objLit
-            .getProperties()
-            .filter(Node.isPropertyAssignment)
-            .map((prop) => {
-            const keyNode = prop.getNameNode();
-            if (!Node.isIdentifier(keyNode))
-                return null;
-            const fieldName = keyNode.getText();
-            const initExpr = prop.getInitializer();
-            if (!(initExpr && Node.isCallExpression(initExpr)))
-                return null;
-            const fieldType = baseBuilderName(initExpr);
-            const initText = initExpr.getText();
-            const lineIdx = prop.getStartLineNumber() - 1;
-            const baseDesc = code
-                .slice(0, lineIdx)
-                .reverse()
-                .find((line) => {
-                const t = line.trim();
-                return (t.startsWith('///') &&
-                    !t.includes('@z.') &&
-                    !t.includes('@v.') &&
-                    !t.includes('@relation'));
-            })
-                ?.replace(/^\s*\/\/\/\s*/, '') ?? '';
-            const prefix = initText.includes('.primaryKey()')
-                ? '(PK) '
-                : initText.includes('.references(')
-                    ? '(FK) '
-                    : '';
-            return {
-                name: fieldName,
-                type: fieldType,
-                description: `${prefix}${baseDesc}`.trim(),
-            };
-        })
-            .filter(isFieldInfo);
-        return [{ name: varName, fields }];
-    });
-}

package/dist/src/generator/mermaid-er/validator/remove-duplicate-relations.d.ts

@@ -1,7 +0,0 @@
-/**
- * Remove duplicate relations.
- *
- * @param relations - The relations to remove duplicates from.
- * @returns The relations without duplicates.
- */
-export declare function removeDuplicateRelations(relations: readonly string[]): readonly string[];

package/dist/src/generator/mermaid-er/validator/remove-duplicate-relations.js

@@ -1,9 +0,0 @@
-/**
- * Remove duplicate relations.
- *
- * @param relations - The relations to remove duplicates from.
- * @returns The relations without duplicates.
- */
-export function removeDuplicateRelations(relations) {
-    return [...new Set(relations)];
-}

package/dist/src/generator/valibot/generator/infer-input.d.ts

@@ -1,5 +0,0 @@
-/**
- * @param name
- * @returns
- */
-export declare function inferInput(name: string): string;

package/dist/src/generator/valibot/generator/infer-input.js

@@ -1,8 +0,0 @@
-import { capitalize } from '../../../shared/utils/index.js';
-/**
- * @param name
- * @returns
- */
-export function inferInput(name) {
-    return `export type ${capitalize(name)} = v.InferInput<typeof ${capitalize(name)}Schema>`;
-}

package/dist/src/generator/valibot/generator/valibot-code.d.ts

@@ -1,14 +0,0 @@
-/**
- * @param schema
- * @param comment
- * @param type
- * @returns
- */
-export declare function valibotCode(schema: {
-    name: string;
-    fields: {
-        name: string;
-        definition: string;
-        description?: string;
-    }[];
-}, comment: boolean, type: boolean): string;

package/dist/src/generator/valibot/generator/valibot-code.js

@@ -1,16 +0,0 @@
-import { inferInput } from './infer-input.js';
-import { valibot } from './valibot.js';
-/**
- * @param schema
- * @param comment
- * @param type
- * @returns
- */
-export function valibotCode(schema, comment, type) {
-    const valibotSchema = valibot(schema, comment);
-    if (type) {
-        const valibotInfer = inferInput(schema.name);
-        return `${valibotSchema}\n\n${valibotInfer}\n`;
-    }
-    return `${valibotSchema}\n`;
-}

package/dist/src/generator/valibot/generator/valibot.d.ts

@@ -1,13 +0,0 @@
-/**
- * @param schema
- * @param config
- * @returns
- */
-export declare function valibot(schema: {
-    name: string;
-    fields: {
-        name: string;
-        definition: string;
-        description?: string;
-    }[];
-}, comment: boolean): string;

package/dist/src/generator/valibot/generator/valibot.js

@@ -1,11 +0,0 @@
-import { fieldDefinitions } from '../../../shared/generator/field-definitions.js';
-import { schemaName } from '../../../shared/utils/index.js';
-/**
- * @param schema
- * @param config
- * @returns
- */
-export function valibot(schema, comment) {
-    const res = fieldDefinitions(schema, comment);
-    return `export const ${schemaName(schema.name)} = v.object({${res}})`;
-}

package/dist/src/generator/valibot/index.d.ts

@@ -1,9 +0,0 @@
-import type { Result } from 'neverthrow';
-/**
- * Generate Valibot schema
- * @param code - The code to generate Valibot schema from
- * @param output - The output file path
- * @param comment - Whether to include comments in the generated code
- * @param type - Whether to include type information in the generated code
- */
-export declare function sizukuValibot(code: string[], output: `${string}.ts`, comment?: boolean, type?: boolean): Promise<Result<void, Error>>;

package/dist/src/generator/valibot/index.js

@@ -1,34 +0,0 @@
-import path from 'node:path';
-import { fmt } from '../../shared/format/index.js';
-import { mkdir, writeFile } from '../../shared/fsp/index.js';
-import { buildSchemaExtractor } from '../../shared/helper/build-schema-extractor.js';
-import { createExtractFieldFromProperty } from '../../shared/helper/create-extract-field-from-property.js';
-import { createExtractFieldsFromCallExpression } from '../../shared/helper/create-extract-fields-from-call-expression.js';
-import { createExtractRelationFieldFromProperty } from '../../shared/helper/create-extract-relation-field-from-property.js';
-import { extractSchemas } from '../../shared/helper/extract-schemas.js';
-import { findObjectLiteralExpression } from '../../shared/helper/find-object-literal-expression.js';
-import { findObjectLiteralInArgs } from '../../shared/helper/find-object-literalIn-args.js';
-import { isRelationFunctionCall } from '../../shared/helper/is-relation-function.js';
-import { parseFieldComments } from '../../shared/utils/index.js';
-import { valibotCode } from './generator/valibot-code.js';
-/**
- * Generate Valibot schema
- * @param code - The code to generate Valibot schema from
- * @param output - The output file path
- * @param comment - Whether to include comments in the generated code
- * @param type - Whether to include type information in the generated code
- */
-export async function sizukuValibot(code, output, comment, type) {
-    const extractField = createExtractFieldFromProperty((lines) => parseFieldComments(lines, '@v.'));
-    const extractRelationField = createExtractRelationFieldFromProperty((lines) => parseFieldComments(lines, '@v.'), 'v');
-    const extractFieldsFromCall = createExtractFieldsFromCallExpression(extractField, extractRelationField, findObjectLiteralExpression, findObjectLiteralInArgs, isRelationFunctionCall);
-    const extractSchema = buildSchemaExtractor(extractFieldsFromCall, extractField);
-    const valibotGeneratedCode = [
-        'import * as v from "valibot"',
-        '',
-        ...extractSchemas(code, extractSchema).map((schema) => valibotCode(schema, comment ?? false, type ?? false)),
-    ].join('\n');
-    return await mkdir(path.dirname(output))
-        .andThen(() => fmt(valibotGeneratedCode))
-        .andThen((formatted) => writeFile(output, formatted));
-}

package/dist/src/generator/zod/generator/infer.d.ts

@@ -1,5 +0,0 @@
-/**
- * @param name
- * @returns
- */
-export declare function infer(name: string): string;

package/dist/src/generator/zod/generator/infer.js

@@ -1,8 +0,0 @@
-/**
- * @param name
- * @returns
- */
-export function infer(name) {
-    const capitalizedName = name.charAt(0).toUpperCase() + name.slice(1);
-    return `export type ${capitalizedName} = z.infer<typeof ${capitalizedName}Schema>`;
-}

package/dist/src/generator/zod/generator/zod-code.d.ts

@@ -1,16 +0,0 @@
-/**
- * Generates Zod code for a given schema and config.
- *
- * @function generateZodCode
- * @param schema - The schema to generate code for.
- * @param config - The configuration for the code generation.
- * @returns The generated Zod code.
- */
-export declare function zodCode(schema: {
-    name: string;
-    fields: {
-        name: string;
-        definition: string;
-        description?: string;
-    }[];
-}, comment: boolean, type: boolean): string;

package/dist/src/generator/zod/generator/zod-code.js

@@ -1,18 +0,0 @@
-import { infer } from './infer.js';
-import { zod } from './zod.js';
-/**
- * Generates Zod code for a given schema and config.
- *
- * @function generateZodCode
- * @param schema - The schema to generate code for.
- * @param config - The configuration for the code generation.
- * @returns The generated Zod code.
- */
-export function zodCode(schema, comment, type) {
-    const zodSchema = zod(schema, comment);
-    if (type) {
-        const zInfer = infer(schema.name);
-        return `${zodSchema}\n\n${zInfer}\n`;
-    }
-    return `${zodSchema}\n`;
-}

package/dist/src/generator/zod/generator/zod.d.ts

@@ -1,15 +0,0 @@
-/**
- * Generates a Zod schema for a given schema and config.
- *
- * @param schema - The schema to generate code for.
- * @param config - The configuration for the code generation.
- * @returns The generated Zod schema.
- */
-export declare function zod(schema: {
-    name: string;
-    fields: {
-        name: string;
-        definition: string;
-        description?: string;
-    }[];
-}, comment: boolean): string;

package/dist/src/generator/zod/generator/zod.js

@@ -1,12 +0,0 @@
-import { fieldDefinitions } from '../../../shared/generator/field-definitions.js';
-import { schemaName } from '../../../shared/utils/index.js';
-/**
- * Generates a Zod schema for a given schema and config.
- *
- * @param schema - The schema to generate code for.
- * @param config - The configuration for the code generation.
- * @returns The generated Zod schema.
- */
-export function zod(schema, comment) {
-    return `export const ${schemaName(schema.name)} = z.object({${fieldDefinitions(schema, comment)}})`;
-}

package/dist/src/generator/zod/index.d.ts

@@ -1,10 +0,0 @@
-import type { Result } from 'neverthrow';
-/**
- * Generate Zod schema
- * @param code - The code to generate Zod schema from
- * @param output - The output file path
- * @param comment - Whether to include comments in the generated code
- * @param type - Whether to include type information in the generated code
- * @param zod - The Zod version to use
- */
-export declare function sizukuZod(code: string[], output: `${string}.ts`, comment?: boolean, type?: boolean, zod?: 'v4' | 'mini' | '@hono/zod-openapi'): Promise<Result<void, Error>>;

package/dist/src/generator/zod/index.js

@@ -1,40 +0,0 @@
-import path from 'node:path';
-import { fmt } from '../../shared/format/index.js';
-import { mkdir, writeFile } from '../../shared/fsp/index.js';
-import { buildSchemaExtractor } from '../../shared/helper/build-schema-extractor.js';
-import { createExtractFieldFromProperty } from '../../shared/helper/create-extract-field-from-property.js';
-import { createExtractFieldsFromCallExpression } from '../../shared/helper/create-extract-fields-from-call-expression.js';
-import { createExtractRelationFieldFromProperty } from '../../shared/helper/create-extract-relation-field-from-property.js';
-import { extractSchemas } from '../../shared/helper/extract-schemas.js';
-import { findObjectLiteralExpression } from '../../shared/helper/find-object-literal-expression.js';
-import { findObjectLiteralInArgs } from '../../shared/helper/find-object-literalIn-args.js';
-import { isRelationFunctionCall } from '../../shared/helper/is-relation-function.js';
-import { parseFieldComments } from '../../shared/utils/index.js';
-import { zodCode } from './generator/zod-code.js';
-/**
- * Generate Zod schema
- * @param code - The code to generate Zod schema from
- * @param output - The output file path
- * @param comment - Whether to include comments in the generated code
- * @param type - Whether to include type information in the generated code
- * @param zod - The Zod version to use
- */
-export async function sizukuZod(code, output, comment, type, zod) {
-    const extractField = createExtractFieldFromProperty((lines) => parseFieldComments(lines, '@z.'));
-    const extractRelationField = createExtractRelationFieldFromProperty((lines) => parseFieldComments(lines, '@z.'), 'z');
-    const extractFieldsFromCall = createExtractFieldsFromCallExpression(extractField, extractRelationField, findObjectLiteralExpression, findObjectLiteralInArgs, isRelationFunctionCall);
-    const extractSchema = buildSchemaExtractor(extractFieldsFromCall, extractField);
-    const importLine = zod === 'mini'
-        ? `import * as z from 'zod/mini'`
-        : zod === '@hono/zod-openapi'
-            ? `import { z } from '@hono/zod-openapi'`
-            : `import * as z from 'zod'`;
-    const zodGeneratedCode = [
-        importLine,
-        '',
-        ...extractSchemas(code, extractSchema).map((schema) => zodCode(schema, comment ?? false, type ?? false)),
-    ].join('\n');
-    return await mkdir(path.dirname(output))
-        .andThen(() => fmt(zodGeneratedCode))
-        .andThen((formatted) => writeFile(output, formatted));
-}

package/dist/src/index.d.ts

@@ -1,10 +0,0 @@
-import type { Result } from 'neverthrow';
-import type { Config } from './config/index.js';
-/**
- * Generate schemas from Drizzle table definitions.
- *
- * @param code - The code lines to process.
- * @param config - The configuration object.
- * @returns A Result indicating success or failure.
- */
-export declare function generateSchemas(code: string[], config: Config): Promise<Result<void, Error>>;

package/dist/src/index.js

@@ -1,35 +0,0 @@
-import { err, ok } from 'neverthrow';
-import { sizukuMermaidER } from './generator/mermaid-er/index.js';
-import { sizukuValibot } from './generator/valibot/index.js';
-import { sizukuZod } from './generator/zod/index.js';
-/**
- * Generate schemas from Drizzle table definitions.
- *
- * @param code - The code lines to process.
- * @param config - The configuration object.
- * @returns A Result indicating success or failure.
- */
-export async function generateSchemas(code, config) {
-    if (!config.input) {
-        return err(new Error('input is not found'));
-    }
-    const zodResult = config.zod?.output
-        ? await sizukuZod(code, config.zod.output, config.zod.comment, config.zod.type, config.zod.zod)
-        : ok(undefined);
-    if (zodResult.isErr()) {
-        return err(zodResult.error);
-    }
-    const valibotResult = config.valibot?.output
-        ? await sizukuValibot(code, config.valibot.output, config.valibot.comment, config.valibot.type)
-        : ok(undefined);
-    if (valibotResult.isErr()) {
-        return err(valibotResult.error);
-    }
-    const mermaidResult = config.mermaid?.output
-        ? await sizukuMermaidER(code, config.mermaid.output)
-        : ok(undefined);
-    if (mermaidResult.isErr()) {
-        return err(mermaidResult.error);
-    }
-    return ok(undefined);
-}

package/dist/src/shared/format/index.d.ts

@@ -1,2 +0,0 @@
-import { ResultAsync } from 'neverthrow';
-export declare function fmt(code: string): ResultAsync<string, Error>;

package/dist/src/shared/format/index.js

@@ -1,10 +0,0 @@
-import { ResultAsync } from 'neverthrow';
-import { format } from 'prettier';
-export function fmt(code) {
-    return ResultAsync.fromPromise(format(code, {
-        parser: 'typescript',
-        printWidth: 100,
-        singleQuote: true,
-        semi: false,
-    }), (e) => new Error(String(e)));
-}

package/dist/src/shared/fs/index.d.ts

@@ -1,2 +0,0 @@
-import type { Result } from 'neverthrow';
-export declare function readFileSync(path: string): Result<string, Error>;

package/dist/src/shared/fs/index.js

@@ -1,10 +0,0 @@
-import fs from 'node:fs';
-import { err, ok } from 'neverthrow';
-export function readFileSync(path) {
-    try {
-        return ok(fs.readFileSync(path, 'utf-8'));
-    }
-    catch (e) {
-        return err(new Error(String(e)));
-    }
-}

package/dist/src/shared/fsp/index.d.ts

@@ -1,3 +0,0 @@
-import { ResultAsync } from 'neverthrow';
-export declare function mkdir(path: string): ResultAsync<string | undefined, Error>;
-export declare function writeFile(path: string, data: string): ResultAsync<void, Error>;

package/dist/src/shared/fsp/index.js

@@ -1,8 +0,0 @@
-import fsp from 'node:fs/promises';
-import { ResultAsync } from 'neverthrow';
-export function mkdir(path) {
-    return ResultAsync.fromPromise(fsp.mkdir(path, { recursive: true }), (e) => new Error(String(e)));
-}
-export function writeFile(path, data) {
-    return ResultAsync.fromPromise(fsp.writeFile(path, data), (e) => new Error(String(e)));
-}

package/dist/src/shared/generator/field-definitions.d.ts

@@ -1,12 +0,0 @@
-/**
- * @param schema
- * @returns
- */
-export declare function fieldDefinitions(schema: {
-    name: string;
-    fields: {
-        name: string;
-        definition: string;
-        description?: string;
-    }[];
-}, comment: boolean): string;

package/dist/src/shared/generator/field-definitions.js

@@ -1,12 +0,0 @@
-/**
- * @param schema
- * @returns
- */
-export function fieldDefinitions(schema, comment) {
-    return schema.fields
-        .map(({ name, definition, description }) => {
-        const commentCode = description && comment ? `/**\n* ${description}\n*/\n` : '';
-        return `${commentCode}${name}:${definition}`;
-    })
-        .join(',\n');
-}

package/dist/src/shared/helper/build-schema-extractor.d.ts

@@ -1,25 +0,0 @@
-import type { CallExpression } from 'ts-morph';
-import { Node } from 'ts-morph';
-/**
- * Creates a schema extractor from customizable strategies.
- *
- * @param extractFieldsFromCall - Function to extract fields from a call expression (e.g. mysqlTable(...)).
- * @param extractFieldFromProperty - Function to extract a single field from an object literal property.
- * @returns A function that extracts a schema from a variable declaration node.
- */
-export declare function buildSchemaExtractor(extractFieldsFromCall: (call: CallExpression, sourceText: string) => {
-    name: string;
-    definition: string;
-    description?: string;
-}[], extractFieldFromProperty: (prop: Node, sourceText: string) => {
-    name: string;
-    definition: string;
-    description?: string;
-} | null): (declaration: Node, sourceText: string) => {
-    name: string;
-    fields: {
-        name: string;
-        definition: string;
-        description?: string;
-    }[];
-} | null;

package/dist/src/shared/helper/build-schema-extractor.js

@@ -1,33 +0,0 @@
-import { Node } from 'ts-morph';
-import { isRelationFunctionCall } from '../../shared/helper/is-relation-function.js';
-/**
- * Creates a schema extractor from customizable strategies.
- *
- * @param extractFieldsFromCall - Function to extract fields from a call expression (e.g. mysqlTable(...)).
- * @param extractFieldFromProperty - Function to extract a single field from an object literal property.
- * @returns A function that extracts a schema from a variable declaration node.
- */
-export function buildSchemaExtractor(extractFieldsFromCall, extractFieldFromProperty) {
-    return (declaration, sourceText) => {
-        if (!Node.isVariableDeclaration(declaration))
-            return null;
-        const name = declaration.getName();
-        if (!name)
-            return null;
-        const initializer = declaration.getInitializer();
-        if (Node.isCallExpression(initializer)) {
-            if (isRelationFunctionCall(initializer))
-                return null;
-            const fields = extractFieldsFromCall(initializer, sourceText);
-            return { name, fields };
-        }
-        if (Node.isObjectLiteralExpression(initializer)) {
-            const fields = initializer
-                .getProperties()
-                .map((prop) => extractFieldFromProperty(prop, sourceText))
-                .filter((field) => field !== null);
-            return { name, fields };
-        }
-        return { name, fields: [] };
-    };
-}

package/dist/src/shared/helper/create-extract-field-from-property.d.ts

@@ -1,15 +0,0 @@
-import { Node } from 'ts-morph';
-/**
- * Creates a field extractor function using a custom parseFieldComments implementation.
- *
- * @param parseFieldComments - A function that parses comment lines into { definition, description }
- * @returns A property node extractor function.
- */
-export declare function createExtractFieldFromProperty(parseFieldComments: (commentLines: string[]) => {
-    definition: string;
-    description?: string;
-}): (property: Node, sourceText: string) => {
-    name: string;
-    definition: string;
-    description?: string;
-} | null;

package/dist/src/shared/helper/create-extract-field-from-property.js

@@ -1,20 +0,0 @@
-import { Node } from 'ts-morph';
-import { extractFieldComments } from '../../shared/utils/index.js';
-/**
- * Creates a field extractor function using a custom parseFieldComments implementation.
- *
- * @param parseFieldComments - A function that parses comment lines into { definition, description }
- * @returns A property node extractor function.
- */
-export function createExtractFieldFromProperty(parseFieldComments) {
-    return (property, sourceText) => {
-        if (!Node.isPropertyAssignment(property))
-            return null;
-        const name = property.getName();
-        if (!name)
-            return null;
-        const commentLines = extractFieldComments(sourceText, property.getStart());
-        const { definition, description } = parseFieldComments(commentLines);
-        return { name, definition, description };
-    };
-}

package/dist/src/shared/helper/create-extract-fields-from-call-expression.d.ts

@@ -1,14 +0,0 @@
-import type { CallExpression, Node, ObjectLiteralExpression } from 'ts-morph';
-export declare function createExtractFieldsFromCallExpression(extractFieldFromProperty: (property: Node, sourceText: string) => {
-    name: string;
-    definition: string;
-    description?: string;
-} | null, extractRelationFieldFromProperty: (property: Node, sourceText: string) => {
-    name: string;
-    definition: string;
-    description?: string;
-} | null, findObjectLiteralExpression: (expr: Node) => ObjectLiteralExpression | null, findObjectLiteralInArgs: (call: CallExpression, finder: (expr: Node) => ObjectLiteralExpression | null) => ObjectLiteralExpression | null, isRelationFunctionCall: (call: CallExpression) => boolean): (callExpr: CallExpression, sourceText: string) => {
-    name: string;
-    definition: string;
-    description?: string;
-}[];

package/dist/src/shared/helper/create-extract-fields-from-call-expression.js

@@ -1,14 +0,0 @@
-export function createExtractFieldsFromCallExpression(extractFieldFromProperty, extractRelationFieldFromProperty, findObjectLiteralExpression, findObjectLiteralInArgs, isRelationFunctionCall) {
-    return (callExpr, sourceText) => {
-        const objectLiteral = findObjectLiteralInArgs(callExpr, findObjectLiteralExpression);
-        if (!objectLiteral)
-            return [];
-        const isRelation = isRelationFunctionCall(callExpr);
-        return objectLiteral
-            .getProperties()
-            .map((prop) => isRelation
-            ? extractRelationFieldFromProperty(prop, sourceText)
-            : extractFieldFromProperty(prop, sourceText))
-            .filter((field) => field !== null);
-    };
-}

package/dist/src/shared/helper/create-extract-relation-field-from-property.d.ts

@@ -1,12 +0,0 @@
-import { Node } from 'ts-morph';
-export declare const createExtractRelationFieldFromProperty: (parseFieldComments: (lines: string[]) => {
-    definition: string;
-    description?: string;
-}, prefix: "v" | "z") => (property: Node, sourceText: string) => {
-    name: string;
-    fields: {
-        name: string;
-        definition: string;
-        description?: string;
-    }[];
-}["fields"][0] | null;