lutaml-jsonschema 0.1.16 → 0.1.19

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4a225cce2d635b5a3d8b1376087e61b6f20e319ed84b34bc543812279bb7c6f2
-  data.tar.gz: 394d28b298c43654eb7d6f6614b310ef31311a0e51d6a537f41b70e947010fa6
+  metadata.gz: 7bedeb19c89b4d8d95067a18bb2b5fa17532e2730f6fbfe1da8584bfc70ae05a
+  data.tar.gz: 9221e7c2a1e0324aa9a1325831b36bf664f121466f02de6f07b940e0063830de
 SHA512:
-  metadata.gz: 6f1f62960e78d9e07ac390fc37ab7c8e0853cbaeaefdaa12843bc41ceb17aecfdaa2193dcf26e382034008b4377fcedfad4094648ce858a611b431cfe78ead7c
-  data.tar.gz: 9f1e1c38bd3335511264282a1e5d49cb74b4bb850a43ee58355fb64b422efb68415b778eda4540a79fbaf933bc265a583b0089b85b8bb5843da0709b9ddafd4e
+  metadata.gz: 60122241ce61b4ee49095aed3def11f74cac1f8bccecabb8189cc944a8979d904b54a505024cd9518f0943ea6f48e9a8690452e2681d1db8df654a43a3107965
+  data.tar.gz: f20ae2131c15ed7819318d97e9ca13d38307473900a9946ca8a39412798b5d6ebca25d32dfc3c9eef170a810c84a36b7e09455a1797cffc86fd3a8f3fa552c99

data/.rubocop_todo.yml

@@ -1,6 +1,6 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2026-05-14 10:12:34 UTC using RuboCop version 1.86.1.
+# on 2026-06-08 13:01:45 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
@@ -11,33 +11,146 @@ Gemspec/RequiredRubyVersion:
   Exclude:
     - 'lutaml-jsonschema.gemspec'
 
-# Offense count: 1
+# Offense count: 39
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle, IndentationWidth.
+# SupportedStyles: with_first_argument, with_fixed_indentation
+Layout/ArgumentAlignment:
+  Exclude:
+    - 'lib/lutaml/jsonschema/cli.rb'
+    - 'lib/lutaml/jsonschema/schema_store.rb'
+    - 'lib/lutaml/jsonschema/spa/spa_builder.rb'
+    - 'spec/e2e/spa_e2e_spec.rb'
+    - 'spec/lutaml/configuration_spec.rb'
+    - 'spec/lutaml/jsonschema/schema_store_spec.rb'
+    - 'spec/lutaml/spa/spa_definition_spec.rb'
+
+# Offense count: 2
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle, IndentationWidth.
+# SupportedStyles: with_first_element, with_fixed_indentation
+Layout/ArrayAlignment:
+  Exclude:
+    - 'lib/lutaml/jsonschema/spa/spa_builder.rb'
+    - 'spec/e2e/spa_e2e_spec.rb'
+
+# Offense count: 34
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: EnforcedStyleAlignWith.
 # SupportedStylesAlignWith: either, start_of_block, start_of_line
 Layout/BlockAlignment:
   Exclude:
+    - 'lib/lutaml/jsonschema/schema.rb'
     - 'lib/lutaml/jsonschema/spa/spa_builder.rb'
