raffel 1.1.111 → 1.1.112

package/dist/docs/ui/assets/raffel-docs.css

@@ -3370,6 +3370,23 @@
       color: var(--text-secondary);
     }
 
+    .schema-composition-header {
+      font-weight: 600;
+    }
+
+    .schema-composition-variant {
+      margin: 8px 0 8px 12px;
+      border-left: 2px solid color-mix(in srgb, var(--primary-color) 35%, var(--border-color));
+    }
+
+    .schema-composition-label {
+      padding: 4px 8px;
+      color: var(--text-secondary);
+      font-size: 10px;
+      font-weight: 600;
+      text-transform: uppercase;
+    }
+
     .schema-tree-unresolved {
       color: var(--text-muted);
       font-style: italic;

package/dist/docs/ui/assets/raffel-docs.js

@@ -1545,8 +1545,29 @@ function collectContractExamples(owner, schema) {
         return true;
     });
 }
+function schemaComposition(schema) {
+    if (!schema || typeof schema !== 'object')
+        return null;
+    if (Array.isArray(schema.oneOf) && schema.oneOf.length > 0) {
+        return { label: 'One of', variants: schema.oneOf };
+    }
+    if (Array.isArray(schema.anyOf) && schema.anyOf.length > 0) {
+        return { label: 'Any of', variants: schema.anyOf };
+    }
+    if (Array.isArray(schema.allOf) && schema.allOf.length > 0) {
+        return { label: 'All of', variants: schema.allOf };
+    }
+    return null;
+}
 function contractSchemaType(rawSchema, schema) {
     const refName = rawSchema?.$ref ? String(rawSchema.$ref).split('/').pop() : '';
+    const composition = schemaComposition(schema);
+    if (composition) {
+        return {
+            type: 'composition',
+            label: `${composition.label.toLowerCase()} ${composition.variants.length} variants`,
+        };
+    }
     const type = Array.isArray(schema?.type)
         ? schema.type.join(' | ')
         : schema?.type || (refName ? 'object' : 'any');
@@ -1580,11 +1601,13 @@ function appendContractExamples(parent, examples, prefix = '') {
 }
 function createContractRow(name, rawSchema, required, options = {}) {
     const schema = resolveSchema(rawSchema) ?? {};
-    const nestedSchema = schema.type === 'object' && schema.properties
+    const nestedSchema = schemaComposition(schema)
         ? rawSchema
-        : schema.type === 'array' && resolveSchema(schema.items)?.properties
-            ? schema.items
-            : null;
+        : schema.type === 'object' && schema.properties
+            ? rawSchema
+            : schema.type === 'array' && resolveSchema(schema.items)?.properties
+                ? schema.items
+                : null;
     const row = doc.createElement('div');
     row.className = `schema-tree-row${nestedSchema ? ' schema-tree-row-expandable' : ''}`;
     const key = doc.createElement('div');
@@ -2072,6 +2095,24 @@ function renderSchemaTree(parent, schema, depth = 0, refStack = new Set()) {
         row.textContent = `Unresolved schema reference: ${refName}`;
         div.appendChild(row);
     }
+    else if (schemaComposition(schema)) {
+        const composition = schemaComposition(schema);
+        const header = doc.createElement('div');
+        header.className = 'schema-tree-row schema-tree-meta schema-composition-header';
+        header.textContent = `${composition.label} ${composition.variants.length} variants`;
+        div.appendChild(header);
+        composition.variants.forEach((variant, index) => {
+            const resolvedVariant = resolveSchema(variant);
+            const group = doc.createElement('div');
+            group.className = 'schema-composition-variant';
+            const label = doc.createElement('div');
+            label.className = 'schema-composition-label';
+            label.textContent = resolvedVariant?.title || `Variant ${index + 1}`;
+            group.appendChild(label);
+            renderSchemaTree(group, variant, depth + 1, nextRefStack);
+            div.appendChild(group);
+        });
+    }
     else if (schema.type === 'object' && schema.properties) {
         Object.entries(schema.properties).forEach(([key, prop]) => {
             const contract = createContractRow(key, prop, schema.required?.includes(key) === true);

package/dist/docs/ui/runtime/index.js

@@ -1545,8 +1545,29 @@ function collectContractExamples(owner, schema) {
         return true;
     });
 }
+function schemaComposition(schema) {
+    if (!schema || typeof schema !== 'object')
+        return null;
+    if (Array.isArray(schema.oneOf) && schema.oneOf.length > 0) {
+        return { label: 'One of', variants: schema.oneOf };
+    }
+    if (Array.isArray(schema.anyOf) && schema.anyOf.length > 0) {
+        return { label: 'Any of', variants: schema.anyOf };
+    }
+    if (Array.isArray(schema.allOf) && schema.allOf.length > 0) {
+        return { label: 'All of', variants: schema.allOf };
+    }
+    return null;
+}
 function contractSchemaType(rawSchema, schema) {
     const refName = rawSchema?.$ref ? String(rawSchema.$ref).split('/').pop() : '';
+    const composition = schemaComposition(schema);
+    if (composition) {
+        return {
+            type: 'composition',
+            label: `${composition.label.toLowerCase()} ${composition.variants.length} variants`,
+        };
+    }
     const type = Array.isArray(schema?.type)
         ? schema.type.join(' | ')
         : schema?.type || (refName ? 'object' : 'any');
@@ -1580,11 +1601,13 @@ function appendContractExamples(parent, examples, prefix = '') {
 }
 function createContractRow(name, rawSchema, required, options = {}) {
     const schema = resolveSchema(rawSchema) ?? {};
-    const nestedSchema = schema.type === 'object' && schema.properties
+    const nestedSchema = schemaComposition(schema)
         ? rawSchema
-        : schema.type === 'array' && resolveSchema(schema.items)?.properties
-            ? schema.items
-            : null;
+        : schema.type === 'object' && schema.properties
+            ? rawSchema
+            : schema.type === 'array' && resolveSchema(schema.items)?.properties
+                ? schema.items
+                : null;
     const row = doc.createElement('div');
     row.className = `schema-tree-row${nestedSchema ? ' schema-tree-row-expandable' : ''}`;
     const key = doc.createElement('div');
@@ -2072,6 +2095,24 @@ function renderSchemaTree(parent, schema, depth = 0, refStack = new Set()) {
         row.textContent = `Unresolved schema reference: ${refName}`;
         div.appendChild(row);
     }
+    else if (schemaComposition(schema)) {
+        const composition = schemaComposition(schema);
+        const header = doc.createElement('div');
+        header.className = 'schema-tree-row schema-tree-meta schema-composition-header';
+        header.textContent = `${composition.label} ${composition.variants.length} variants`;
+        div.appendChild(header);
+        composition.variants.forEach((variant, index) => {
+            const resolvedVariant = resolveSchema(variant);
+            const group = doc.createElement('div');
+            group.className = 'schema-composition-variant';
+            const label = doc.createElement('div');
+            label.className = 'schema-composition-label';
+            label.textContent = resolvedVariant?.title || `Variant ${index + 1}`;
+            group.appendChild(label);
+            renderSchemaTree(group, variant, depth + 1, nextRefStack);
+            div.appendChild(group);
+        });
+    }
     else if (schema.type === 'object' && schema.properties) {
         Object.entries(schema.properties).forEach(([key, prop]) => {
             const contract = createContractRow(key, prop, schema.required?.includes(key) === true);