lutaml-jsonschema 0.1.21 → 0.1.23

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6367122d5d8cddc7d769bb53f32ef6c38d95a3cb593a68b464ffc6ac585848a0
-  data.tar.gz: 4282e0238d96e58704eebba108a24a6b618998a6d032866f9c0919f8738e16fa
+  metadata.gz: f6542de697d4e9bb258f8b2291430b9cc8c2244ec3b46ac7e30e92b7192e5d19
+  data.tar.gz: bc5641c42ecc85dad8098eb35302ff26ff2912f9f1a207f70301a4960a2e3883
 SHA512:
-  metadata.gz: 46e4fe4d1fb735eed28f9fbf96affb399fc95b9de3e0c32d8939682317dcae7717babfc62d37897b0775bb49a9bb76eb260caa05ab1a07f25aa8aed8483833f7
-  data.tar.gz: aa36b217700c79cdb68bf19ddf52598fbfa314eee1c70533df85f903b3e031d4292075a43324af0ca1b90ebc03256cea50514f542d0921ab76c9556e903dec48
+  metadata.gz: fc41187d4a77c7a6c1c613696f1687595968928478bc4e6ee0fdcdb0a1fcca21816655efc36ca2989ddd6ed72bae238bc5e16dc949a3237138e234050b038433
+  data.tar.gz: bea291d15415a80a8487c44143065aec658e3a00c6235703de99bba8907e43f1377e2f4bf23fd4acfffdef8abadc25eecf748884da6175a183c7191b2bfc704e

data/CLAUDE.md