+    - 'spec/e2e/spa_e2e_spec.rb'
+    - 'spec/lutaml/generator_spec.rb'
+
+# Offense count: 29
+# This cop supports safe autocorrection (--autocorrect).
+Layout/BlockEndNewline:
+  Exclude:
+    - 'lib/lutaml/jsonschema/schema.rb'
+    - 'spec/e2e/spa_e2e_spec.rb'
+    - 'spec/lutaml/generator_spec.rb'
+
+# Offense count: 7
+# This cop supports safe autocorrection (--autocorrect).
+Layout/ElseAlignment:
+  Exclude:
+    - 'lib/lutaml/jsonschema/schema_store.rb'
+    - 'lib/lutaml/jsonschema/spa/spa_builder.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+Layout/EmptyLineAfterGuardClause:
+  Exclude:
+    - 'lib/lutaml/jsonschema/schema_store.rb'
+
+# Offense count: 8
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyleAlignWith.
+# SupportedStylesAlignWith: keyword, variable, start_of_line
+Layout/EndAlignment:
+  Exclude:
+    - 'lib/lutaml/jsonschema/schema_store.rb'
+    - 'lib/lutaml/jsonschema/spa/spa_builder.rb'
+
+# Offense count: 36
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle, IndentationWidth.
+# SupportedStyles: special_inside_parentheses, consistent, align_braces
+Layout/FirstHashElementIndentation:
+  Exclude:
+    - 'spec/lutaml/jsonschema_spec.rb'
+    - 'spec/lutaml/schema/each_child_spec.rb'
 
 # Offense count: 28
 # This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowMultipleStyles, EnforcedHashRocketStyle, EnforcedColonStyle, EnforcedLastArgumentHashStyle.
+# SupportedHashRocketStyles: key, separator, table
+# SupportedColonStyles: key, separator, table
+# SupportedLastArgumentHashStyles: always_inspect, always_ignore, ignore_implicit, ignore_explicit
+Layout/HashAlignment:
+  Exclude:
+    - 'lib/lutaml/jsonschema/cli.rb'
+    - 'lib/lutaml/jsonschema/schema_store.rb'
+    - 'lib/lutaml/jsonschema/spa/spa_definition.rb'
+    - 'lib/lutaml/jsonschema/spa/spa_property.rb'
+    - 'lib/lutaml/jsonschema/spa/spa_schema.rb'
+    - 'spec/lutaml/configuration_spec.rb'
+    - 'spec/lutaml/jsonschema/schema_store_spec.rb'
+    - 'spec/lutaml/jsonschema_spec.rb'
+    - 'spec/lutaml/schema/each_child_spec.rb'
+    - 'spec/lutaml/spa/spa_definition_spec.rb'
+
+# Offense count: 67
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: Width, EnforcedStyleAlignWith, AllowedPatterns.
+# SupportedStylesAlignWith: start_of_line, relative_to_receiver
+Layout/IndentationWidth:
+  Exclude:
+    - 'lib/lutaml/jsonschema/schema.rb'
+    - 'lib/lutaml/jsonschema/schema_store.rb'
+    - 'lib/lutaml/jsonschema/spa/spa_builder.rb'
+    - 'spec/e2e/spa_e2e_spec.rb'
+    - 'spec/lutaml/generator_spec.rb'
+
+# Offense count: 116
+# This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: Max, AllowHeredoc, AllowURI, AllowQualifiedName, URISchemes, AllowRBSInlineAnnotation, AllowCopDirectives, AllowedPatterns, SplitStrings.
 # URISchemes: http, https
 Layout/LineLength:
+  Enabled: false
+
+# Offense count: 4
+# This cop supports safe autocorrection (--autocorrect).
+Layout/MultilineBlockLayout:
+  Exclude:
+    - 'spec/e2e/spa_e2e_spec.rb'
+
+# Offense count: 2
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle.
+# SupportedStyles: symmetrical, new_line, same_line
+Layout/MultilineHashBraceLayout:
+  Exclude:
+    - 'spec/lutaml/jsonschema_spec.rb'
+    - 'spec/lutaml/schema/each_child_spec.rb'
+
+# Offense count: 35
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowInHeredoc.
+Layout/TrailingWhitespace:
   Exclude:
-    - 'lib/lutaml/jsonschema/base.rb'
     - 'lib/lutaml/jsonschema/cli.rb'
-    - 'lib/lutaml/jsonschema/combiner.rb'
-    - 'lib/lutaml/jsonschema/schema.rb'
-    - 'lib/lutaml/jsonschema/schema_set.rb'
+    - 'lib/lutaml/jsonschema/schema_store.rb'
     - 'lib/lutaml/jsonschema/spa/spa_builder.rb'
