ucode 0.2.0 → 0.2.2

data/lib/ucode/parsers/blocks.rb

@@ -37,6 +37,40 @@ module Ucode
           nil
         end
 
+        # Resolves a block by its identifier (the underscored form of
+        # the block name, e.g. "Basic_Latin", "Egyptian_Hieroglyphs_Extended-B").
+        # Streams `Blocks.txt` once and short-circuits on first match —
+        # callers don't need to walk the whole ~340-block file.
+        #
+        # @param path [Pathname, String] path to a Blocks.txt
+        # @param id [String] block identifier (matches `Models::Block#id`)
+        # @return [Models::Block, nil] the block, or nil when no block
+        #   has the given id
+        def find_by_id(path, id)
+          return nil if id.nil? || id.empty?
+
+          each_record(path) do |block|
+            return block if block.id == id
+          end
+          nil
+        end
+
+        # Same as {find_by_id} but raises {Ucode::UnknownBlockError} on
+        # miss. Use this in callers that can't recover from a missing
+        # block (CLI commands, extractors that need a block to proceed).
+        #
+        # @param path [Pathname, String] path to a Blocks.txt
+        # @param id [String] block identifier
+        # @return [Models::Block]
+        # @raise [Ucode::UnknownBlockError] when no block matches
+        def find_by_id!(path, id)
+          find_by_id(path, id) or
+            raise Ucode::UnknownBlockError.new(
+              "unknown Unicode block: #{id.inspect}",
+              context: { block_id: id, blocks_txt: path.to_s },
+            )
+        end
+
         private
 
         def build_block(range, name)

data/lib/ucode/repo/aggregate_writer.rb

@@ -155,4 +155,4 @@ module Ucode
       end
     end
   end
-end
+end

data/lib/ucode/repo/writers/blocks_writer.rb

@@ -45,12 +45,12 @@ module Ucode
           path = Paths.blocks_index_path(@output_root)
           summary = @blocks.map do |block|
             {
-              "id"           => block.id,
-              "name"         => block.name,
-              "first_cp"     => block.range_first,
-              "last_cp"      => block.range_last,
+              "id" => block.id,
+              "name" => block.name,
+              "first_cp" => block.range_first,
+              "last_cp" => block.range_last,
               "plane_number" => block.plane_number,
-              "age"          => @block_ages[block.id],
+              "age" => @block_ages[block.id],
             }
           end
           write_atomic(path, to_pretty_json(summary)) ? 1 : 0
@@ -58,16 +58,16 @@ module Ucode
 
         def block_payload(block)
           to_pretty_json(
-            "id"             => block.id,
-            "name"           => block.name,
-            "range_first"    => block.range_first,
-            "range_last"     => block.range_last,
-            "plane_number"   => block.plane_number,
-            "age"            => @block_ages[block.id],
-            "codepoint_ids"  => (@block_codepoint_ids[block.id] || []),
+            "id" => block.id,
+            "name" => block.name,
+            "range_first" => block.range_first,
+            "range_last" => block.range_last,
+            "plane_number" => block.plane_number,
+            "age" => @block_ages[block.id],
+            "codepoint_ids" => @block_codepoint_ids[block.id] || [],
           )
         end
       end
     end
   end
-end
+end

data/lib/ucode/repo/writers/enums_writer.rb

@@ -27,7 +27,7 @@ module Ucode
         def write
           path = Pathname(@output_root).join("enums.json")
           payload = {
-            "properties"      => @property_aliases.map(&:to_yaml_hash),
+            "properties" => @property_aliases.map(&:to_yaml_hash),
             "property_values" => @property_value_aliases.map(&:to_yaml_hash),
           }
           write_atomic(path, to_pretty_json(payload)) ? 1 : 0
@@ -35,4 +35,4 @@ module Ucode
       end
     end
   end
-end
+end

data/lib/ucode/repo/writers/indexes_writer.rb

@@ -34,11 +34,11 @@ module Ucode
         def write
           count = 0
           count += 1 if write_atomic(Paths.names_index_path(@output_root),
-                                      to_pretty_json(@names))
+                                     to_pretty_json(@names))
           count += 1 if write_atomic(Paths.labels_index_path(@output_root),
-                                      to_pretty_json(@labels))
+                                     to_pretty_json(@labels))
           count += 1 if write_atomic(codepoint_to_block_path,
-                                      to_pretty_json(@cp_to_block))
+                                     to_pretty_json(@cp_to_block))
           count
         end
 
