@openpkg-ts/ui 0.5.2 → 0.6.0

package/dist/docskit/index.d.ts

@@ -238,7 +238,7 @@ interface ExampleSectionProps {
 * Integrates with SyncScrollProvider for synchronized scrolling.
 */
 declare function ExampleSection({ id, examples, dataSource, response, notes, className }: ExampleSectionProps): ReactNode7;
-import { SpecSignatureParameter } from "@openpkg-ts/spec";
+import { SpecSchema, SpecSignatureParameter } from "@openpkg-ts/spec";
 import { ReactNode as ReactNode8 } from "react";
 interface ExpandableParameterProps {
 	/** Parameter from spec */
@@ -255,12 +255,14 @@ interface ExpandableParameterProps {
 	level?: number;
 	/** Custom className */
 	className?: string;
+	/** Callback to resolve $ref schemas */
+	resolveRef?: (ref: string) => SpecSchema | undefined;
 }
 /**
 * Compound component combining APIParameterItem + NestedParameterToggle + NestedParameterContainer.
 * Automatically extracts nested object properties and enum values from spec schema.
 */
-declare function ExpandableParameter({ parameter, parentPath, defaultExpanded, expanded: controlledExpanded, onExpandedChange, level, className }: ExpandableParameterProps): ReactNode8;
+declare function ExpandableParameter({ parameter, parentPath, defaultExpanded, expanded: controlledExpanded, onExpandedChange, level, className, resolveRef }: ExpandableParameterProps): ReactNode8;
 import { ReactNode as ReactNode9 } from "react";
 interface MethodSectionProps {
 	/** Section ID for scroll sync */

package/dist/docskit/index.js

@@ -1923,7 +1923,8 @@ function ExpandableParameter({
   expanded: controlledExpanded,
   onExpandedChange,
   level = 0,
-  className
+  className,
+  resolveRef
 }) {
   const [internalExpanded, setInternalExpanded] = useState10(defaultExpanded);
   const isControlled = controlledExpanded !== undefined;
@@ -1936,7 +1937,7 @@ function ExpandableParameter({
       setInternalExpanded(newValue);
     }
   };
-  const { nestedParams, enumValues, hasChildren } = extractSchemaInfo(parameter.schema);
+  const { nestedParams, enumValues, hasChildren } = extractSchemaInfo(parameter.schema, resolveRef);
   const type = formatSchema(parameter.schema);
   const isRequired = parameter.required !== false;
   return /* @__PURE__ */ jsx39("div", {
@@ -1964,7 +1965,8 @@ function ExpandableParameter({
               children: nestedParams.map((nested) => /* @__PURE__ */ jsx39(ExpandableParameter, {
                 parameter: nested,
                 parentPath: `${parameter.name}.`,
-                level: level + 1
+                level: level + 1,
+                resolveRef
               }, nested.name))
             })
           ]
@@ -1973,7 +1975,7 @@ function ExpandableParameter({
     })
   });
 }
-function extractSchemaInfo(schema) {
+function extractSchemaInfo(schema, resolveRef) {
   const result = {
     nestedParams: [],
     enumValues: [],
@@ -1981,7 +1983,13 @@ function extractSchemaInfo(schema) {
   };
   if (!schema || typeof schema !== "object")
     return result;
-  const s = schema;
+  let s = schema;
+  if (s.$ref && typeof s.$ref === "string" && resolveRef) {
+    const resolved = resolveRef(s.$ref);
+    if (resolved && typeof resolved === "object") {
+      s = resolved;
+    }
+  }
   if (s.type === "object" && s.properties && typeof s.properties === "object") {
     const props = s.properties;
     const required = Array.isArray(s.required) ? s.required : [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openpkg-ts/ui",
-  "version": "0.5.2",
+  "version": "0.6.0",
   "description": "UI primitives and components for OpenPkg documentation",
   "homepage": "https://github.com/ryanwaits/openpkg-ts#readme",
   "repository": {