@@ -0,0 +1,55 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## What this is
+
+`lutaml-jsonschema` parses JSON Schema documents into lutaml-model objects and generates a single-file SPA documentation site from them. It has two halves that must stay in sync:
+
+1. **Ruby gem** (`lib/lutaml/jsonschema/`) — the JSON Schema model and documentation generator.
+2. **Vue 3 frontend** (`frontend/`) — the SPA itself. The built bundle (`frontend/dist/app.iife.js` + `style.css`) gets inlined into a standalone `index.html`.
+
+## Commands
+
+```sh
+bundle exec rspec                          # full suite
+bundle exec rspec spec/lutaml/cli_spec.rb  # one file
+bundle exec rspec spec/lutaml/cli_spec.rb:76  # one example
+bundle exec rubocop                        # lint (-a to autofix; .rubocop_todo.yml holds baselined offenses)
+bundle exec rake                           # spec + rubocop (what CI runs)
+
+bundle exec rake frontend:build            # npm install + vite build → frontend/dist
+cd frontend && npm test                    # vitest (frontend unit tests)
+
+bundle exec exe/lutaml-jsonschema spa|combine|validate SCHEMA_FILES...
+```
+
+`frontend/dist/` and `Gemfile.lock` are gitignored. `frontend/dist/` must exist (run `rake frontend:build`) for the `spa` command and for packaging — the gemspec ships it via `Dir.glob("frontend/dist/*")`.
+
+## Architecture
+
+Data flow: schema files → `SchemaSet.load_from_files` → `Spa::SpaBuilder` → `Spa::SpaDocument` → `to_json` → `Spa::VueInlinedStrategy` (embeds `window.SCHEMA_DATA` + inlined JS/CSS into `index.html`).
+
+- **`Base`** — everything inherits from `Lutaml::Model::Serializable`. `Base` also forward-declares `Schema` to break the circular `Schema ↔ PropertyEntry ↔ Link` references.
+- **`Schema`** — the central model of a JSON Schema document. Every `$`-prefixed keyword is a `dollar_`-prefixed attribute (`$schema` → `dollar_schema`) via json mappings. `Schema.from_json` / `to_json` are lutaml-model serialization.
+- **`SchemaSet`** — in-memory named collection of schemas plus `$ref` resolution (local `#/...` pointers and relative `./file.json` refs through `ReferenceResolver`) and validation.
+- **`SchemaStore`** — `SchemaSet` subclass that adds on-disk persistence through **lutaml-store** (`PackageStore`, package shape from `LjrPackageDefinition`).
+- **`Combiner`** — merges a `SchemaSet` into one document: hoists all definitions, adds a top-level `$ref` property per source schema, rewrites `#/definitions/` → `#/$defs/`.
+- **`Spa::*`** — `SpaBuilder` flattens a `SchemaSet` into a `SpaDocument` (metadata, `SpaSchema` list, flat `search_index` for FlexSearch). `Spa::Generator` renders through an `OutputStrategy`; `VueInlinedStrategy` is the only implementation.
+- **`Configuration`** — YAML config for the SPA (title, theme, appearance…), loaded by `Cli#spa -c`.
+- **`Cli`** — Thor commands: `spa` (generate docs), `combine` (merge schemas), `validate` (parse + shallow structural checks).
+
+## JSON engine: yeptris
+
+Two distinct paths, both engine-backed:
+
+- **Direct parsing** in this gem (`Cli#combine`, `Cli#validate`, `Schema.serialize_additional_properties`) uses `Yeptris::JSON.load` — strict RFC 8259, exact-`JSON.parse` semantics, raises `Yeptris::JSON::ParseError`. JSON **generation** stays on the stdlib `json` gem (`JSON.pretty_generate`); yeptris's JSON surface is load-only.
+- **Model serialization** (`Schema.from_json`/`to_json`, `Configuration.from_yaml`, lutaml-store I/O) goes through lutaml-model, whose `AdapterResolver` auto-detects yeptris from the bundle and routes both `:json` and `:yaml` to its `YeptrisAdapter`. That adapter re-raises parse failures as `JSON::ParserError`, so error handling must cover **both** exception types — see the rescue in `Cli#validate`.
+- Raw-parse speed depends on the resolved yeptris build shipping a **native materializer for the running Ruby version**; without one it falls back to a pure-Ruby tape engine that is several times slower than `JSON.parse` on large documents (yeptris-ruby#278). Check with `defined?(Yeptris::Native)` (0.6.28.x shipped only Ruby 3.3; 3.4-native starts at 0.6.29.1).
+- The GC-pressure SIGSEGV in the native JSON materializer (yeptris-ruby#279) is fixed in the yeptris **0.6.34 line** (staged pairs made GC-visible); the gemspec floors at `~> 0.6.34`, excluding the crashy 0.6.29.x–0.6.33.x native builds. Env-gated canary: yeptris-ruby#280.
+
+## Repo notes
+
+- `README.md` is unreplaced gem-template boilerplate — don't treat it as documentation.
+- `TODO.redoc/`, `TODO.refactor/`, `TODO.store/` are untracked, numbered working notes (known gaps and planned refactors), not code. `TODO.sota/` holds the SOTA program (purpose, per-area tasks with done-when criteria, and the goal prompt).
+- CI is metanorma/ci's `generic-rake` workflow; releases run through `.github/workflows/release.yml`.

data/lib/lutaml/jsonschema/cli.rb

@@ -2,6 +2,7 @@
 
 require "thor"
 require "json"
+require "yeptris"
 
 module Lutaml
   module Jsonschema
@@ -44,7 +45,7 @@ module Lutaml
 
         schema_set = SchemaSet.load_from_files(*schema_files)
         combined = Combiner.new.combine(schema_set)
-        json = JSON.pretty_generate(JSON.parse(combined.to_json))
+        json = JSON.pretty_generate(Yeptris::JSON.load(combined.to_json))
 
         if options[:output] == "-"
           $stdout.write(json)
@@ -59,7 +60,7 @@ module Lutaml
       desc "validate SCHEMA_FILE", "Validate a JSON Schema file"
       def validate(schema_file)
         data = File.read(schema_file)
-        json = JSON.parse(data)
+        json = Yeptris::JSON.load(data)
         Schema.from_json(data)
 
         errors = validate_structure(json)
@@ -69,7 +70,7 @@ module Lutaml
           errors.each { |e| warn "  #{e}" }
           abort "#{schema_file}: #{errors.length} validation error(s)"
         end
-      rescue JSON::ParserError => e
+      rescue Yeptris::JSON::ParseError, JSON::ParserError => e
         abort "Invalid JSON: #{e.message}"
       rescue Errno::ENOENT => e
         abort "Error: #{e.message}"

data/lib/lutaml/jsonschema/schema.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require "yeptris"
+
 module Lutaml
   module Jsonschema
     class Schema < Base
@@ -158,7 +160,7 @@ module Lutaml
       def serialize_additional_properties(instance, hash)
         if instance.additional_properties_schema
           hash["additionalProperties"] =
-            JSON.parse(instance.additional_properties_schema.to_json)
+            Yeptris::JSON.load(instance.additional_properties_schema.to_json)
         elsif !instance.additional_properties.nil?
           hash["additionalProperties"] = instance.additional_properties
         end

data/lib/lutaml/jsonschema/version.rb

@@ -2,6 +2,6 @@
 
 module Lutaml
   module Jsonschema
-    VERSION = "0.1.21"
+    VERSION = "0.1.23"
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lutaml-jsonschema
 version: !ruby/object:Gem::Version
-  version: 0.1.21
+  version: 0.1.23
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-10-02 00:00:00.000000000 Z
+date: 2026-10-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: json
@@ -30,14 +30,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.8.0
+        version: 0.8.114
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.8.0
+        version: 0.8.114
 - !ruby/object:Gem::Dependency
   name: lutaml-store
   requirement: !ruby/object:Gem::Requirement
@@ -66,6 +66,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: yeptris
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.6.34
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.6.34
 description: Parse JSON Schema files into LutaML model objects and generate SPA documentation
   sites
 email:
@@ -77,6 +91,7 @@ extra_rdoc_files: []
 files:
 - ".rubocop_todo.yml"
 - CHANGELOG.md
+- CLAUDE.md
 - CODE_OF_CONDUCT.md
 - README.md
 - Rakefile