@xyd-js/uniform 0.0.0-build-099b7bb-20250918135344 → 0.0.0-build-9f87f13-20250930210637

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/types.ts","../src/index.ts","../src/plugins/pluginJsonView.ts","../src/plugins/pluginNavigation.ts"],"sourcesContent":["import React from \"react\";\nimport {HighlightedCode} from \"codehike/code\";\n\n// TODO: type, and category also as generic?\nexport interface Reference<\n    C = ReferenceContext,\n    M extends DefinitionMeta = DefinitionMeta,\n    VM extends DefinitionVariantMeta = DefinitionVariantMeta\n> {\n    title: string;\n    description: string | React.ReactNode;\n    canonical: string;\n\n    definitions: Definition<M, VM>[] // TODO: in the future from generic?\n    examples: ExampleRoot\n\n\n    category?: ReferenceCategory; // TODO: do we need that?\n\n    type?: ReferenceType; // TODO: do we need that?\n\n    context?: C;\n\n    /**\n     * TODO: !!!! BETTER !!!!\n     * @internal\n     */\n    __UNSAFE_selector?: (selector: string) => any;\n}\n\nexport type DefinitionOpenAPIMeta = Meta<\"contentType\" | \"required\" | \"definitionDescription\">;\nexport type DefinitionTypeDocMeta = Meta<\"type\">;\nexport type DefinitionGraphqlMeta = Meta<\"type\" | \"graphqlName\">;\n\nexport type DefinitionMeta = DefinitionOpenAPIMeta | DefinitionTypeDocMeta | DefinitionGraphqlMeta\n\nexport type SymbolDef = {\n    id?: string | string[];\n\n    canonical?: string | string[];\n}\n\nexport interface Definition<\n    M extends DefinitionMeta = DefinitionMeta,\n    VM extends DefinitionVariantMeta = DefinitionVariantMeta\n> {\n    title: string;\n\n    properties: DefinitionProperty[];\n\n    rootProperty?: DefinitionProperty\n\n    variants?: DefinitionVariant<VM>[];\n\n    description?: string | React.ReactNode;\n\n    meta?: M[];\n\n    /**\n     * @internal\n     */\n    symbolDef?: SymbolDef;\n\n    /**\n     * @internal\n     */\n    id?: string;\n\n    /**\n     * @internal\n     */\n    type?: string;\n}\n\nexport type DefinitionVariantOpenAPIMeta = Meta<\"status\" | \"contentType\" | \"definitionDescription\" | \"required\">;\nexport type CommonDefinitionVariantMeta = Meta<\"symbolName\">;\n\nexport type DefinitionVariantMeta = CommonDefinitionVariantMeta | DefinitionVariantOpenAPIMeta\n\nexport interface DefinitionVariant<\n    M extends DefinitionVariantMeta = DefinitionVariantMeta\n> {\n    title: string;\n\n    properties: DefinitionProperty[];\n\n    rootProperty?: DefinitionProperty\n\n    description?: string | React.ReactNode;\n\n    symbolDef?: SymbolDef;\n\n    meta?: M[];\n}\n\nexport interface Meta<T = string> {\n    name: T;\n\n    value?: unknown; // TODO: better type?\n}\n\nexport type DefinitionPropertyMeta = Meta<\"required\" | \"deprecated\" | \"internal\" | \"defaults\" | \"nullable\" | \"example\" | \"examples\" | \"minimum\" | \"maximum\" | \"enum-type\"> // TODO: better solution than enum-type?\n\nexport enum DEFINED_DEFINITION_PROPERTY_TYPE {\n    UNION = \"$$union\",\n\n    XOR = \"$$xor\",\n\n    ARRAY = \"$$array\",\n\n    ENUM = \"$$enum\",\n\n    // TYPE = \"$$type\", TODO: good idea?\n}\n\nexport interface DefinitionProperty {\n    name: string;\n\n    type: string | DEFINED_DEFINITION_PROPERTY_TYPE\n\n    description: string | React.ReactNode;\n\n    // TODO: in the future more advanced examples?\n    examples?: string | string[];\n\n    symbolDef?: SymbolDef;\n\n    meta?: DefinitionPropertyMeta[];\n\n    context?: any // TODO: better type\n\n    properties?: DefinitionProperty[];\n\n    ofProperty?: DefinitionProperty;\n}\n\nexport interface ExampleRoot {\n    groups: ExampleGroup[];\n}\n\nexport interface ExampleGroup {\n    description?: string;\n\n    examples: Example[];\n}\n\nexport interface Example {\n    description?: string; // TODO: replace with title ?\n\n    codeblock: CodeBlock;\n}\n\nexport interface CodeBlock {\n    title?: string;\n\n    tabs: CodeBlockTab[];\n}\n\nexport interface CodeBlockTab {\n    // title of the tab e.g \"JavaScript\"\n    title: string;\n\n    // code in the tab e.g \"console.log('Hello World')\"\n    code: string\n\n    // language of the code e.g \"js\"\n    language: string;\n\n    // context of the generation method e.g openapi or graphql\n    context?: ExampleContext;\n\n    // TODO: highlighted code\n    highlighted?: HighlightedCode;\n}\n\nexport type ExampleContext = GraphQLExampleContext | OpenAPIExampleContext;\n\n// TODO: concept only\nexport enum ReferenceCategory {\n    // for React\n    COMPONENTS = \"components\",\n    HOOKS = \"hooks\",\n    // end for React\n\n    // for API\n    REST = \"rest\",\n    GRAPHQL = \"graphql\",\n    // end for API\n\n    // for code\n    FUNCTIONS = \"functions\",\n    //\n}\n\n// TODO: concept only\nexport enum ReferenceType {\n    // for React\n    COMPONENT = \"component\",\n    HOOK = \"hook\",\n    // end for React\n\n    // for API\n    // TODO: better type system for specific api typesl like gql or rest\n    REST_HTTP_GET = \"rest_get\",\n    REST_HTTP_POST = \"rest_post\",\n    REST_HTTP_PUT = \"rest_put\",\n    REST_HTTP_PATCH = \"rest_patch\",\n    REST_HTTP_DELETE = \"rest_delete\",\n    REST_HTTP_OPTIONS = \"rest_options\",\n    REST_HTTP_HEAD = \"rest_head\",\n    REST_HTTP_TRACE = \"rest_trace\",\n\n    REST_COMPONENT_SCHEMA = \"rest_component_schema\",\n    // ---\n    GRAPHQL_QUERY = \"graphql_query\",\n    GRAPHQL_MUTATION = \"graphql_mutation\",\n    GRAPHQL_SUBSCRIPTION = \"graphql_subscription\",\n\n    GRAPHQL_SCALAR = \"graphql_scalar\",\n    GRAPHQL_OBJECT = \"graphql_object\",\n    GRAPHQL_INTERFACE = \"graphql_interface\",\n    GRAPHQL_UNION = \"graphql_union\",\n    GRAPHQL_ENUM = \"graphql_enum\",\n    GRAPHQL_INPUT = \"graphql_input\",\n    // end for API\n\n    // for code\n    FUNCTION_JS = \"function_js\",\n    // end for code\n}\n\nexport interface BaseReferenceContext {\n    group?: string[];\n\n    scopes?: string[];\n}\n\nexport interface GraphQLReferenceContext extends BaseReferenceContext {\n    /**\n     * @internal\n     */\n    graphqlTypeShort: string;\n\n    graphqlName: string;\n}\n\n// TODO: custom value?\nexport interface OpenAPIReferenceContext extends BaseReferenceContext {\n    method?: string;\n\n    path?: string;\n\n    fullPath?: string;\n\n    componentSchema?: string\n\n    servers?: string[]\n}\n\nexport type TypeDocReferenceContextMeta = Meta<\"internal\">\n\n// Add TypeDocReferenceContext to the union type\nexport interface TypeDocReferenceContext extends BaseReferenceContext {\n    symbolId: string;\n    symbolName: string;\n    symbolKind: number;\n    packageName: string;\n    fileName: string;\n    fileFullPath: string;\n    line: number;\n    col: number;\n    signatureText: {\n        code: string;\n        lang: string;\n    };\n    sourcecode: {\n        code: string;\n        lang: string;\n    };\n    category?: string;\n    meta?: TypeDocReferenceContextMeta[]\n}\n\nexport type ReferenceContext = GraphQLReferenceContext | OpenAPIReferenceContext | TypeDocReferenceContext\n\nexport interface GraphQLExampleContext {\n    schema?: any; // TODO:\n}\n\nexport interface OpenAPIExampleContext {\n    status?: number;\n\n    content?: string;\n}\n\n\n","// Define the new PluginV type with a callback function that returns another function\nimport {Reference} from \"./types\";\n\nexport * from \"./types\";\n\n// Define the new PluginV type with a callback function that returns another function\nexport type UniformPluginArgs = {\n    references: Reference[] | Reference,\n    defer: (defer: () => any) => void;\n\n    // TODO: maybe in the future\n    // visit: (selector: string | \"[method] [path]\", callback: (...args: any[]) => void) => void;\n}\n\n\nexport type UniformPluginRestArgs = {\n    index: number;\n}\nexport type UniformPlugin<T> = (args: UniformPluginArgs) => (ref: Reference, restArgs: UniformPluginRestArgs) => void;\n\n// Utility type to infer if a type is an array and avoid wrapping it into an array twice\ntype NormalizeArray<T> = T extends Array<infer U> ? U[] : T;\n\n// Infer the return type of the plugin callback properly and normalize array types\ntype PluginResult<T extends UniformPlugin<any>> = T extends UniformPlugin<infer R> ? R : never;\n\n// Merge all plugin return types into a single object and normalize arrays\ntype MergePluginResults<T extends UniformPlugin<any>[]> = {\n    [K in keyof UnionToIntersection<PluginResult<T[number]>>]: NormalizeArray<UnionToIntersection<PluginResult<T[number]>>[K]>\n};\n\n// Utility type to handle intersection to an object type\ntype UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends (k: infer I) => void ? I : never;\n\n// Implement the uniform function\nexport default function uniform<T extends UniformPlugin<any>[]>(\n    references: Reference[],\n    config: { plugins: T }\n) {\n    // Infer the merged result type from all plugins\n    type ResultType = MergePluginResults<T>;\n\n    // Initialize the response with a type-safe out object\n    const response: {\n        references: Reference[]\n        out: { [K in keyof ResultType]: ResultType[K] }\n    } = {\n        references,\n        out: {} as { [K in keyof ResultType]: ResultType[K] }\n    };\n\n    config.plugins.forEach((plugin) => {\n        let defer: any = undefined; // fix any\n\n        const call = plugin({\n            references: references,\n            defer: (cb) => {\n                if (typeof cb === \"function\") {\n                    defer = cb\n                }\n            },\n            // visit: (pattern, callback) => {\n            // }\n        })\n\n        references.map((ref, i) => {\n            call(ref, {\n                index: i,\n            })\n        });\n\n        if (typeof defer === \"function\") {\n            const resp = defer()\n            if (typeof resp !== \"object\") {\n                throw new Error(`Invalid callback return type: ${typeof resp}`)\n            }\n\n            response.out = {\n                ...response.out,\n                ...resp\n            }\n        }\n    })\n\n    return response;\n}\n\n// Example usage\n// const examplePlugin: UniformPlugin<{ value: boolean }> = (cb) => {\n//     return (ref: Reference) => {\n//     };\n// };\n// function examplePlugin(defer: (defer: () => { value: boolean }) => void) {\n//     defer(() => ({\n//         value: true,\n//     }));\n//\n//     return (ref: Reference) => {\n//\n//     };\n// }\n// const response = uniform([/* references */], {\n//     plugins: [examplePlugin],\n// });\n// response.out\n","import type { UniformPluginArgs, UniformPlugin } from \"../index\";\nimport { Reference } from \"../types\";\n\nexport interface pluginJsonViewOptions {\n}\n\ntype pluginJsonViewOutput = {\n    jsonViews: string;\n}\n\nexport function pluginJsonView(\n    options?: pluginJsonViewOptions\n): UniformPlugin<pluginJsonViewOutput> {\n\n    return function pluginJsonViewInner({\n        defer,\n    }: UniformPluginArgs) {\n        const jsonViews: string[] = [];\n\n        defer(() => ({\n            jsonViews\n        }))\n\n        return (ref: Reference) => {\n            // Build the output string manually to ensure exact format\n            const lines: string[] = [];\n            lines.push('{');\n            \n            ref.definitions.forEach(def => {\n                def.properties.forEach((prop, index) => {\n                    // Remove any quotes and trailing characters from the value\n                    const value = (prop.examples?.[0] || '').replace(/^\"|\"$|[^a-zA-Z0-9\\s\\-_.,:/@#=;+()]/g, '');\n                    const comment = prop.examples && prop.examples.length > 1 \n                        ? ` // or \"${(prop.examples as string[])[1].replace(/^\"|\"$|[^a-zA-Z0-9\\s\\-_.,:/@#=;+()]/g, '')}\"`\n                        : '';\n                    const isLast = index === def.properties.length - 1;\n                    // Add comma after the value but before the comment\n                    lines.push(`    \"${prop.name}\": \"${value}\"${isLast ? '' : ','}${comment}`);\n                });\n            });\n            \n            lines.push('}');\n            \n            jsonViews.push(lines.join('\\n'));\n        }\n    }\n}\n\n// example usage:\n// const response = uniform([/* references */], {\n//     plugins: [pluginJsonView({\n//         \n//     })],\n// });\n","import path from 'node:path';\n\nimport type { Sidebar, Metadata, MetadataMap, Settings, PageURL } from \"@xyd-js/core\";\n\nimport type { UniformPluginArgs, UniformPlugin } from \"../index\";\nimport { CodeBlockTab, Example, ExampleGroup, Reference } from \"../types\";\n\nconst DEFAULT_VIRTUAL_FOLDER = \".xyd/.cache/.content\" // TODO: share this + .xyd/.build/.content for build\n\nconst DEFAULT_GROUP_NAME = \"API Reference\" // TODO: configurable\n\ntype GroupMap = {\n    [key: string]: {\n        __groups: GroupMap\n        pages: Set<string>\n    }\n}\n\nexport interface pluginNavigationOptions {\n    urlPrefix: string\n    defaultGroup?: string\n}\n\ntype pluginNavigationOutput = {\n    pageFrontMatter: MetadataMap;\n    sidebar: Sidebar[];\n}\n\nexport function pluginNavigation(\n    settings: Settings,\n    options: pluginNavigationOptions\n): UniformPlugin<pluginNavigationOutput> {\n    // if (!options.urlPrefix) {\n    //     throw new Error(\"urlPrefix is required\")\n    // }\n\n    return function pluginNavigationInner({\n        defer,\n    }: UniformPluginArgs) {\n        const pageFrontMatter: MetadataMap = {}\n        const groupMaps: GroupMap = {}\n\n        defer(() => ({\n            pageFrontMatter,\n            sidebar: convertGroupMapsToSidebar(settings, groupMaps) as Sidebar[]\n        }))\n\n        return (ref: Reference) => {\n            const dataCtx = ref.context\n            const pagePath = path.join(options.urlPrefix, ref.canonical)\n\n            let group = dataCtx?.group || []\n            let title = ref.title\n\n            if (pageFrontMatter[pagePath]) {\n                console.error(\"(pluginNavigation): pageFrontMatter[pagePath] already exists\", pagePath)\n            }\n\n            if (!group) {\n                group = [options.defaultGroup || DEFAULT_GROUP_NAME]\n            }\n\n            pageFrontMatter[pagePath] = {\n                title,\n            }\n\n            if (typeof group === \"string\") {\n                // TODO: seek nested group (it's not always from 0)\n                throw new Error(\"group as string is not supported yet\")\n            }\n\n            group.reduce((groups: GroupMap, groupName: string, i: number) => {\n                if (!groups[groupName]) {\n                    groups[groupName] = {\n                        __groups: {},\n                        pages: new Set()\n                    }\n                }\n\n                if (i === group.length - 1) {\n                    groups[groupName].pages.add(pagePath)\n                }\n\n                return groups[groupName].__groups\n            }, groupMaps)\n        }\n    }\n}\n\nfunction convertGroupMapsToSidebar(settings: Settings, groupMaps: GroupMap): Sidebar[] {\n    const nav: Sidebar[] = []\n\n    Object.keys(groupMaps).map((groupName) => {\n        const current = groupMaps[groupName]\n\n        const pages: PageURL[] = []\n\n        current.pages.forEach((page: string) => {\n            if (settings?.engine?.uniform?.store) {\n                pages.push(page)\n                return\n            }\n            pages.push({\n                virtual: path.join(DEFAULT_VIRTUAL_FOLDER, page),\n                page: page,\n            })\n        })\n\n        if (Object.keys(current.__groups).length) {\n            const subNav: Sidebar = {\n                group: groupName,\n                pages: convertGroupMapsToSidebar(settings, current.__groups)\n            }\n\n            nav.push(subNav)\n\n            return\n        }\n\n        nav.push({\n            group: groupName,\n            pages,\n        })\n    })\n\n    return nav\n}\n\n// TODO: in the future xyd settings must be removed cuz uniform will be part of opendocs\n// example usage:\n// const response = uniform([/* references */], {\n//     plugins: [pluginNavigation({}, {\n//         urlPrefix: \"/docs\"\n//     })],\n// });\n"],"mappings":"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","names":["DEFINED_DEFINITION_PROPERTY_TYPE","ReferenceCategory","ReferenceType"]}
+{"version":3,"sources":["../src/types.ts","../src/converters.ts","../src/index.ts","../src/plugins/pluginJsonView.ts","../src/plugins/pluginNavigation.ts"],"sourcesContent":["import React from \"react\";\nimport {HighlightedCode} from \"codehike/code\";\n\n// TODO: type, and category also as generic?\nexport interface Reference<\n    C = ReferenceContext,\n    M extends DefinitionMeta = DefinitionMeta,\n    VM extends DefinitionVariantMeta = DefinitionVariantMeta\n> {\n    title: string;\n    description: string | React.ReactNode;\n    canonical: string;\n\n    definitions: Definition<M, VM>[] // TODO: in the future from generic?\n    examples: ExampleRoot\n\n\n    category?: ReferenceCategory; // TODO: do we need that?\n\n    type?: ReferenceType; // TODO: do we need that?\n\n    context?: C;\n\n    /**\n     * TODO: !!!! BETTER !!!!\n     * @internal\n     */\n    __UNSAFE_selector?: (selector: string) => any;\n}\n\nexport type DefinitionOpenAPIMeta = Meta<\"contentType\" | \"required\" | \"definitionDescription\">;\nexport type DefinitionTypeDocMeta = Meta<\"type\">;\nexport type DefinitionGraphqlMeta = Meta<\"type\" | \"graphqlName\">;\n\nexport type DefinitionMeta = DefinitionOpenAPIMeta | DefinitionTypeDocMeta | DefinitionGraphqlMeta\n\nexport type SymbolDef = {\n    id?: string | string[];\n\n    canonical?: string | string[];\n}\n\nexport type DefinitionTypeREST = \"$rest.param.path\" | \"$rest.param.query\" | \"$rest.param.header\" | \"$rest.param.cookie\" | \"$rest.request.body\"\n\nexport interface Definition<\n    M extends DefinitionMeta = DefinitionMeta,\n    VM extends DefinitionVariantMeta = DefinitionVariantMeta\n> {\n    title: string;\n\n    properties: DefinitionProperty[];\n\n    rootProperty?: DefinitionProperty\n\n    variants?: DefinitionVariant<VM>[];\n\n    description?: string | React.ReactNode;\n\n    meta?: M[];\n\n    /**\n     * @internal\n     */\n    symbolDef?: SymbolDef;\n\n    /**\n     * @internal\n     */\n    id?: string;\n\n    /**\n     * @internal\n     */\n    type?: \"return\" | DefinitionTypeREST\n}\n\nexport type DefinitionVariantOpenAPIMeta = Meta<\"status\" | \"contentType\" | \"definitionDescription\" | \"required\">;\nexport type CommonDefinitionVariantMeta = Meta<\"symbolName\">;\n\nexport type DefinitionVariantMeta = CommonDefinitionVariantMeta | DefinitionVariantOpenAPIMeta\n\nexport interface DefinitionVariant<\n    M extends DefinitionVariantMeta = DefinitionVariantMeta\n> {\n    title: string;\n\n    properties: DefinitionProperty[];\n\n    rootProperty?: DefinitionProperty\n\n    description?: string | React.ReactNode;\n\n    symbolDef?: SymbolDef;\n\n    meta?: M[];\n}\n\nexport interface Meta<T = string> {\n    name: T;\n\n    value?: unknown; // TODO: better type?\n}\n\nexport type DefinitionPropertyMeta = Meta<\"required\" | \"deprecated\" | \"internal\" | \"defaults\" | \"nullable\" | \"example\" | \"examples\" | \"minimum\" | \"maximum\" | \"enum-type\"> // TODO: better solution than enum-type?\n\nexport enum DEFINED_DEFINITION_PROPERTY_TYPE {\n    UNION = \"$$union\",\n\n    XOR = \"$$xor\",\n\n    ARRAY = \"$$array\",\n\n    ENUM = \"$$enum\",\n\n    // TYPE = \"$$type\", TODO: good idea?\n}\n\nexport interface DefinitionProperty {\n    name: string;\n\n    type: string | DEFINED_DEFINITION_PROPERTY_TYPE\n\n    description: string | React.ReactNode;\n\n    // TODO: in the future more advanced examples?\n    examples?: string | string[];\n\n    symbolDef?: SymbolDef;\n\n    meta?: DefinitionPropertyMeta[];\n\n    context?: any // TODO: better type\n\n    properties?: DefinitionProperty[];\n\n    ofProperty?: DefinitionProperty;\n}\n\nexport interface ExampleRoot {\n    groups: ExampleGroup[];\n}\n\nexport interface ExampleGroup {\n    description?: string;\n\n    examples: Example[];\n}\n\nexport interface Example {\n    description?: string; // TODO: replace with title ?\n\n    codeblock: CodeBlock;\n}\n\nexport interface CodeBlock {\n    title?: string;\n\n    tabs: CodeBlockTab[];\n}\n\nexport interface CodeBlockTab {\n    // title of the tab e.g \"JavaScript\"\n    title: string;\n\n    // code in the tab e.g \"console.log('Hello World')\"\n    code: string\n\n    // language of the code e.g \"js\"\n    language: string;\n\n    // context of the generation method e.g openapi or graphql\n    context?: ExampleContext;\n\n    // TODO: highlighted code\n    highlighted?: HighlightedCode;\n}\n\nexport type ExampleContext = GraphQLExampleContext | OpenAPIExampleContext;\n\n// TODO: concept only\nexport enum ReferenceCategory {\n    // for React\n    COMPONENTS = \"components\",\n    HOOKS = \"hooks\",\n    // end for React\n\n    // for API\n    REST = \"rest\",\n    GRAPHQL = \"graphql\",\n    // end for API\n\n    // for code\n    FUNCTIONS = \"functions\",\n    //\n}\n\n// TODO: concept only\nexport enum ReferenceType {\n    // for React\n    COMPONENT = \"component\",\n    HOOK = \"hook\",\n    // end for React\n\n    // for API\n    // TODO: better type system for specific api typesl like gql or rest\n    REST_HTTP_GET = \"rest_get\",\n    REST_HTTP_POST = \"rest_post\",\n    REST_HTTP_PUT = \"rest_put\",\n    REST_HTTP_PATCH = \"rest_patch\",\n    REST_HTTP_DELETE = \"rest_delete\",\n    REST_HTTP_OPTIONS = \"rest_options\",\n    REST_HTTP_HEAD = \"rest_head\",\n    REST_HTTP_TRACE = \"rest_trace\",\n\n    REST_COMPONENT_SCHEMA = \"rest_component_schema\",\n    // ---\n    GRAPHQL_QUERY = \"graphql_query\",\n    GRAPHQL_MUTATION = \"graphql_mutation\",\n    GRAPHQL_SUBSCRIPTION = \"graphql_subscription\",\n\n    GRAPHQL_SCALAR = \"graphql_scalar\",\n    GRAPHQL_OBJECT = \"graphql_object\",\n    GRAPHQL_INTERFACE = \"graphql_interface\",\n    GRAPHQL_UNION = \"graphql_union\",\n    GRAPHQL_ENUM = \"graphql_enum\",\n    GRAPHQL_INPUT = \"graphql_input\",\n    // end for API\n\n    // for code\n    FUNCTION_JS = \"function_js\",\n    // end for code\n}\n\nexport interface BaseReferenceContext {\n    group?: string[];\n\n    scopes?: string[];\n}\n\nexport interface GraphQLReferenceContext extends BaseReferenceContext {\n    /**\n     * @internal\n     */\n    graphqlTypeShort: string;\n\n    graphqlName: string;\n}\n\n// TODO: custom value?\nexport interface OpenAPIReferenceContext extends BaseReferenceContext {\n    method?: string;\n\n    path?: string;\n\n    fullPath?: string;\n\n    componentSchema?: string\n\n    servers?: string[]\n}\n\nexport type TypeDocReferenceContextMeta = Meta<\"internal\">\n\n// Add TypeDocReferenceContext to the union type\nexport interface TypeDocReferenceContext extends BaseReferenceContext {\n    symbolId: string;\n    symbolName: string;\n    symbolKind: number;\n    packageName: string;\n    fileName: string;\n    fileFullPath: string;\n    line: number;\n    col: number;\n    signatureText: {\n        code: string;\n        lang: string;\n    };\n    sourcecode: {\n        code: string;\n        lang: string;\n    };\n    category?: string;\n    meta?: TypeDocReferenceContextMeta[]\n}\n\nexport type ReferenceContext = GraphQLReferenceContext | OpenAPIReferenceContext | TypeDocReferenceContext\n\nexport interface GraphQLExampleContext {\n    schema?: any; // TODO:\n}\n\nexport interface OpenAPIExampleContext {\n    status?: number;\n\n    content?: string;\n}\n\n\n","import {DEFINED_DEFINITION_PROPERTY_TYPE, DefinitionProperty, Reference} from \"./types\";\nimport {JSONSchema7, JSONSchema7TypeName} from \"json-schema\";\n\nexport function uniformToInputJsonSchema(reference: Reference): JSONSchema7 | null {\n    if (!reference?.definitions?.length) {\n        return null;\n    }\n\n    const inputDefinitions: JSONSchema7[] = [];\n\n    for (const def of reference.definitions) {\n        if (def?.type === \"return\") {\n            continue;\n        }\n\n        // Process each definition\n        const definitionSchemas: JSONSchema7[] = [];\n\n        // Add main properties if they exist\n        if (def?.properties?.length) {\n            const result = uniformPropertiesToJsonSchema(def.properties, def.type);\n            if (result) {\n                definitionSchemas.push(result as JSONSchema7);\n            }\n        }\n\n        // Add variant properties if they exist\n        if (def?.variants?.length) {\n            const variantSchemas: JSONSchema7[] = [];\n            \n            for (const variant of def.variants) {\n                if (variant?.properties?.length) {\n                    const result = uniformPropertiesToJsonSchema(variant.properties, def.type);\n                    if (result) {\n                        variantSchemas.push(result as JSONSchema7);\n                    }\n                }\n            }\n\n            // If there are variants, use oneOf\n            if (variantSchemas.length > 0) {\n                if (variantSchemas.length === 1) {\n                    definitionSchemas.push(variantSchemas[0]);\n                } else {\n                    definitionSchemas.push({\n                        oneOf: variantSchemas\n                    });\n                }\n            }\n        }\n\n        // Add this definition's schema(s) to the input definitions\n        if (definitionSchemas.length === 1) {\n            inputDefinitions.push(definitionSchemas[0]);\n        } else if (definitionSchemas.length > 1) {\n            inputDefinitions.push({\n                allOf: definitionSchemas\n            });\n        }\n    }\n\n    // Return the final schema\n    if (inputDefinitions.length === 0) {\n        return null;\n    } else if (inputDefinitions.length === 1) {\n        return inputDefinitions[0];\n    } else {\n        // Multiple definitions use allOf\n        return {\n            allOf: inputDefinitions\n        };\n    }\n}\n\nexport function uniformPropertiesToJsonSchema(\n    properties: DefinitionProperty[] | DefinitionProperty,\n    id?: string\n): JSONSchema7 | null {\n    if (Array.isArray(properties)) {\n        let jsonSchemaProps: { [key: string]: JSONSchema7 } = {};\n        let requiredFields: string[] = [];\n\n        if (properties.length) {\n            for (const property of properties) {\n                const v = uniformPropertiesToJsonSchema(property);\n                if (v) {\n                    jsonSchemaProps[property.name] = v;\n                }\n\n                // Check if property is required\n                const isRequired = property.meta?.some(\n                    (meta) => meta.name === \"required\" && meta.value === \"true\"\n                );\n                if (isRequired) {\n                    requiredFields.push(property.name);\n                }\n            }\n        }\n\n        const schema: JSONSchema7 = {\n            $id: id || undefined,\n            type: \"object\",\n            properties: jsonSchemaProps,\n        };\n\n        // Only add required array if there are required fields\n        if (requiredFields.length > 0) {\n            schema.required = requiredFields;\n        }\n\n        return schema;\n    }\n\n    // Handle enum types\n    if (properties.type === DEFINED_DEFINITION_PROPERTY_TYPE.ENUM) {\n        const schema: JSONSchema7 = {\n            description: properties.description as string,\n        };\n\n        // Get the base type from ofProperty or meta\n        const enumType: string =\n            (properties.ofProperty && (properties.ofProperty as any).type) ||\n            (properties.meta?.find((meta) => meta.name === \"enum-type\")\n                ?.value as string) ||\n            \"string\";\n\n        schema.type = enumType as JSONSchema7TypeName;\n\n        // Extract enum values from properties array\n        if (properties.properties && properties.properties.length > 0) {\n            schema.enum = properties.properties.map((prop) => prop.name);\n        }\n\n        return schema;\n    }\n\n    // Handle array types\n    if (properties.type === DEFINED_DEFINITION_PROPERTY_TYPE.ARRAY) {\n        const schema: JSONSchema7 = {\n            type: \"array\",\n            description: properties.description as string,\n        };\n\n        // Set items schema from ofProperty\n        if (properties.ofProperty) {\n            const itemsSchema = uniformPropertiesToJsonSchema(properties.ofProperty);\n            if (itemsSchema) {\n                schema.items = itemsSchema;\n            }\n        }\n\n        return schema;\n    }\n\n    // Handle XOR (oneOf) types\n    if (properties.type === DEFINED_DEFINITION_PROPERTY_TYPE.XOR) {\n        const schema: JSONSchema7 = {\n            description: properties.description as string,\n        };\n\n        // Convert properties array to oneOf schemas\n        if (properties.properties && properties.properties.length > 0) {\n            schema.oneOf = properties.properties\n                .map((prop) => {\n                    const propSchema = uniformPropertiesToJsonSchema(prop);\n                    return propSchema || {};\n                })\n                .filter((schema) => Object.keys(schema).length > 0);\n        }\n\n        return schema;\n    }\n\n    // Handle UNION (anyOf) types\n    if (properties.type === DEFINED_DEFINITION_PROPERTY_TYPE.UNION) {\n        const schema: JSONSchema7 = {\n            description: properties.description as string,\n        };\n\n        // Convert properties array to anyOf schemas\n        if (properties.properties && properties.properties.length > 0) {\n            schema.anyOf = properties.properties\n                .map((prop) => {\n                    const propSchema = uniformPropertiesToJsonSchema(prop);\n                    return propSchema || {};\n                })\n                .filter((schema) => Object.keys(schema).length > 0);\n        }\n\n        return schema;\n    }\n\n    if (properties.ofProperty) {\n        return uniformPropertiesToJsonSchema(properties.ofProperty);\n    }\n\n    // Build the schema for single property\n    const schema: JSONSchema7 = {\n        type: properties.type as JSONSchema7TypeName,\n        description: properties.description as string,\n    };\n\n    // Handle object types with nested properties\n    if (properties.type === \"object\" && properties.properties && properties.properties.length > 0) {\n        const nestedSchema = uniformPropertiesToJsonSchema(properties.properties);\n        if (nestedSchema && nestedSchema.properties) {\n            schema.properties = nestedSchema.properties;\n            if (nestedSchema.required) {\n                schema.required = nestedSchema.required;\n            }\n        }\n    }\n\n    return schema;\n}\n","// Define the new PluginV type with a callback function that returns another function\nimport {Reference} from \"./types\";\n\nexport {\n    uniformToInputJsonSchema,\n    uniformPropertiesToJsonSchema\n} from \"./converters\";\n\nexport * from \"./types\";\n\n// Define the new PluginV type with a callback function that returns another function\nexport type UniformPluginArgs = {\n    references: Reference[] | Reference,\n    defer: (defer: () => any) => void;\n\n    // TODO: maybe in the future\n    // visit: (selector: string | \"[method] [path]\", callback: (...args: any[]) => void) => void;\n}\n\n\nexport type UniformPluginRestArgs = {\n    index: number;\n}\nexport type UniformPlugin<T> = (args: UniformPluginArgs) => (ref: Reference, restArgs: UniformPluginRestArgs) => void;\n\n// Utility type to infer if a type is an array and avoid wrapping it into an array twice\ntype NormalizeArray<T> = T extends Array<infer U> ? U[] : T;\n\n// Infer the return type of the plugin callback properly and normalize array types\ntype PluginResult<T extends UniformPlugin<any>> = T extends UniformPlugin<infer R> ? R : never;\n\n// Merge all plugin return types into a single object and normalize arrays\ntype MergePluginResults<T extends UniformPlugin<any>[]> = {\n    [K in keyof UnionToIntersection<PluginResult<T[number]>>]: NormalizeArray<UnionToIntersection<PluginResult<T[number]>>[K]>\n};\n\n// Utility type to handle intersection to an object type\ntype UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends (k: infer I) => void ? I : never;\n\n// Implement the uniform function\nexport default function uniform<T extends UniformPlugin<any>[]>(\n    references: Reference[],\n    config: { plugins: T }\n) {\n    // Infer the merged result type from all plugins\n    type ResultType = MergePluginResults<T>;\n\n    // Initialize the response with a type-safe out object\n    const response: {\n        references: Reference[]\n        out: { [K in keyof ResultType]: ResultType[K] }\n    } = {\n        references,\n        out: {} as { [K in keyof ResultType]: ResultType[K] }\n    };\n\n    config.plugins.forEach((plugin) => {\n        let defer: any = undefined; // fix any\n\n        const call = plugin({\n            references: references,\n            defer: (cb) => {\n                if (typeof cb === \"function\") {\n                    defer = cb\n                }\n            },\n            // visit: (pattern, callback) => {\n            // }\n        })\n\n        references.map((ref, i) => {\n            call(ref, {\n                index: i,\n            })\n        });\n\n        if (typeof defer === \"function\") {\n            const resp = defer()\n            if (typeof resp !== \"object\") {\n                throw new Error(`Invalid callback return type: ${typeof resp}`)\n            }\n\n            response.out = {\n                ...response.out,\n                ...resp\n            }\n        }\n    })\n\n    return response;\n}\n\n// Example usage\n// const examplePlugin: UniformPlugin<{ value: boolean }> = (cb) => {\n//     return (ref: Reference) => {\n//     };\n// };\n// function examplePlugin(defer: (defer: () => { value: boolean }) => void) {\n//     defer(() => ({\n//         value: true,\n//     }));\n//\n//     return (ref: Reference) => {\n//\n//     };\n// }\n// const response = uniform([/* references */], {\n//     plugins: [examplePlugin],\n// });\n// response.out\n","import type { UniformPluginArgs, UniformPlugin } from \"../index\";\nimport { Reference } from \"../types\";\n\nexport interface pluginJsonViewOptions {\n}\n\ntype pluginJsonViewOutput = {\n    jsonViews: string;\n}\n\nexport function pluginJsonView(\n    options?: pluginJsonViewOptions\n): UniformPlugin<pluginJsonViewOutput> {\n\n    return function pluginJsonViewInner({\n        defer,\n    }: UniformPluginArgs) {\n        const jsonViews: string[] = [];\n\n        defer(() => ({\n            jsonViews\n        }))\n\n        return (ref: Reference) => {\n            // Build the output string manually to ensure exact format\n            const lines: string[] = [];\n            lines.push('{');\n            \n            ref.definitions.forEach(def => {\n                def.properties.forEach((prop, index) => {\n                    // Remove any quotes and trailing characters from the value\n                    const value = (prop.examples?.[0] || '').replace(/^\"|\"$|[^a-zA-Z0-9\\s\\-_.,:/@#=;+()]/g, '');\n                    const comment = prop.examples && prop.examples.length > 1 \n                        ? ` // or \"${(prop.examples as string[])[1].replace(/^\"|\"$|[^a-zA-Z0-9\\s\\-_.,:/@#=;+()]/g, '')}\"`\n                        : '';\n                    const isLast = index === def.properties.length - 1;\n                    // Add comma after the value but before the comment\n                    lines.push(`    \"${prop.name}\": \"${value}\"${isLast ? '' : ','}${comment}`);\n                });\n            });\n            \n            lines.push('}');\n            \n            jsonViews.push(lines.join('\\n'));\n        }\n    }\n}\n\n// example usage:\n// const response = uniform([/* references */], {\n//     plugins: [pluginJsonView({\n//         \n//     })],\n// });\n","import path from 'node:path';\n\nimport type { Sidebar, Metadata, MetadataMap, Settings, PageURL } from \"@xyd-js/core\";\n\nimport type { UniformPluginArgs, UniformPlugin } from \"../index\";\nimport { CodeBlockTab, Example, ExampleGroup, Reference } from \"../types\";\n\nconst DEFAULT_VIRTUAL_FOLDER = \".xyd/.cache/.content\" // TODO: share this + .xyd/.build/.content for build\n\nconst DEFAULT_GROUP_NAME = \"API Reference\" // TODO: configurable\n\ntype GroupMap = {\n    [key: string]: {\n        __groups: GroupMap\n        pages: Set<string>\n    }\n}\n\nexport interface pluginNavigationOptions {\n    urlPrefix: string\n    defaultGroup?: string\n}\n\ntype pluginNavigationOutput = {\n    pageFrontMatter: MetadataMap;\n    sidebar: Sidebar[];\n}\n\nexport function pluginNavigation(\n    settings: Settings,\n    options: pluginNavigationOptions\n): UniformPlugin<pluginNavigationOutput> {\n    // if (!options.urlPrefix) {\n    //     throw new Error(\"urlPrefix is required\")\n    // }\n\n    return function pluginNavigationInner({\n        defer,\n    }: UniformPluginArgs) {\n        const pageFrontMatter: MetadataMap = {}\n        const groupMaps: GroupMap = {}\n\n        defer(() => ({\n            pageFrontMatter,\n            sidebar: convertGroupMapsToSidebar(settings, groupMaps) as Sidebar[]\n        }))\n\n        return (ref: Reference) => {\n            const dataCtx = ref.context\n            const pagePath = path.join(options.urlPrefix, ref.canonical)\n\n            let group = dataCtx?.group || []\n            let title = ref.title\n\n            if (pageFrontMatter[pagePath]) {\n                console.error(\"(pluginNavigation): pageFrontMatter[pagePath] already exists\", pagePath)\n            }\n\n            if (!group) {\n                group = [options.defaultGroup || DEFAULT_GROUP_NAME]\n            }\n\n            pageFrontMatter[pagePath] = {\n                title,\n            }\n\n            if (typeof group === \"string\") {\n                // TODO: seek nested group (it's not always from 0)\n                throw new Error(\"group as string is not supported yet\")\n            }\n\n            group.reduce((groups: GroupMap, groupName: string, i: number) => {\n                if (!groups[groupName]) {\n                    groups[groupName] = {\n                        __groups: {},\n                        pages: new Set()\n                    }\n                }\n\n                if (i === group.length - 1) {\n                    groups[groupName].pages.add(pagePath)\n                }\n\n                return groups[groupName].__groups\n            }, groupMaps)\n        }\n    }\n}\n\nfunction convertGroupMapsToSidebar(settings: Settings, groupMaps: GroupMap): Sidebar[] {\n    const nav: Sidebar[] = []\n\n    Object.keys(groupMaps).map((groupName) => {\n        const current = groupMaps[groupName]\n\n        const pages: PageURL[] = []\n\n        current.pages.forEach((page: string) => {\n            if (settings?.engine?.uniform?.store) {\n                pages.push(page)\n                return\n            }\n            pages.push({\n                virtual: path.join(DEFAULT_VIRTUAL_FOLDER, page),\n                page: page,\n            })\n        })\n\n        if (Object.keys(current.__groups).length) {\n            const subNav: Sidebar = {\n                group: groupName,\n                pages: convertGroupMapsToSidebar(settings, current.__groups)\n            }\n\n            nav.push(subNav)\n\n            return\n        }\n\n        nav.push({\n            group: groupName,\n            pages,\n        })\n    })\n\n    return nav\n}\n\n// TODO: in the future xyd settings must be removed cuz uniform will be part of opendocs\n// example usage:\n// const response = uniform([/* references */], {\n//     plugins: [pluginNavigation({}, {\n//         urlPrefix: \"/docs\"\n//     })],\n// });\n"],"mappings":"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","names":["DEFINED_DEFINITION_PROPERTY_TYPE","ReferenceCategory","ReferenceType","schema"]}