-    - 'lib/lutaml/jsonschema/spa/vue_inlined_strategy.rb'
-    - 'lutaml-jsonschema.gemspec'
-    - 'spec/lutaml/integration_spec.rb'
+    - 'spec/e2e/spa_e2e_spec.rb'
+    - 'spec/lutaml/configuration_spec.rb'
+    - 'spec/lutaml/jsonschema/schema_store_spec.rb'
     - 'spec/lutaml/jsonschema_spec.rb'
-    - 'spec/lutaml/schema_set_cross_ref_spec.rb'
-    - 'spec/lutaml/schema_set_resolution_spec.rb'
-    - 'spec/lutaml/spa_builder_spec.rb'
+    - 'spec/lutaml/schema/each_child_spec.rb'
+    - 'spec/lutaml/spa/spa_definition_spec.rb'
 
 # Offense count: 2
 # Configuration parameters: IgnoreLiteralBranches, IgnoreConstantBranches, IgnoreDuplicateElseBranch.
@@ -51,7 +164,15 @@ Lint/IneffectiveAccessModifier:
   Exclude:
     - 'lib/lutaml/jsonschema/schema_set.rb'
 
-# Offense count: 16
+# Offense count: 3
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowUnusedKeywordArguments, IgnoreEmptyMethods, IgnoreNotImplementedMethods, NotImplementedExceptions.
+# NotImplementedExceptions: NotImplementedError
+Lint/UnusedMethodArgument:
+  Exclude:
+    - 'lib/lutaml/jsonschema/spa/spa_builder.rb'
+
+# Offense count: 21
 # Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes, Max.
 Metrics/AbcSize:
   Exclude:
@@ -59,44 +180,45 @@ Metrics/AbcSize:
     - 'lib/lutaml/jsonschema/combiner.rb'
     - 'lib/lutaml/jsonschema/configuration.rb'
     - 'lib/lutaml/jsonschema/reference_resolver.rb'
-    - 'lib/lutaml/jsonschema/schema_set.rb'
+    - 'lib/lutaml/jsonschema/schema.rb'
     - 'lib/lutaml/jsonschema/spa/spa_builder.rb'
 
-# Offense count: 3
+# Offense count: 6
 # Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
 # AllowedMethods: refine
 Metrics/BlockLength:
   Max: 54
 
-# Offense count: 8
+# Offense count: 12
 # Configuration parameters: AllowedMethods, AllowedPatterns, Max.
 Metrics/CyclomaticComplexity:
   Exclude:
     - 'lib/lutaml/jsonschema/cli.rb'
-    - 'lib/lutaml/jsonschema/combiner.rb'
-    - 'lib/lutaml/jsonschema/configuration.rb'
     - 'lib/lutaml/jsonschema/reference_resolver.rb'
+    - 'lib/lutaml/jsonschema/schema.rb'
     - 'lib/lutaml/jsonschema/schema_set.rb'
+    - 'lib/lutaml/jsonschema/spa/spa_builder.rb'
 
-# Offense count: 17
+# Offense count: 22
 # Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
 Metrics/MethodLength:
-  Max: 47
+  Max: 70
 
-# Offense count: 6
+# Offense count: 9
 # Configuration parameters: AllowedMethods, AllowedPatterns, Max.
 Metrics/PerceivedComplexity:
   Exclude:
-    - 'lib/lutaml/jsonschema/combiner.rb'
-    - 'lib/lutaml/jsonschema/configuration.rb'
     - 'lib/lutaml/jsonschema/reference_resolver.rb'
+    - 'lib/lutaml/jsonschema/schema.rb'
     - 'lib/lutaml/jsonschema/schema_set.rb'
+    - 'lib/lutaml/jsonschema/spa/spa_builder.rb'
 
-# Offense count: 1
+# Offense count: 2
 # Configuration parameters: MinNameLength, AllowNamesEndingInNumbers, AllowedNames, ForbiddenNames.
 # AllowedNames: as, at, by, cc, db, id, if, in, io, ip, of, on, os, pp, to
 Naming/MethodParameterName:
   Exclude:
+    - 'lib/lutaml/jsonschema/spa/spa_builder.rb'
     - 'lib/lutaml/jsonschema/spa/vue_inlined_strategy.rb'
 
 # Offense count: 1