@@ -50,4 +50,4 @@ module Ucode
       end
     end
   end
-end
+end

data/lib/ucode/repo/writers/manifest_writer.rb

@@ -45,10 +45,10 @@ module Ucode
         def write
           path = Paths.manifest_path(@output_root)
           content = {
-            "ucd_version"     => @ucd_version,
+            "ucd_version" => @ucd_version,
             "codepoint_count" => @codepoint_count,
-            "glyph_count"     => @glyph_count,
-            "schema_version"  => SCHEMA_VERSION,
+            "glyph_count" => @glyph_count,
+            "schema_version" => SCHEMA_VERSION,
           }
           ts = preserved_or_new_timestamp(path, content)
           payload = content.merge("generated_at" => ts)
@@ -75,4 +75,4 @@ module Ucode
       end
     end
   end
-end
+end

data/lib/ucode/repo/writers/named_sequences_writer.rb

@@ -44,4 +44,4 @@ module Ucode
       end
     end
   end
-end
+end

data/lib/ucode/repo/writers/planes_writer.rb

@@ -16,16 +16,16 @@ module Ucode
         # Static metadata for the 17 Unicode planes. Planes 4–13 are
         # unassigned in Unicode 17; their entries use placeholder names.
         PLANE_TABLE = {
-          0  => ["Basic Multilingual Plane",            "BMP"],
-          1  => ["Supplementary Multilingual Plane",    "SMP"],
-          2  => ["Supplementary Ideographic Plane",     "SIP"],
-          3  => ["Tertiary Ideographic Plane",          "TIP"],
-          4  => ["Unassigned Plane 4",                  "—"],
-          5  => ["Unassigned Plane 5",                  "—"],
-          6  => ["Unassigned Plane 6",                  "—"],
-          7  => ["Unassigned Plane 7",                  "—"],
-          8  => ["Unassigned Plane 8",                  "—"],
-          9  => ["Unassigned Plane 9",                  "—"],
+          0 => ["Basic Multilingual Plane",            "BMP"],
+          1 => ["Supplementary Multilingual Plane",    "SMP"],
+          2 => ["Supplementary Ideographic Plane",     "SIP"],
+          3 => ["Tertiary Ideographic Plane",          "TIP"],
+          4 => ["Unassigned Plane 4",                  "—"],
+          5 => ["Unassigned Plane 5",                  "—"],
+          6 => ["Unassigned Plane 6",                  "—"],
+          7 => ["Unassigned Plane 7",                  "—"],
+          8 => ["Unassigned Plane 8",                  "—"],
+          9 => ["Unassigned Plane 9",                  "—"],
           10 => ["Unassigned Plane 10",                 "—"],
           11 => ["Unassigned Plane 11",                 "—"],
           12 => ["Unassigned Plane 12",                 "—"],
@@ -68,15 +68,15 @@ module Ucode
           range_first = plane_number * 0x10000
           range_last  = range_first + 0xFFFF
           to_pretty_json(
-            "number"       => plane_number,
-            "name"         => name,
-            "abbrev"       => abbrev,
-            "range_first"  => range_first,
-            "range_last"   => range_last,
-            "block_ids"    => block_ids,
+            "number" => plane_number,
+            "name" => name,
+            "abbrev" => abbrev,
+            "range_first" => range_first,
+            "range_last" => range_last,
+            "block_ids" => block_ids,
           )
         end
       end
     end
   end
-end
+end

data/lib/ucode/repo/writers/relationships_writer.rb

@@ -68,4 +68,4 @@ module Ucode
       end
     end
   end
-end
+end

data/lib/ucode/repo/writers/scripts_writer.rb

@@ -41,14 +41,14 @@ module Ucode
 
         def script_payload(code, ranges)
           to_pretty_json(
-            "code"           => code,
-            "name"           => ranges.first&.name,
-            "range_first"    => ranges.map(&:range_first).min,
-            "range_last"     => ranges.map(&:range_last).max,
-            "codepoint_ids"  => (@script_codepoint_ids[code] || []),
+            "code" => code,
+            "name" => ranges.first&.name,
+            "range_first" => ranges.map(&:range_first).min,
+            "range_last" => ranges.map(&:range_last).max,
+            "codepoint_ids" => @script_codepoint_ids[code] || [],
           )
         end
       end
     end
   end
-end
+end

data/lib/ucode/repo/writers.rb

@@ -17,4 +17,4 @@ module Ucode
       autoload :ManifestWriter,        "ucode/repo/writers/manifest_writer"
     end
   end
-end
+end

data/lib/ucode/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Ucode
-  VERSION = "0.2.0"
+  VERSION = "0.2.2"
 end

data/lib/ucode.rb

@@ -30,11 +30,13 @@ module Ucode
   autoload :DatabaseMissingError, "ucode/error"
   autoload :DatabaseSchemaError, "ucode/error"
   autoload :UnknownVersionError, "ucode/error"
+  autoload :UnknownBlockError, "ucode/error"
   autoload :GlyphError, "ucode/error"
   autoload :PdfRenderError, "ucode/error"
   autoload :GridDetectionError, "ucode/error"
   autoload :LastResortMissingError, "ucode/error"
   autoload :EmbeddedFontsMissingError, "ucode/error"
+  autoload :CodeChartNotFoundError, "ucode/error"
 
   # Infrastructure
   autoload :Cache, "ucode/cache"
@@ -54,6 +56,7 @@ module Ucode
   autoload :Repo, "ucode/repo"
   autoload :Glyphs, "ucode/glyphs"
   autoload :Audit, "ucode/audit"
+  autoload :CodeChart, "ucode/code_chart"
   autoload :Site, "ucode/site"
   autoload :Commands, "ucode/commands"
   autoload :Cli, "ucode/cli"

data/ucode.gemspec

@@ -45,7 +45,12 @@ Gem::Specification.new do |spec|
   spec.require_paths = ["lib"]
 
   spec.add_dependency "base64"
-  spec.add_dependency "fontisan", "~> 0.2"
+  # Pin fontisan to 0.2.22 — 0.2.23+ removed
+  # `Fontisan::Commands::AuditCommand` (used by RealFonts::CoverageAuditor)
+  # and 0.4.x removed the entire Audit subsystem. Until
+  # CoverageAuditor is rewritten against the new fontisan API, this
+  # pin keeps the existing audit path working.
+  spec.add_dependency "fontisan", "= 0.2.22"
   spec.add_dependency "fontist", "~> 3.0"
   spec.add_dependency "logger"
   spec.add_dependency "lutaml-model", "~> 0.8"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ucode
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.2
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-06-29 00:00:00.000000000 Z
+date: 2026-07-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64
@@ -28,16 +28,16 @@ dependencies:
   name: fontisan
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - '='
       - !ruby/object:Gem::Version
-        version: '0.2'
+        version: 0.2.22
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - '='
       - !ruby/object:Gem::Version
-        version: '0.2'
+        version: 0.2.22
 - !ruby/object:Gem::Dependency
   name: fontist
   requirement: !ruby/object:Gem::Requirement
@@ -156,6 +156,14 @@ files:
 - Gemfile
 - README.md
 - Rakefile
+- TODO.extract-code-chart/01-pdf-fetch-validation.md
+- TODO.extract-code-chart/02-block-name-resolver.md
+- TODO.extract-code-chart/03-codechart-namespace.md
+- TODO.extract-code-chart/04-codechart-extractor.md
+- TODO.extract-code-chart/05-provenance-and-sidecar.md
+- TODO.extract-code-chart/06-codechart-writer.md
+- TODO.extract-code-chart/07-codechart-cli.md
+- TODO.extract-code-chart/08-specs.md
 - TODO.full/00-README.md
 - TODO.full/01-panglyph-vision.md
 - TODO.full/02-panglyph-repo-bootstrap.md
@@ -295,6 +303,11 @@ files:
 - lib/ucode/audit/universal_set_reference.rb
 - lib/ucode/cache.rb
 - lib/ucode/cli.rb
+- lib/ucode/code_chart.rb
+- lib/ucode/code_chart/extractor.rb
+- lib/ucode/code_chart/provenance.rb
+- lib/ucode/code_chart/sidecar.rb
+- lib/ucode/code_chart/writer.rb
 - lib/ucode/commands.rb
 - lib/ucode/commands/audit.rb
 - lib/ucode/commands/audit/browser_command.rb