package/dist/markdown.d.cts

@@ -1,4 +1,4 @@
-import { R as Reference } from './types-DiQsFerK.cjs';
+import { R as Reference } from './types-DcJGRAj1.cjs';
 import 'react';
 import 'codehike/code';
 

package/dist/markdown.d.ts

@@ -1,4 +1,4 @@
-import { R as Reference } from './types-DiQsFerK.js';
+import { R as Reference } from './types-DcJGRAj1.js';
 import 'react';
 import 'codehike/code';
 

package/dist/{types-DiQsFerK.d.cts → types-DcJGRAj1.d.cts}

@@ -24,6 +24,7 @@ type SymbolDef = {
     id?: string | string[];
     canonical?: string | string[];
 };
+type DefinitionTypeREST = "$rest.param.path" | "$rest.param.query" | "$rest.param.header" | "$rest.param.cookie" | "$rest.request.body";
 interface Definition<M extends DefinitionMeta = DefinitionMeta, VM extends DefinitionVariantMeta = DefinitionVariantMeta> {
     title: string;
     properties: DefinitionProperty[];
@@ -42,7 +43,7 @@ interface Definition<M extends DefinitionMeta = DefinitionMeta, VM extends Defin
     /**
      * @internal
      */
-    type?: string;
+    type?: "return" | DefinitionTypeREST;
 }
 type DefinitionVariantOpenAPIMeta = Meta<"status" | "contentType" | "definitionDescription" | "required">;
 type CommonDefinitionVariantMeta = Meta<"symbolName">;
