@xyd-js/uniform 0.0.0-build-8b31648-20250923204702 → 0.0.0-build-9f87f13-20250930210637

package/CHANGELOG.md

@@ -1,9 +1,9 @@
 # @xyd-js/uniform
 
-## 0.0.0-build-8b31648-20250923204702
+## 0.0.0-build-9f87f13-20250930210637
 
 ### Patch Changes
 
 - update all packages
 - Updated dependencies
-  - @xyd-js/core@0.0.0-build-8b31648-20250923204702
+  - @xyd-js/core@0.0.0-build-9f87f13-20250930210637

package/dist/index.cjs

@@ -35,7 +35,8 @@ __export(index_exports, {
   ReferenceType: () => ReferenceType,
   default: () => uniform,
   pluginJsonView: () => pluginJsonView,
-  pluginNavigation: () => pluginNavigation
+  pluginNavigation: () => pluginNavigation,
+  uniformToInputJsonSchema: () => uniformToInputJsonSchema
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -80,6 +81,158 @@ var ReferenceType = /* @__PURE__ */ ((ReferenceType2) => {
   return ReferenceType2;
 })(ReferenceType || {});
 
+// src/converters.ts
+function uniformToInputJsonSchema(reference) {
+  var _a, _b, _c, _d;
+  if (!((_a = reference == null ? void 0 : reference.definitions) == null ? void 0 : _a.length)) {
+    return null;
+  }
+  const inputDefinitions = [];
+  for (const def of reference.definitions) {
+    if ((def == null ? void 0 : def.type) === "return") {
+      continue;
+    }
+    const definitionSchemas = [];
+    if ((_b = def == null ? void 0 : def.properties) == null ? void 0 : _b.length) {
+      const result = uniformPropertiesToJsonSchema(def.properties, def.type);
+      if (result) {
+        definitionSchemas.push(result);
+      }
+    }
+    if ((_c = def == null ? void 0 : def.variants) == null ? void 0 : _c.length) {
+      const variantSchemas = [];
+      for (const variant of def.variants) {
+        if ((_d = variant == null ? void 0 : variant.properties) == null ? void 0 : _d.length) {
+          const result = uniformPropertiesToJsonSchema(variant.properties, def.type);
+          if (result) {
+            variantSchemas.push(result);
+          }
+        }
+      }
+      if (variantSchemas.length > 0) {
+        if (variantSchemas.length === 1) {
+          definitionSchemas.push(variantSchemas[0]);
+        } else {
+          definitionSchemas.push({
+            oneOf: variantSchemas
+          });
+        }
+      }
+    }
+    if (definitionSchemas.length === 1) {
+      inputDefinitions.push(definitionSchemas[0]);
+    } else if (definitionSchemas.length > 1) {
+      inputDefinitions.push({
+        allOf: definitionSchemas
+      });
+    }
+  }
+  if (inputDefinitions.length === 0) {
+    return null;
+  } else if (inputDefinitions.length === 1) {
+    return inputDefinitions[0];
+  } else {
+    return {
+      allOf: inputDefinitions
+    };
+  }
+}
+function uniformPropertiesToJsonSchema(properties, id) {
+  var _a, _b, _c;
+  if (Array.isArray(properties)) {
+    let jsonSchemaProps = {};
+    let requiredFields = [];
+    if (properties.length) {
+      for (const property of properties) {
+        const v = uniformPropertiesToJsonSchema(property);
+        if (v) {
+          jsonSchemaProps[property.name] = v;
+        }
+        const isRequired = (_a = property.meta) == null ? void 0 : _a.some(
+          (meta) => meta.name === "required" && meta.value === "true"
+        );
+        if (isRequired) {
+          requiredFields.push(property.name);
+        }
+      }
+    }
+    const schema2 = {
+      $id: id || void 0,
+      type: "object",
+      properties: jsonSchemaProps
+    };
+    if (requiredFields.length > 0) {
+      schema2.required = requiredFields;
+    }
+    return schema2;
+  }
+  if (properties.type === "$$enum" /* ENUM */) {
+    const schema2 = {
+      description: properties.description
+    };
+    const enumType = properties.ofProperty && properties.ofProperty.type || ((_c = (_b = properties.meta) == null ? void 0 : _b.find((meta) => meta.name === "enum-type")) == null ? void 0 : _c.value) || "string";
+    schema2.type = enumType;
+    if (properties.properties && properties.properties.length > 0) {
+      schema2.enum = properties.properties.map((prop) => prop.name);
+    }
+    return schema2;
+  }
+  if (properties.type === "$$array" /* ARRAY */) {
+    const schema2 = {
+      type: "array",
+      description: properties.description
+    };
+    if (properties.ofProperty) {
+      const itemsSchema = uniformPropertiesToJsonSchema(properties.ofProperty);
+      if (itemsSchema) {
+        schema2.items = itemsSchema;
+      }
+    }
+    return schema2;
+  }
+  if (properties.type === "$$xor" /* XOR */) {
+    const schema2 = {
+      description: properties.description
+    };
+    if (properties.properties && properties.properties.length > 0) {
+      schema2.oneOf = properties.properties.map((prop) => {
+        const propSchema = uniformPropertiesToJsonSchema(prop);
+        return propSchema || {};
+      }).filter((schema3) => Object.keys(schema3).length > 0);
+    }
+    return schema2;
+  }
+  if (properties.type === "$$union" /* UNION */) {
+    const schema2 = {
+      description: properties.description
+    };
+    if (properties.properties && properties.properties.length > 0) {
+      schema2.anyOf = properties.properties.map((prop) => {
+        const propSchema = uniformPropertiesToJsonSchema(prop);
+        return propSchema || {};
+      }).filter((schema3) => Object.keys(schema3).length > 0);
+    }
+    return schema2;
+  }
+  if (properties.ofProperty) {
+    return uniformPropertiesToJsonSchema(properties.ofProperty);
+  }
+  const schema = {
+    type: properties.type,
+    description: properties.description
+  };
+  if (properties.type === "object" && properties.properties && properties.properties.length > 0) {
+    const nestedSchema = uniformPropertiesToJsonSchema(properties.properties);
+    if (nestedSchema && nestedSchema.properties) {
+      schema.properties = nestedSchema.properties;
+      if (nestedSchema.required) {
+        schema.required = nestedSchema.required;
+      }
+    }
+  }
+  return schema;
+}
+
 // src/index.ts
 function uniform(references, config) {
   const response = {
@@ -227,6 +380,7 @@ function convertGroupMapsToSidebar(settings, groupMaps) {
   ReferenceCategory,
   ReferenceType,
   pluginJsonView,
-  pluginNavigation
+  pluginNavigation,
+  uniformToInputJsonSchema
 });
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../index.ts","../src/types.ts","../src/index.ts","../src/plugins/pluginJsonView.ts","../src/plugins/pluginNavigation.ts"],"sourcesContent":["export * from \"./src/types\"\nexport type {\n    UniformPlugin,\n    UniformPluginArgs\n} from \"./src/index\"\n\nexport { default } from \"./src/index\"\n\nexport {\n    pluginJsonView,\n    pluginNavigation,\n} from \"./src/plugins\"\n\n\n","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","path"]}
+{"version":3,"sources":["../index.ts","../src/types.ts","../src/converters.ts","../src/index.ts","../src/plugins/pluginJsonView.ts","../src/plugins/pluginNavigation.ts"],"sourcesContent":["export * from \"./src/types\"\nexport type {\n    UniformPlugin,\n    UniformPluginArgs\n} from \"./src/index\"\n\nexport { default, uniformToInputJsonSchema } from \"./src/index\"\n\nexport {\n    pluginJsonView,\n    pluginNavigation,\n} from \"./src/plugins\"\n\n\n","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","path"]}

package/dist/index.d.cts

@@ -1,9 +1,12 @@
-import { R as Reference } from './types-DiQsFerK.cjs';
-export { B as BaseReferenceContext, m as CodeBlock, n as CodeBlockTab, C as CommonDefinitionVariantMeta, i as DEFINED_DEFINITION_PROPERTY_TYPE, d as Definition, b as DefinitionGraphqlMeta, c as DefinitionMeta, D as DefinitionOpenAPIMeta, j as DefinitionProperty, h as DefinitionPropertyMeta, a as DefinitionTypeDocMeta, g as DefinitionVariant, f as DefinitionVariantMeta, e as DefinitionVariantOpenAPIMeta, l as Example, o as ExampleContext, k as ExampleGroup, E as ExampleRoot, t as GraphQLExampleContext, G as GraphQLReferenceContext, M as Meta, u as OpenAPIExampleContext, O as OpenAPIReferenceContext, p as ReferenceCategory, s as ReferenceContext, q as ReferenceType, S as SymbolDef, r as TypeDocReferenceContext, T as TypeDocReferenceContextMeta } from './types-DiQsFerK.cjs';
+import { R as Reference } from './types-DcJGRAj1.cjs';
+export { B as BaseReferenceContext, n as CodeBlock, o as CodeBlockTab, C as CommonDefinitionVariantMeta, j as DEFINED_DEFINITION_PROPERTY_TYPE, e as Definition, b as DefinitionGraphqlMeta, c as DefinitionMeta, D as DefinitionOpenAPIMeta, k as DefinitionProperty, i as DefinitionPropertyMeta, a as DefinitionTypeDocMeta, d as DefinitionTypeREST, h as DefinitionVariant, g as DefinitionVariantMeta, f as DefinitionVariantOpenAPIMeta, m as Example, p as ExampleContext, l as ExampleGroup, E as ExampleRoot, u as GraphQLExampleContext, G as GraphQLReferenceContext, M as Meta, v as OpenAPIExampleContext, O as OpenAPIReferenceContext, q as ReferenceCategory, t as ReferenceContext, r as ReferenceType, S as SymbolDef, s as TypeDocReferenceContext, T as TypeDocReferenceContextMeta } from './types-DcJGRAj1.cjs';
 import { Settings, MetadataMap, Sidebar } from '@xyd-js/core';
+import { JSONSchema7 } from 'json-schema';
 import 'react';
 import 'codehike/code';
 
+declare function uniformToInputJsonSchema(reference: Reference): JSONSchema7 | null;
+
 type UniformPluginArgs = {
     references: Reference[] | Reference;
     defer: (defer: () => any) => void;
@@ -42,4 +45,4 @@ type pluginNavigationOutput = {
 };
 declare function pluginNavigation(settings: Settings, options: pluginNavigationOptions): UniformPlugin<pluginNavigationOutput>;
 
-export { Reference, type UniformPlugin, type UniformPluginArgs, uniform as default, pluginJsonView, pluginNavigation };
+export { Reference, type UniformPlugin, type UniformPluginArgs, uniform as default, pluginJsonView, pluginNavigation, uniformToInputJsonSchema };

package/dist/index.d.ts

@@ -1,9 +1,12 @@
-import { R as Reference } from './types-DiQsFerK.js';
-export { B as BaseReferenceContext, m as CodeBlock, n as CodeBlockTab, C as CommonDefinitionVariantMeta, i as DEFINED_DEFINITION_PROPERTY_TYPE, d as Definition, b as DefinitionGraphqlMeta, c as DefinitionMeta, D as DefinitionOpenAPIMeta, j as DefinitionProperty, h as DefinitionPropertyMeta, a as DefinitionTypeDocMeta, g as DefinitionVariant, f as DefinitionVariantMeta, e as DefinitionVariantOpenAPIMeta, l as Example, o as ExampleContext, k as ExampleGroup, E as ExampleRoot, t as GraphQLExampleContext, G as GraphQLReferenceContext, M as Meta, u as OpenAPIExampleContext, O as OpenAPIReferenceContext, p as ReferenceCategory, s as ReferenceContext, q as ReferenceType, S as SymbolDef, r as TypeDocReferenceContext, T as TypeDocReferenceContextMeta } from './types-DiQsFerK.js';
+import { R as Reference } from './types-DcJGRAj1.js';
+export { B as BaseReferenceContext, n as CodeBlock, o as CodeBlockTab, C as CommonDefinitionVariantMeta, j as DEFINED_DEFINITION_PROPERTY_TYPE, e as Definition, b as DefinitionGraphqlMeta, c as DefinitionMeta, D as DefinitionOpenAPIMeta, k as DefinitionProperty, i as DefinitionPropertyMeta, a as DefinitionTypeDocMeta, d as DefinitionTypeREST, h as DefinitionVariant, g as DefinitionVariantMeta, f as DefinitionVariantOpenAPIMeta, m as Example, p as ExampleContext, l as ExampleGroup, E as ExampleRoot, u as GraphQLExampleContext, G as GraphQLReferenceContext, M as Meta, v as OpenAPIExampleContext, O as OpenAPIReferenceContext, q as ReferenceCategory, t as ReferenceContext, r as ReferenceType, S as SymbolDef, s as TypeDocReferenceContext, T as TypeDocReferenceContextMeta } from './types-DcJGRAj1.js';
 import { Settings, MetadataMap, Sidebar } from '@xyd-js/core';
+import { JSONSchema7 } from 'json-schema';
 import 'react';
 import 'codehike/code';
 
+declare function uniformToInputJsonSchema(reference: Reference): JSONSchema7 | null;
+
 type UniformPluginArgs = {
     references: Reference[] | Reference;
     defer: (defer: () => any) => void;
@@ -42,4 +45,4 @@ type pluginNavigationOutput = {
 };
 declare function pluginNavigation(settings: Settings, options: pluginNavigationOptions): UniformPlugin<pluginNavigationOutput>;
 
-export { Reference, type UniformPlugin, type UniformPluginArgs, uniform as default, pluginJsonView, pluginNavigation };
+export { Reference, type UniformPlugin, type UniformPluginArgs, uniform as default, pluginJsonView, pluginNavigation, uniformToInputJsonSchema };

package/dist/index.js

@@ -39,6 +39,158 @@ var ReferenceType = /* @__PURE__ */ ((ReferenceType2) => {
   return ReferenceType2;
 })(ReferenceType || {});
 
+// src/converters.ts
+function uniformToInputJsonSchema(reference) {
+  var _a, _b, _c, _d;
+  if (!((_a = reference == null ? void 0 : reference.definitions) == null ? void 0 : _a.length)) {
+    return null;
+  }
+  const inputDefinitions = [];
+  for (const def of reference.definitions) {
+    if ((def == null ? void 0 : def.type) === "return") {
+      continue;
+    }
+    const definitionSchemas = [];
+    if ((_b = def == null ? void 0 : def.properties) == null ? void 0 : _b.length) {
+      const result = uniformPropertiesToJsonSchema(def.properties, def.type);
+      if (result) {
+        definitionSchemas.push(result);
+      }
+    }
+    if ((_c = def == null ? void 0 : def.variants) == null ? void 0 : _c.length) {
+      const variantSchemas = [];
+      for (const variant of def.variants) {
+        if ((_d = variant == null ? void 0 : variant.properties) == null ? void 0 : _d.length) {
+          const result = uniformPropertiesToJsonSchema(variant.properties, def.type);
+          if (result) {
+            variantSchemas.push(result);
+          }
+        }
+      }
+      if (variantSchemas.length > 0) {
+        if (variantSchemas.length === 1) {
+          definitionSchemas.push(variantSchemas[0]);
+        } else {
+          definitionSchemas.push({
+            oneOf: variantSchemas
+          });
+        }
+      }
+    }
+    if (definitionSchemas.length === 1) {
+      inputDefinitions.push(definitionSchemas[0]);
+    } else if (definitionSchemas.length > 1) {
+      inputDefinitions.push({
+        allOf: definitionSchemas
+      });
+    }
+  }
+  if (inputDefinitions.length === 0) {
+    return null;
+  } else if (inputDefinitions.length === 1) {
+    return inputDefinitions[0];
+  } else {
+    return {
+      allOf: inputDefinitions
+    };
+  }
+}
+function uniformPropertiesToJsonSchema(properties, id) {
+  var _a, _b, _c;
+  if (Array.isArray(properties)) {
+    let jsonSchemaProps = {};
+    let requiredFields = [];
+    if (properties.length) {
+      for (const property of properties) {
+        const v = uniformPropertiesToJsonSchema(property);
+        if (v) {
+          jsonSchemaProps[property.name] = v;
+        }
+        const isRequired = (_a = property.meta) == null ? void 0 : _a.some(
+          (meta) => meta.name === "required" && meta.value === "true"
+        );
+        if (isRequired) {
+          requiredFields.push(property.name);
+        }
+      }
+    }
+    const schema2 = {
+      $id: id || void 0,
+      type: "object",
+      properties: jsonSchemaProps
+    };
+    if (requiredFields.length > 0) {
+      schema2.required = requiredFields;
+    }
+    return schema2;
+  }
+  if (properties.type === "$$enum" /* ENUM */) {
+    const schema2 = {
+      description: properties.description
+    };
+    const enumType = properties.ofProperty && properties.ofProperty.type || ((_c = (_b = properties.meta) == null ? void 0 : _b.find((meta) => meta.name === "enum-type")) == null ? void 0 : _c.value) || "string";
+    schema2.type = enumType;
+    if (properties.properties && properties.properties.length > 0) {
+      schema2.enum = properties.properties.map((prop) => prop.name);
+    }
+    return schema2;
+  }
+  if (properties.type === "$$array" /* ARRAY */) {
+    const schema2 = {
+      type: "array",
+      description: properties.description
+    };
+    if (properties.ofProperty) {
+      const itemsSchema = uniformPropertiesToJsonSchema(properties.ofProperty);
+      if (itemsSchema) {
+        schema2.items = itemsSchema;
+      }
+    }
+    return schema2;
+  }
+  if (properties.type === "$$xor" /* XOR */) {
+    const schema2 = {
+      description: properties.description
+    };
+    if (properties.properties && properties.properties.length > 0) {
+      schema2.oneOf = properties.properties.map((prop) => {
+        const propSchema = uniformPropertiesToJsonSchema(prop);
+        return propSchema || {};
+      }).filter((schema3) => Object.keys(schema3).length > 0);
+    }
+    return schema2;
+  }
+  if (properties.type === "$$union" /* UNION */) {
+    const schema2 = {
+      description: properties.description
+    };
+    if (properties.properties && properties.properties.length > 0) {
+      schema2.anyOf = properties.properties.map((prop) => {
+        const propSchema = uniformPropertiesToJsonSchema(prop);
+        return propSchema || {};
+      }).filter((schema3) => Object.keys(schema3).length > 0);
+    }
+    return schema2;
+  }
+  if (properties.ofProperty) {
+    return uniformPropertiesToJsonSchema(properties.ofProperty);
+  }
+  const schema = {
+    type: properties.type,
+    description: properties.description
+  };
+  if (properties.type === "object" && properties.properties && properties.properties.length > 0) {
+    const nestedSchema = uniformPropertiesToJsonSchema(properties.properties);
+    if (nestedSchema && nestedSchema.properties) {
+      schema.properties = nestedSchema.properties;
+      if (nestedSchema.required) {
+        schema.required = nestedSchema.required;
+      }
+    }
+  }
+  return schema;
+}
+
 // src/index.ts
 function uniform(references, config) {
   const response = {
@@ -186,6 +338,7 @@ export {
   ReferenceType,
   uniform as default,
   pluginJsonView,
-  pluginNavigation
+  pluginNavigation,
+  uniformToInputJsonSchema
 };
 //# sourceMappingURL=index.js.map