@@ -107,8 +229,71 @@ Naming/PredicateMethod:
   Exclude:
     - 'lib/lutaml/jsonschema/schema_set.rb'
 
+# Offense count: 51
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle, ProceduralMethods, FunctionalMethods, AllowedMethods, AllowedPatterns, AllowBracesOnProceduralOneLiners, BracesRequiredMethods.
+# SupportedStyles: line_count_based, semantic, braces_for_chaining, always_braces
+# ProceduralMethods: benchmark, bm, bmbm, create, each_with_object, measure, new, realtime, tap, with_object
+# FunctionalMethods: let, let!, subject, watch
+# AllowedMethods: lambda, proc, it
+Style/BlockDelimiters:
+  Exclude:
+    - 'lib/lutaml/jsonschema/schema.rb'
+    - 'spec/e2e/spa_e2e_spec.rb'
+    - 'spec/lutaml/generator_spec.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle, AllowComments.
+# SupportedStyles: empty, nil, both
+Style/EmptyElse:
+  Exclude:
+    - 'lib/lutaml/jsonschema/schema_store.rb'
+
 # Offense count: 2
 # This cop supports unsafe autocorrection (--autocorrect-all).
 Style/IdenticalConditionalBranches:
   Exclude:
     - 'spec/lutaml/spa_builder_spec.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+Style/MultilineIfModifier:
+  Exclude:
+    - 'lib/lutaml/jsonschema/schema_store.rb'
+
+# Offense count: 7
+# This cop supports safe autocorrection (--autocorrect).
+Style/MultilineTernaryOperator:
+  Exclude:
+    - 'lib/lutaml/jsonschema/schema_store.rb'
+    - 'lib/lutaml/jsonschema/spa/spa_builder.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+Style/RedundantStringEscape:
+  Exclude:
+    - 'spec/lutaml/schema/each_child_spec.rb'
+
+# Offense count: 2
+# This cop supports unsafe autocorrection (--autocorrect-all).
+Style/SingleArgumentDig:
+  Exclude:
+    - 'spec/e2e/spa_e2e_spec.rb'
+
+# Offense count: 2
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyleForMultiline.
+# SupportedStylesForMultiline: comma, consistent_comma, diff_comma, no_comma
+Style/TrailingCommaInArguments:
+  Exclude:
+    - 'lib/lutaml/jsonschema/ljr_package_definition.rb'
+    - 'spec/lutaml/spa/generator_spec.rb'
+
+# Offense count: 4
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyleForMultiline.
+# SupportedStylesForMultiline: comma, consistent_comma, diff_comma, no_comma
+Style/TrailingCommaInArrayLiteral:
+  Exclude:
+    - 'spec/e2e/spa_e2e_spec.rb'

data/exe/lutaml-jsonschema

@@ -1,6 +1,6 @@
 #!/usr/bin/env ruby
 # frozen_string_literal: true
 
-require "lutaml/jsonschema/cli"
+require "lutaml/jsonschema"
 
 Lutaml::Jsonschema::Cli.start(ARGV)

data/frontend/src/__tests__/spaDataCompleteness.test.ts