@@ -178,4 +179,4 @@ interface OpenAPIExampleContext {
     content?: string;
 }
 
-export { type BaseReferenceContext as B, type CommonDefinitionVariantMeta as C, type DefinitionOpenAPIMeta as D, type ExampleRoot as E, type GraphQLReferenceContext as G, type Meta as M, type OpenAPIReferenceContext as O, type Reference as R, type SymbolDef as S, type TypeDocReferenceContextMeta as T, type DefinitionTypeDocMeta as a, type DefinitionGraphqlMeta as b, type DefinitionMeta as c, type Definition as d, type DefinitionVariantOpenAPIMeta as e, type DefinitionVariantMeta as f, type DefinitionVariant as g, type DefinitionPropertyMeta as h, DEFINED_DEFINITION_PROPERTY_TYPE as i, type DefinitionProperty as j, type ExampleGroup as k, type Example as l, type CodeBlock as m, type CodeBlockTab as n, type ExampleContext as o, ReferenceCategory as p, ReferenceType as q, type TypeDocReferenceContext as r, type ReferenceContext as s, type GraphQLExampleContext as t, type OpenAPIExampleContext as u };
+export { type BaseReferenceContext as B, type CommonDefinitionVariantMeta as C, type DefinitionOpenAPIMeta as D, type ExampleRoot as E, type GraphQLReferenceContext as G, type Meta as M, type OpenAPIReferenceContext as O, type Reference as R, type SymbolDef as S, type TypeDocReferenceContextMeta as T, type DefinitionTypeDocMeta as a, type DefinitionGraphqlMeta as b, type DefinitionMeta as c, type DefinitionTypeREST as d, type Definition as e, type DefinitionVariantOpenAPIMeta as f, type DefinitionVariantMeta as g, type DefinitionVariant as h, type DefinitionPropertyMeta as i, DEFINED_DEFINITION_PROPERTY_TYPE as j, type DefinitionProperty as k, type ExampleGroup as l, type Example as m, type CodeBlock as n, type CodeBlockTab as o, type ExampleContext as p, ReferenceCategory as q, ReferenceType as r, type TypeDocReferenceContext as s, type ReferenceContext as t, type GraphQLExampleContext as u, type OpenAPIExampleContext as v };

