lutaml-jsonschema 0.1.6 → 0.1.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7489a2b5deaa74c751691afdf57939c046e29d6a853774462ce5587e05dcbcf3
-  data.tar.gz: fca882189c10df105bc30df80c5fe34cc0108ca82b87420e638170ec7a62d1e3
+  metadata.gz: eea2d4379420899294e19ce129230527927e0af75f6d7f3aad847edc14a1072b
+  data.tar.gz: 71831392b43dc29bed8c8da35da7b021eaf2ed2c377e90b0b949e23e8747df43
 SHA512:
-  metadata.gz: b27dd39b382a08e4fc1aa58ae1b9803ffbeee75fc3db6e3df0261871ce43d3aabfbe7cc863207b190c5a88e52212fca6f43acd40506d4f82088094a0ffd57ebf
-  data.tar.gz: d3af571ef80959e85a9c3e7ccaebb0a5e721d94348616a873edd25f6c488c596542ca0a8a836b94917a34bfdbc675cc2dc50f844995d7c5a055fc44348987926
+  metadata.gz: 52c2b48f8a08223efc1926a18d5260e983d40359c2b5935a2a6962fc0260ff87ddfb7d88d2b4598072d66950ce999b89017afbf2ef9dbbac523b48722cffa336
+  data.tar.gz: b9f3b9ae250242f212d5fd59d99497f75143cbca89b079c9a64f476e582cd66ab4cdbd71a9cd8a905f2642b5625071464e86c8de019703119bd2e639f06f7c39

data/.rubocop_todo.yml

@@ -1,6 +1,6 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2026-05-07 10:44:46 UTC using RuboCop version 1.86.1.
+# on 2026-05-08 02:42:09 UTC using RuboCop version 1.86.1.
 # The point is for the user to remove these configuration records
 # one by one as the offenses are removed from the code base.
 # Note that changes in the inspected code, or installation of new
@@ -51,7 +51,7 @@ Lint/IneffectiveAccessModifier:
   Exclude:
     - 'lib/lutaml/jsonschema/schema_set.rb'
 
-# Offense count: 14
+# Offense count: 15
 # Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes, Max.
 Metrics/AbcSize:
   Exclude:

data/frontend/src/components/AppSidebar.vue

@@ -180,7 +180,8 @@ const searchResults = computed(() => {
   return schemaStore.searchIndex.filter(entry =>
     entry.name.toLowerCase().includes(q) ||
     (entry.title && entry.title.toLowerCase().includes(q)) ||
-    entry.schemaName.toLowerCase().includes(q),
+    entry.schemaName.toLowerCase().includes(q) ||
+    (entry.description && entry.description.toLowerCase().includes(q)),
   ).slice(0, 15)
 })
 

data/frontend/src/components/SchemaBuilder.vue

@@ -66,7 +66,9 @@
               :value="field.rawValue"
               :disabled="!field.included"
               class="ctrl-number"
+              :class="{ 'ctrl-error': fieldError(field.prop.name) }"
               @input="field.rawValue = ($event.target as HTMLInputElement).value"
+              @blur="validate(field.prop.name, field.rawValue, field.prop)"
             />
 
             <!-- Number -->
@@ -76,11 +78,22 @@
               :value="field.rawValue"
               :disabled="!field.included"
               class="ctrl-number"
+              :class="{ 'ctrl-error': fieldError(field.prop.name) }"
               @input="field.rawValue = ($event.target as HTMLInputElement).value"
+              @blur="validate(field.prop.name, field.rawValue, field.prop)"
             />
 
-            <!-- Object without $ref -->
-            <span v-else-if="isObjectProperty(field.prop)" class="ctrl-static">{"..."}</span>
+            <!-- Object without $ref: editable JSON textarea -->
+            <textarea
+              v-else-if="isObjectProperty(field.prop)"
+              v-model="field.rawValue"
+              :disabled="!field.included"
+              class="ctrl-textarea"
+              :class="{ 'ctrl-error': fieldError(field.prop.name) }"
+              rows="2"
+              placeholder='{"key": "value"}'
+              @blur="validate(field.prop.name, field.rawValue, field.prop)"
+            />
 
             <!-- Array with itemsType -->
             <div v-else-if="primaryType(field.prop.type) === 'array'" class="ctrl-array">