@@ -0,0 +1,338 @@
+/**
+ * @vitest-environment jsdom
+ */
+import { describe, it, expect, beforeEach } from 'vitest'
+import { createPinia, setActivePinia } from 'pinia'
+import { useSchemaStore } from '../stores/schemaStore'
+import {
+  primaryType,
+  displayType,
+  refLabel,
+  humanizeConstraints,
+  hasConstraints,
+} from '../composables/useSchemaTypes'
+import { resolveSchemaRef } from '../composables/useDefinitionResolver'
+import { createField, buildDefaultJson } from '../composables/useBuilderField'
+import type { SpaDocument, SpaProperty, SpaDefinition, SpaSchema } from '../types'
+
+function prop(overrides: Partial<SpaProperty> = {}): SpaProperty {
+  return { name: 'test', ...overrides }
+}
+
+function definition(overrides: Partial<SpaDefinition> = {}): SpaDefinition {
+  return { name: 'Test', properties: [], required: [], ...overrides }
+}
+
+function schema(overrides: Partial<SpaSchema> = {}): SpaSchema {
+  return { name: 'TestSchema', properties: [], definitions: [], required: [], ...overrides }
+}
+
+/**
+ * Build a SpaDocument that mimics what the Ruby backend outputs
+ * for a complex schema like ISO 19115-4 mdj.json.
+ */
+function buildComplexDoc(): SpaDocument {
+  const mdIdentifier: SpaDefinition = {
+    name: 'MD_Identifier',
+    title: 'Identifier',
+    type: 'object',
+    properties: [
+      prop({ name: 'code', type: 'string', required: true }),
+      prop({ name: 'codeSpace', type: 'string', format: 'uri' }),
+    ],
+    required: ['code'],
+  }
+
+  const topicCategory: SpaDefinition = {
+    name: 'MD_TopicCategoryCode',
+    title: 'Topic Category',
+    type: 'string',
+    enum: ['farming', 'biota', 'boundaries', 'climatology', 'economy', 'elevation'],
+    properties: [],
+    required: [],
+  }
+
+  const obligationCode: SpaDefinition = {
+    name: 'MD_ObligationCode',
+    type: 'string',
+    enum: ['mandatory', 'optional', 'conditional'],
+    properties: [],
+    required: [],
+  }
+
+  const ciTelephone: SpaDefinition = {
+    name: 'CI_Telephone',
+    type: 'object',
+    properties: [
+      prop({ name: 'number', type: 'string' }),
+    ],
+    required: [],
+  }
+
+  const durationType: SpaDefinition = {
+    name: 'DurationType',
+    type: 'string',
+    format: 'duration',
+    pattern: '^P.*$',
+    properties: [],
+    required: [],
+  }
+
+  const constraintUnion: SpaDefinition = {
+    name: 'Abstract_ConstraintUnion',
+    hasOneOf: true,
+    properties: [],
+    required: [],
+  }
+
+  const mdMetadata: SpaDefinition = {
+    name: 'MD_Metadata',
+    title: 'Metadata',
+    type: 'object',
+    description: 'Root metadata object',
+    properties: [
+      prop({ name: 'name', type: 'string', required: true }),
+      prop({
+        name: 'identifiers',
+        type: 'array',
+        itemsType: 'object',
+        itemsRef: '#/$defs/MD_Identifier',
+      }),
+      prop({
+        name: 'topicCategory',
+        ref: '#/$defs/MD_TopicCategoryCode',
+        type: 'string',
+        enum: ['farming', 'biota', 'boundaries', 'climatology', 'economy', 'elevation'],
+      }),
+      prop({
+        name: 'contacts',
+        type: 'array',
+        itemsType: 'object',
+        itemsRef: '#/$defs/CI_Contact',
+        minItems: 1,
+      }),
+    ],
+    required: ['name'],
+  }
+
+  const ciContact: SpaDefinition = {
+    name: 'CI_Contact',
+    type: 'object',
+    properties: [
+      prop({
+        name: 'phone',
+        type: 'array',
+        itemsType: 'object',
+        itemsRef: '#/$defs/CI_Telephone',
+      }),
+    ],
+    required: [],
+  }
+
+  return {
+    metadata: { title: 'ISO 19115-4 Metadata' },
+    schemas: [{
+      name: 'mdj',
+      title: 'ISO 19115-4',
+      type: 'object',
+      properties: [],
+      definitions: [
+        mdMetadata,
+        mdIdentifier,
+        topicCategory,
+        obligationCode,
+        ciContact,
+        ciTelephone,
+        durationType,
+        constraintUnion,
+      ],
+      required: [],
+      sourceJson: '{}',
+    }],
+    searchIndex: [],
+  }
+}
+
+describe('SPA data completeness for complex schemas', () => {
+  let store: ReturnType<typeof useSchemaStore>
+
+  beforeEach(() => {
+    setActivePinia(createPinia())
+    store = useSchemaStore()
+  })
+
+  describe('backend data integrity', () => {
+    const doc = buildComplexDoc()
+
+    it('array properties have itemsRef resolved from items.$ref', () => {
+      const mdMetadata = doc.schemas[0].definitions.find(d => d.name === 'MD_Metadata')!
+      const identifiers = mdMetadata.properties.find(p => p.name === 'identifiers')!
+      expect(identifiers.itemsRef).toBe('#/$defs/MD_Identifier')
+      expect(identifiers.itemsType).toBe('object')
+    })
+
+    it('array properties with itemsRef show correct display type', () => {
+      const mdMetadata = doc.schemas[0].definitions.find(d => d.name === 'MD_Metadata')!
+      const identifiers = mdMetadata.properties.find(p => p.name === 'identifiers')!
+      expect(displayType(identifiers)).toBe('array of MD_Identifier')
+    })
+
+    it('enum definitions carry their enum values', () => {
+      const topicCat = doc.schemas[0].definitions.find(d => d.name === 'MD_TopicCategoryCode')!
+      expect(topicCat.enum).toHaveLength(6)
+      expect(topicCat.enum).toContain('farming')
+      expect(topicCat.enum).toContain('elevation')
+    })
+
+    it('properties resolved from enum definitions carry enum values', () => {
+      const mdMetadata = doc.schemas[0].definitions.find(d => d.name === 'MD_Metadata')!
+      const topic = mdMetadata.properties.find(p => p.name === 'topicCategory')!
+      expect(topic.enum).toHaveLength(6)
+      expect(topic.ref).toBe('#/$defs/MD_TopicCategoryCode')
+    })
+
+    it('format and pattern on non-object definitions are preserved', () => {
+      const duration = doc.schemas[0].definitions.find(d => d.name === 'DurationType')!
+      expect(duration.format).toBe('duration')
+      expect(duration.pattern).toBe('^P.*$')
+    })
+
+    it('minItems on array properties is preserved', () => {
+      const mdMetadata = doc.schemas[0].definitions.find(d => d.name === 'MD_Metadata')!
+      const contacts = mdMetadata.properties.find(p => p.name === 'contacts')!
+      expect(contacts.minItems).toBe(1)
+    })
+
+    it('nested array itemsRef through definition chain', () => {
+      const ciContact = doc.schemas[0].definitions.find(d => d.name === 'CI_Contact')!
+      const phone = ciContact.properties.find(p => p.name === 'phone')!
+      expect(phone.itemsRef).toBe('#/$defs/CI_Telephone')
+    })
+
+    it('hasOneOf flag on union definitions', () => {
+      const constraint = doc.schemas[0].definitions.find(d => d.name === 'Abstract_ConstraintUnion')!
+      expect(constraint.hasOneOf).toBe(true)
+    })
+  })
+
+  describe('frontend rendering with store', () => {
+    it('store loads complex document and resolves definitions', () => {
+      window.SCHEMA_DATA = buildComplexDoc() as any
+      store.loadFromWindow()
+
+      const schemas = store.schemas
+      expect(schemas).toHaveLength(1)
+      expect(schemas[0].definitions).toHaveLength(8)
+    })
+
+    it('store normalizes $ref → ref on nested definition properties', () => {
+      const doc = buildComplexDoc()
+      // Simulate backend output where $ref is the JSON key
+      const topicProp = doc.schemas[0].definitions[0].properties.find(p => p.name === 'topicCategory')!
+      ;(topicProp as any).$ref = topicProp.ref
+      delete topicProp.ref
+
+      window.SCHEMA_DATA = doc as any
+      store.loadFromWindow()
+
+      const mdMetadata = store.schemas[0].definitions.find(d => d.name === 'MD_Metadata')!
+      const topic = mdMetadata.properties.find(p => p.name === 'topicCategory')!
+      expect(topic.ref).toBe('#/$defs/MD_TopicCategoryCode')
+      expect((topic as any).$ref).toBeUndefined()
+    })
+
+    it('definition resolver finds enum definitions', () => {
+      const s = schema({
+        definitions: [
+          definition({ name: 'MD_TopicCategoryCode', type: 'string', enum: ['farming', 'biota'] }),
+        ],
+      })
+      const resolved = resolveSchemaRef('#/$defs/MD_TopicCategoryCode', s)
+      expect(resolved).not.toBeNull()
+      expect(resolved!.enum).toEqual(['farming', 'biota'])
+    })
+  })
+
+  describe('type display for complex schema patterns', () => {
+    it('refLabel extracts definition name from $defs path', () => {
+      expect(refLabel('#/$defs/MD_Identifier')).toBe('MD_Identifier')
+    })
+
+    it('refLabel handles definitions path', () => {
+      expect(refLabel('#/definitions/address')).toBe('address')
+    })
+
+    it('displayType for array with itemsRef', () => {
+      expect(displayType(prop({ type: 'array', itemsRef: '#/$defs/MD_Identifier' }))).toBe('array of MD_Identifier')
+    })
+
+    it('prefers itemsRef label when itemsType is generic object', () => {
+      expect(displayType(prop({ type: 'array', itemsType: 'object', itemsRef: '#/$defs/Foo' }))).toBe('array of Foo')
+    })
+
+    it('uses itemsType when it is a specific primitive type', () => {
+      expect(displayType(prop({ type: 'array', itemsType: 'string', itemsRef: '#/$defs/Foo' }))).toBe('array of string')
+    })
+
+    it('displayType for array with itemsRef and constraints', () => {
+      const p = prop({ type: 'array', itemsRef: '#/$defs/MD_Identifier', minItems: 1, maxItems: 10 })
+      expect(displayType(p)).toBe('array of MD_Identifier [ 1 .. 10 ]')
+    })
+
+    it('displayType for nullable array with itemsRef', () => {
+      expect(displayType(prop({ type: 'array,null', itemsRef: '#/$defs/Item' }))).toBe('array of Item | null')
+    })
+  })
+
+  describe('builder field creation for complex properties', () => {
+    it('creates field for array property with itemsRef', () => {
+      const p = prop({ name: 'ids', type: 'array', itemsType: 'object', itemsRef: '#/$defs/MD_Identifier' })
+      const s = schema({
+        definitions: [definition({ name: 'MD_Identifier', type: 'object', properties: [prop({ name: 'code', type: 'string' })], required: [] })],
+      })
+      const field = createField(p, [], s)
+      expect(field.arrayItems).toHaveLength(1)
+      expect(field.resolvedDef).toBeNull()
+    })
+
+    it('creates field for property resolved from enum definition', () => {
+      const p = prop({
+        name: 'topic',
+        ref: '#/$defs/MD_TopicCategoryCode',
+        type: 'string',
+        enum: ['farming', 'biota', 'boundaries'],
+      })
+      const s = schema({
+        definitions: [definition({ name: 'MD_TopicCategoryCode', type: 'string', enum: ['farming', 'biota', 'boundaries'], properties: [], required: [] })],
+      })
+      const field = createField(p, [], s)
+      // Enum property should have first enum as initial value
+      expect(field.rawValue).toBe('farming')
+    })
+
+    it('buildDefaultJson handles array items with itemsRef', () => {
+      const props = [
+        prop({ name: 'tags', type: 'array', itemsType: 'string' }),
+      ]
+      const json = buildDefaultJson(props)
+      expect(json.tags).toEqual([''])
+    })
+  })
+
+  describe('constraint chips for complex definitions', () => {
+    it('enum definition has constraints detected via property resolver', () => {
+      const p = prop({
+        name: 'topic',
+        type: 'string',
+        enum: ['farming', 'biota'],
+        ref: '#/$defs/MD_TopicCategoryCode',
+      })
+      expect(hasConstraints(p)).toBe(true)
+    })
+
+    it('array with itemsRef and minItems has constraints', () => {
+      const p = prop({ name: 'items', type: 'array', itemsRef: '#/$defs/X', minItems: 1 })
+      expect(hasConstraints(p)).toBe(true)
+    })
+  })
+})