package/dist/{types-DiQsFerK.d.ts → types-DcJGRAj1.d.ts}

@@ -24,6 +24,7 @@ type SymbolDef = {
     id?: string | string[];
     canonical?: string | string[];
 };
+type DefinitionTypeREST = "$rest.param.path" | "$rest.param.query" | "$rest.param.header" | "$rest.param.cookie" | "$rest.request.body";
 interface Definition<M extends DefinitionMeta = DefinitionMeta, VM extends DefinitionVariantMeta = DefinitionVariantMeta> {
     title: string;
     properties: DefinitionProperty[];
@@ -42,7 +43,7 @@ interface Definition<M extends DefinitionMeta = DefinitionMeta, VM extends Defin
     /**
      * @internal
      */
-    type?: string;
+    type?: "return" | DefinitionTypeREST;
 }
 type DefinitionVariantOpenAPIMeta = Meta<"status" | "contentType" | "definitionDescription" | "required">;
 type CommonDefinitionVariantMeta = Meta<"symbolName">;
@@ -178,4 +179,4 @@ interface OpenAPIExampleContext {
     content?: string;
 }
 
-export { type BaseReferenceContext as B, type CommonDefinitionVariantMeta as C, type DefinitionOpenAPIMeta as D, type ExampleRoot as E, type GraphQLReferenceContext as G, type Meta as M, type OpenAPIReferenceContext as O, type Reference as R, type SymbolDef as S, type TypeDocReferenceContextMeta as T, type DefinitionTypeDocMeta as a, type DefinitionGraphqlMeta as b, type DefinitionMeta as c, type Definition as d, type DefinitionVariantOpenAPIMeta as e, type DefinitionVariantMeta as f, type DefinitionVariant as g, type DefinitionPropertyMeta as h, DEFINED_DEFINITION_PROPERTY_TYPE as i, type DefinitionProperty as j, type ExampleGroup as k, type Example as l, type CodeBlock as m, type CodeBlockTab as n, type ExampleContext as o, ReferenceCategory as p, ReferenceType as q, type TypeDocReferenceContext as r, type ReferenceContext as s, type GraphQLExampleContext as t, type OpenAPIExampleContext as u };
+export { type BaseReferenceContext as B, type CommonDefinitionVariantMeta as C, type DefinitionOpenAPIMeta as D, type ExampleRoot as E, type GraphQLReferenceContext as G, type Meta as M, type OpenAPIReferenceContext as O, type Reference as R, type SymbolDef as S, type TypeDocReferenceContextMeta as T, type DefinitionTypeDocMeta as a, type DefinitionGraphqlMeta as b, type DefinitionMeta as c, type DefinitionTypeREST as d, type Definition as e, type DefinitionVariantOpenAPIMeta as f, type DefinitionVariantMeta as g, type DefinitionVariant as h, type DefinitionPropertyMeta as i, DEFINED_DEFINITION_PROPERTY_TYPE as j, type DefinitionProperty as k, type ExampleGroup as l, type Example as m, type CodeBlock as n, type CodeBlockTab as o, type ExampleContext as p, ReferenceCategory as q, ReferenceType as r, type TypeDocReferenceContext as s, type ReferenceContext as t, type GraphQLExampleContext as u, type OpenAPIExampleContext as v };

package/index.ts

@@ -4,7 +4,7 @@ export type {
     UniformPluginArgs
 } from "./src/index"
 
-export { default } from "./src/index"
+export { default, uniformToInputJsonSchema } from "./src/index"
 
 export {
     pluginJsonView,