@@ -113,11 +126,17 @@
               :value="field.rawValue"
               :disabled="!field.included"
               class="ctrl-text"
+              :class="{ 'ctrl-error': fieldError(field.prop.name) }"
               @input="field.rawValue = ($event.target as HTMLInputElement).value"
+              @blur="validate(field.prop.name, field.rawValue, field.prop)"
             />
           </div>
         </div>
 
+        <div v-if="fieldError(field.prop.name)" class="field-error-hint">
+          {{ fieldError(field.prop.name) }}
+        </div>
+
         <div v-if="field.prop.description" class="field-desc-wrap">
           <div class="field-desc text-secondary" :class="{ 'desc-collapsed': !descExpanded.has(field.prop.name) && field.prop.description.length > 200 }" v-html="renderInlineMarkdown(field.prop.description)"></div>
           <button v-if="field.prop.description.length > 200" class="btn-see-more" @click="toggleDesc(field.prop.name)">
@@ -215,6 +234,7 @@ import {
   isObjectProperty,
   hasConstraints,
   humanizeConstraints,
+  validateFieldValue,
 } from '../composables/useSchemaTypes'
 import {
   createField,
@@ -256,6 +276,7 @@ const descExpanded = ref(new Set<string>())
 const enumExpanded = ref(new Set<string>())
 
 const MAX_ENUM_SHOW = 8
+const validationErrors = ref<Map<string, string>>(new Map())
 
 function toggleDesc(name: string) {
   const s = new Set(descExpanded.value)
@@ -276,7 +297,19 @@ function toggleEnum(name: string) {
   enumExpanded.value = s
 }
 
-const fields = ref<BuilderField[]>(props.properties.map(p => createField(p, props.required, props.schema, props.allSchemas)))
+function fieldError(name: string): string | undefined {
+  return validationErrors.value.get(name)
+}
+
+function validate(name: string, rawValue: string, prop: SpaProperty) {
+  const err = validateFieldValue(rawValue, prop)
+  const m = new Map(validationErrors.value)
+  if (err) m.set(name, err)
+  else m.delete(name)
+  validationErrors.value = m
+}
+
+const fields = ref<BuilderField[]>(props.properties.map(p => createField(p, props.required, props.schema, props.allSchemas, depth)))
 
 const sortedFields = computed(() => {
   return [...fields.value].sort((a, b) => {
@@ -618,6 +651,21 @@ async function copyJson() {
   border-color: var(--color-primary);
 }
 
+.ctrl-error {
+  border-color: var(--color-red) !important;
+}
+
+.ctrl-error:focus {
+  box-shadow: 0 0 0 2px rgba(179, 31, 36, 0.15);
+}
+
+.field-error-hint {
+  font-size: var(--text-xs);
+  color: var(--color-red);
+  margin-top: 2px;
+  margin-left: 22px;
+}
+
 .ctrl-toggle {
   display: flex;
   align-items: center;
@@ -649,6 +697,28 @@ async function copyJson() {
   color: var(--text-muted);
 }
 
+.ctrl-textarea {
+  width: 100%;
+  padding: 3px 8px;
+  font-size: var(--text-sm);
+  font-family: var(--font-mono);
+  background: var(--bg-primary);
+  border: 1px solid var(--border-light);
+  border-radius: var(--radius-sm);
+  color: var(--text-primary);
+  resize: vertical;
+  min-height: 2em;
+}
+
+.ctrl-textarea:disabled {
+  opacity: 0.35;
+}
+
+.ctrl-textarea:focus {
+  outline: none;
+  border-color: var(--color-primary);
+}
+
 .chevron {
   font-size: 10px;
   transition: transform var(--transition-fast);
@@ -731,10 +801,11 @@ async function copyJson() {
 
 .constraint-chip {
   font-size: 11px;
-  color: var(--text-muted);
-  background: var(--bg-secondary);
+  color: var(--color-primary);
+  background: var(--color-primary-alpha);
   padding: 1px 5px;
   border-radius: var(--radius-sm);
+  border: 1px solid rgba(91, 156, 212, 0.2);
 }
 
 .constraint-chip.chip-pattern {
@@ -768,30 +839,56 @@ async function copyJson() {
 .constraint-chip.chip-locked {
   color: var(--color-orange);
   background: var(--color-orange-alpha);
+  border-color: rgba(234, 86, 36, 0.2);
   font-weight: 500;
 }
 
+.constraint-chip.chip-default {
+  color: var(--text-secondary);
+  background: var(--bg-secondary);
+  border-color: var(--border-light);
+}
+
+.constraint-chip.chip-const {
+  color: var(--color-primary);
+  background: var(--color-primary-alpha);
+  border-color: rgba(91, 156, 212, 0.2);
+}
+
+.constraint-chip.chip-unique {
+  color: var(--color-teal);
+  background: var(--color-teal-alpha);
+  border-color: rgba(96, 195, 167, 0.2);
+}
+
 .constraint-chip.chip-example {
   font-style: italic;
-  color: var(--text-muted);
+  color: var(--text-secondary);
   background: transparent;
   padding: 0;
+  border: none;
   margin-right: 0;
 }
 
 .example-chip {
   font-size: 10px;
   font-family: var(--font-mono);
-  color: var(--color-primary);
-  background: var(--color-primary-alpha);
+  color: var(--text-primary);
+  background: rgba(28, 25, 23, 0.04);
   padding: 1px 5px;
   border-radius: var(--radius-sm);
+  border: 1px solid var(--border-light);
   max-width: 200px;
   overflow: hidden;
   text-overflow: ellipsis;
   white-space: nowrap;
 }
 
+:root[data-theme="dark"] .example-chip {
+  background: rgba(255, 255, 255, 0.06);
+  border-color: var(--border-medium);
+}
+
 /* Enum chips */
 .enum-chip {
   font-size: 10px;
@@ -818,19 +915,29 @@ async function copyJson() {
   border: 1px solid var(--border-light);
   border-radius: var(--radius-md);
   background: var(--bg-secondary);
-  border-left: 3px solid var(--color-primary);
   position: relative;
 }
 
+/* Tree line connector: vertical line from parent to nested section */
 .nested-section::before {
   content: '';
   position: absolute;
   left: -11px;
   top: 0;
   bottom: 0;
-  width: 2px;
-  background: var(--border-light);
-  border-radius: 1px;
+  width: 1px;
+  background: var(--border-medium);
+}
+
+/* Tree line connector: horizontal branch into nested section */
+.nested-section::after {
+  content: '';
+  position: absolute;
+  left: -11px;
+  top: 14px;
+  width: 10px;
+  height: 1px;
+  background: var(--border-medium);
 }
 
 /* Depth-aware alternating backgrounds */
@@ -986,6 +1093,11 @@ async function copyJson() {
   text-decoration: underline;
 }
 
+.json-block :deep(.jv-row:hover) {
+  background: var(--bg-hover);
+  border-radius: 2px;
+}
+
 :root[data-theme="dark"] .json-block :deep(.jv-key) { color: var(--color-primary-light); }
 :root[data-theme="dark"] .json-block :deep(.jv-string) { color: var(--color-teal); }
 

data/frontend/src/composables/useBuilderField.ts

@@ -24,17 +24,19 @@ export function createField(
   requiredNames: string[],
   schema: SpaSchema,
   allSchemas?: SpaSchema[],
+  depth: number = 0,
 ): BuilderField {
   const isReq = requiredNames.includes(prop.name) || prop.required === true
   const def = resolveSchemaRef(prop.ref, schema, allSchemas)
   const isArray = primaryType(prop.type) === 'array'
+  const shouldExpand = depth === 0 && !!def && def.properties.length <= 8
 
   return {
     prop,
     included: isReq,
     isRequired: isReq,
     rawValue: initialValue(prop),
-    expanded: false,
+    expanded: shouldExpand,
     resolvedDef: def,
     nestedJson: def ? buildDefaultJson(def.properties) : {},
     arrayItems: isArray ? [arrayDefaultValue(prop.itemsType)] : [],

data/frontend/src/composables/useSchemaTypes.ts

@@ -16,10 +16,12 @@ export function primaryType(type?: string): string {
  */
 export function displayType(prop: SpaProperty, resolvedTitle?: string): string {
   const t = primaryType(prop.type)
-  if (t === 'array' && prop.itemsType) return `array of ${prop.itemsType}`
-  if (resolvedTitle && (t === 'object' || t === 'any') && prop.ref) return resolvedTitle
-  if (prop.format) return `${t} (${prop.format})`
-  return t
+  const isNullable = (prop.type || '').split(',').map(s => s.trim()).includes('null')
+  const suffix = isNullable ? ' | null' : ''
+  if (t === 'array' && prop.itemsType) return `array of ${prop.itemsType}${suffix}`
+  if (resolvedTitle && (t === 'object' || t === 'any') && prop.ref) return resolvedTitle + suffix
+  if (prop.format) return `${t} (${prop.format})${suffix}`
+  return t + suffix
 }
 
 /**
@@ -69,6 +71,7 @@ export function initialValue(prop: SpaProperty): string {
     case 'number': return '0.0'
     case 'boolean': return 'false'
     case 'string': return formatDefault(prop.format)
+    case 'object': return '{}'
     default: return ''
   }
 }
@@ -158,7 +161,9 @@ export function parsePropertyValue(rawValue: string, prop: SpaProperty): unknown
     const n = parseFloat(rawValue)
     return isNaN(n) ? 0 : n
   }
-  if (t === 'object' && !prop.ref) return {}
+  if (t === 'object' && !prop.ref) {
+    try { return JSON.parse(rawValue) } catch { return {} }
+  }
   return rawValue
 }
 
@@ -261,3 +266,52 @@ export function humanizeConstraints(prop: SpaProperty): ConstraintChip[] {
 
   return chips
 }
+
+export type ValidationError = string
+
+export function validateFieldValue(rawValue: string, prop: SpaProperty): ValidationError | null {
+  const t = primaryType(prop.type)
+
+  if (t === 'string' || t === 'any' || !t) {
+    if (prop.minLength != null && rawValue.length < prop.minLength && rawValue.length > 0) {
+      return `Min ${prop.minLength} characters`
+    }
+    if (prop.maxLength != null && rawValue.length > prop.maxLength) {
+      return `Max ${prop.maxLength} characters`
+    }
+    if (prop.pattern && rawValue.length > 0) {
+      try {
+        if (!new RegExp(prop.pattern).test(rawValue)) {
+          return `Must match /${prop.pattern.length > 30 ? prop.pattern.slice(0, 30) + '…' : prop.pattern}/`
+        }
+      } catch { /* invalid regex, skip */ }
+    }
+  }
+
+  if (t === 'integer' || t === 'number') {
+    const n = t === 'integer' ? parseInt(rawValue, 10) : parseFloat(rawValue)
+    if (rawValue !== '' && isNaN(n)) return 'Invalid number'
+    if (!isNaN(n)) {
+      if (prop.minimum != null && n < prop.minimum) return `Must be >= ${prop.minimum}`
+      if (prop.maximum != null && n > prop.maximum) return `Must be <= ${prop.maximum}`
+      if (prop.exclusiveMinimum != null && n <= prop.exclusiveMinimum) return `Must be > ${prop.exclusiveMinimum}`
+      if (prop.exclusiveMaximum != null && n >= prop.exclusiveMaximum) return `Must be < ${prop.exclusiveMaximum}`
+      if (prop.multipleOf != null && n % prop.multipleOf !== 0) return `Must be multiple of ${prop.multipleOf}`
+    }
+  }
+
+  if (t === 'array') {
+    if (rawValue.length > 0) {
+      try {
+        const arr = JSON.parse(rawValue)
+        if (Array.isArray(arr)) {
+          if (prop.minItems != null && arr.length < prop.minItems) return `Min ${prop.minItems} items`
+          if (prop.maxItems != null && arr.length > prop.maxItems) return `Max ${prop.maxItems} items`
+          if (prop.uniqueItems && new Set(arr).size !== arr.length) return 'Items must be unique'
+        }
+      } catch { /* not JSON, skip */ }
+    }
+  }
+
+  return null
+}

data/frontend/src/composables/useSearch.ts

@@ -8,6 +8,7 @@ interface SearchResult {
   name: string
   rawName: string
   schemaName: string
+  description?: string
 }
 
 export function useSearch() {
@@ -26,6 +27,7 @@ export function useSearch() {
       name: entry.title || entry.name,
       rawName: entry.name,
       schemaName: entry.schemaName,
+      description: entry.description,
     }))
   }
 
@@ -41,7 +43,8 @@ export function useSearch() {
 
     results.value = entries.filter(e =>
       e.name.toLowerCase().includes(q) ||
-      e.schemaName.toLowerCase().includes(q)
+      e.schemaName.toLowerCase().includes(q) ||
+      (e.description && e.description.toLowerCase().includes(q))
     ).slice(0, 50)
 
     isSearching.value = false

data/frontend/src/stores/uiStore.ts

@@ -8,7 +8,7 @@ export const useUiStore = defineStore('ui', () => {
   const resolvedTheme = ref<'light' | 'dark'>('light')
   const sidebarCollapsed = ref(false)
   const detailPanelOpen = ref(false)
-  const activePanelTab = ref<'overview' | 'definition'>('overview')
+  const activePanelTab = ref<'overview' | 'properties' | 'examples'>('overview')
   const searchOpen = ref(false)
   const expandedSchemaNames = ref<Set<string>>(new Set())
 
@@ -47,7 +47,7 @@ export const useUiStore = defineStore('ui', () => {
   function toggleSidebar() { sidebarCollapsed.value = !sidebarCollapsed.value }
   function openDetailPanel() { detailPanelOpen.value = true }
   function closeDetailPanel() { detailPanelOpen.value = false }
-  function setPanelTab(tab: 'overview' | 'definition') { activePanelTab.value = tab }
+  function setPanelTab(tab: 'overview' | 'properties' | 'examples') { activePanelTab.value = tab }
   function openSearch() { searchOpen.value = true }
   function closeSearch() { searchOpen.value = false }
 

data/frontend/src/types.ts

@@ -52,6 +52,10 @@ export interface SpaDefinition {
   examples?: string[]
   minProperties?: number
   maxProperties?: number
+  additionalProperties?: boolean
+  hasAllOf?: boolean
+  hasAnyOf?: boolean
+  hasOneOf?: boolean
 }
 
 export interface SpaSchema {
@@ -77,6 +81,7 @@ export interface SpaSchema {
 export interface SpaSearchEntry {
   name: string
   title?: string
+  description?: string
   type: string
   schemaName: string
 }

data/frontend/src/views/HomeView.vue

@@ -89,6 +89,10 @@
               <span v-if="def.examples?.length" class="text-muted">&middot; {{ def.examples.length }} ex</span>
               <span v-if="def.minProperties != null" class="text-muted">&middot; min {{ def.minProperties }}</span>
               <span v-if="def.maxProperties != null" class="text-muted">&middot; max {{ def.maxProperties }}</span>
+              <span v-if="def.additionalProperties === false" class="badge badge-locked">no additional</span>
+              <span v-if="def.hasAllOf" class="badge badge-composition">allOf</span>
+              <span v-if="def.hasAnyOf" class="badge badge-composition">anyOf</span>
+              <span v-if="def.hasOneOf" class="badge badge-composition">oneOf</span>
             </div>
             <div class="def-card-info">
               <p v-if="def.description" class="def-card-desc text-secondary" v-html="renderInlineMarkdown(def.description)"></p>
@@ -166,7 +170,7 @@
           class="btn btn-outline btn-sm"
           @click="downloadAllSchemas"
         >
-          Download All Schemas (.zip)
+          Download All Schemas
         </button>
       </div>
 

data/lib/lutaml/jsonschema/spa/spa_builder.rb

@@ -168,6 +168,10 @@ module Lutaml
               examples: s.examples,
               min_properties: s.min_properties,
               max_properties: s.max_properties,
+              additional_properties: s.additional_properties,
+              has_all_of: s.all_of.any?,
+              has_any_of: s.any_of.any?,
+              has_one_of: s.one_of.any?,
             )
           end
         end
@@ -232,6 +236,7 @@ module Lutaml
             entries = [SpaSearchEntry.new(
               name: spa_schema.name,
               title: spa_schema.title,
+              description: spa_schema.description,
               type: "schema",
               schema_name: spa_schema.name,
             )]
@@ -240,6 +245,7 @@ module Lutaml
               entries << SpaSearchEntry.new(
                 name: prop.name,
                 title: prop.title,
+                description: prop.description,
                 type: "property",
                 schema_name: spa_schema.name,
               )
@@ -249,6 +255,7 @@ module Lutaml
               entries << SpaSearchEntry.new(
                 name: defn.name,
                 title: defn.title,
+                description: defn.description,
                 type: "definition",
                 schema_name: spa_schema.name,
               )
@@ -257,6 +264,7 @@ module Lutaml
                 entries << SpaSearchEntry.new(
                   name: prop.name,
                   title: prop.title,
+                  description: prop.description,
                   type: "property",
                   schema_name: spa_schema.name,
                 )

data/lib/lutaml/jsonschema/spa/spa_definition.rb

@@ -14,6 +14,10 @@ module Lutaml
         attribute :examples, :string, collection: true
         attribute :min_properties, :integer
         attribute :max_properties, :integer
+        attribute :additional_properties, :boolean
+        attribute :has_all_of, :boolean
+        attribute :has_any_of, :boolean
+        attribute :has_one_of, :boolean
 
         json do
           map "name", to: :name
@@ -25,6 +29,10 @@ module Lutaml
           map "examples", to: :examples
           map "minProperties", to: :min_properties
           map "maxProperties", to: :max_properties
+          map "additionalProperties", to: :additional_properties
+          map "hasAllOf", to: :has_all_of
+          map "hasAnyOf", to: :has_any_of
+          map "hasOneOf", to: :has_one_of
         end
       end
     end

data/lib/lutaml/jsonschema/spa/spa_search_entry.rb

@@ -6,12 +6,14 @@ module Lutaml
       class SpaSearchEntry < Base
         attribute :name, :string
         attribute :title, :string
+        attribute :description, :string
         attribute :type, :string
         attribute :schema_name, :string
 
         json do
           map "name", to: :name
           map "title", to: :title
+          map "description", to: :description
           map "type", to: :type
           map "schemaName", to: :schema_name
         end

data/lib/lutaml/jsonschema/version.rb

@@ -2,6 +2,6 @@
 
 module Lutaml
   module Jsonschema
-    VERSION = "0.1.6"
+    VERSION = "0.1.8"
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lutaml-jsonschema
 version: !ruby/object:Gem::Version
-  version: 0.1.6
+  version: 0.1.8
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-05-07 00:00:00.000000000 Z
+date: 2026-05-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: json