RubyGems - ucode - Versions diffs - 0.1.0 → 0.1.1 - Mend

ucode 0.1.0 → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (174) hide show

checksums.yaml +4 -4
data/CHANGELOG.md +72 -0
data/Gemfile.lock +2 -2
data/TODO.full/00-README.md +116 -0
data/TODO.full/01-panglyph-vision.md +112 -0
data/TODO.full/02-panglyph-repo-bootstrap.md +184 -0
data/TODO.full/03-panglyph-font-builder.md +201 -0
data/TODO.full/04-panglyph-publish-pipeline.md +126 -0
data/TODO.full/05-ucode-0-1-1-release.md +139 -0
data/TODO.full/06-fontisan-remove-audit.md +142 -0
data/TODO.full/07-fontisan-remove-ucd.md +125 -0
data/TODO.full/08-archive-private-bin-build.md +143 -0
data/TODO.full/09-archive-public-structure.md +164 -0
data/TODO.full/10-fontist-org-woff-glyphs.md +131 -0
data/TODO.full/11-fontist-org-audit-coverage.md +140 -0
data/TODO.full/12-implementation-order.md +216 -0
data/TODO.full/13-fontisan-font-writer-api.md +189 -0
data/TODO.full/14-fontisan-table-writers.md +66 -0
data/TODO.full/15-panglyph-builder-real.md +82 -0
data/TODO.full/16-archive-public-sync-workflows.md +167 -0
data/TODO.full/17-fontist-org-font-picker.md +73 -0
data/TODO.full/18-comprehensive-spec-coverage.md +64 -0
data/TODO.full/19-ucode-0-1-2-patch.md +32 -0
data/TODO.full/20-fontisan-0-2-23-release.md +52 -0
data/TODO.new/00-README.md +30 -0
data/TODO.new/23-universal-glyph-set-source-map.md +312 -0
data/TODO.new/24-universal-glyph-set-build.md +189 -0
data/TODO.new/25-font-audit-against-universal-set.md +195 -0
data/TODO.new/26-missing-glyph-reporter.md +189 -0
data/TODO.new/27-fontist-org-consumer-integration.md +200 -0
data/TODO.new/28-implementation-order-update.md +187 -0
data/TODO.new/29-universal-set-curation-uc17.md +312 -0
data/TODO.new/30-tier1-font-acquisition.md +241 -0
data/TODO.new/31-universal-set-production-build.md +205 -0
data/TODO.new/32-uc17-coverage-matrix.md +165 -0
data/TODO.new/33-specialist-font-acquisition-refresh.md +138 -0
data/TODO.new/34-pillar2-content-stream-correlator.md +147 -0
data/TODO.new/35-universal-set-production-run.md +160 -0
data/TODO.new/36-per-font-coverage-audit.md +145 -0
data/TODO.new/37-coverage-highlight-reporter.md +125 -0
data/TODO.new/38-fontist-org-glyph-consumer.md +141 -0
data/TODO.new/39-implementation-order-update-32-38.md +258 -0
data/TODO.new/40-archive-private-uses-ucode-audit.md +124 -0
data/TODO.new/41-ucode-unicode-archive-bridge.md +160 -0
data/config/specialist_fonts.yml +102 -0
data/config/unicode17_tier1_fonts.yml +42 -0
data/config/unicode17_universal_glyph_set.yml +293 -0
data/lib/ucode/audit/block_aggregator.rb +57 -29
data/lib/ucode/audit/browser/face_page.rb +128 -0
data/lib/ucode/audit/browser/glyph_panel.rb +124 -0
data/lib/ucode/audit/browser/library_page.rb +74 -0
data/lib/ucode/audit/browser/missing_glyph_page.rb +87 -0
data/lib/ucode/audit/browser/template.rb +47 -0
data/lib/ucode/audit/browser/templates/face.css +200 -0
data/lib/ucode/audit/browser/templates/face.html.erb +41 -0
data/lib/ucode/audit/browser/templates/face.js +298 -0
data/lib/ucode/audit/browser/templates/library.css +119 -0
data/lib/ucode/audit/browser/templates/library.html.erb +42 -0
data/lib/ucode/audit/browser/templates/library.js +99 -0
data/lib/ucode/audit/browser/templates/missing_glyph_page.css +119 -0
data/lib/ucode/audit/browser/templates/missing_glyph_page.html.erb +58 -0
data/lib/ucode/audit/browser/templates/missing_glyph_page.js +2 -0
data/lib/ucode/audit/browser.rb +32 -0
data/lib/ucode/audit/context.rb +27 -1
data/lib/ucode/audit/coverage_reference.rb +103 -0
data/lib/ucode/audit/differ.rb +121 -0
data/lib/ucode/audit/emitter/block_emitter.rb +52 -0
data/lib/ucode/audit/emitter/codepoint_emitter.rb +87 -0
data/lib/ucode/audit/emitter/collection_emitter.rb +80 -0
data/lib/ucode/audit/emitter/face_directory.rb +212 -0
data/lib/ucode/audit/emitter/glyph_emitter.rb +48 -0
data/lib/ucode/audit/emitter/index_emitter.rb +149 -0
data/lib/ucode/audit/emitter/library_emitter.rb +96 -0
data/lib/ucode/audit/emitter/paths.rb +312 -0
data/lib/ucode/audit/emitter/plane_emitter.rb +29 -0
data/lib/ucode/audit/emitter/script_emitter.rb +29 -0
data/lib/ucode/audit/emitter.rb +29 -0
data/lib/ucode/audit/extractors/aggregations.rb +31 -2
data/lib/ucode/audit/face_auditor.rb +86 -0
data/lib/ucode/audit/formatters/audit_diff_text.rb +112 -0
data/lib/ucode/audit/formatters/audit_text.rb +411 -0
data/lib/ucode/audit/formatters/color.rb +48 -0
data/lib/ucode/audit/formatters/library_summary_text.rb +98 -0
data/lib/ucode/audit/formatters/text_formatter.rb +83 -0
data/lib/ucode/audit/formatters.rb +23 -0
data/lib/ucode/audit/library_aggregator.rb +86 -0
data/lib/ucode/audit/library_auditor.rb +105 -0
data/lib/ucode/audit/release/emitter.rb +152 -0
data/lib/ucode/audit/release/face_card.rb +93 -0
data/lib/ucode/audit/release/formula_audits.rb +50 -0
data/lib/ucode/audit/release/library_index_builder.rb +78 -0
data/lib/ucode/audit/release/manifest_builder.rb +127 -0
data/lib/ucode/audit/release.rb +42 -0
data/lib/ucode/audit/ucd_only_reference.rb +81 -0
data/lib/ucode/audit/universal_set_reference.rb +136 -0
data/lib/ucode/audit.rb +31 -0
data/lib/ucode/cli.rb +339 -33
data/lib/ucode/commands/audit/browser_command.rb +82 -0
data/lib/ucode/commands/audit/collection_command.rb +103 -0
data/lib/ucode/commands/audit/compare_command.rb +188 -0
data/lib/ucode/commands/audit/font_command.rb +140 -0
data/lib/ucode/commands/audit/library_command.rb +87 -0
data/lib/ucode/commands/audit/reference_builder.rb +64 -0
data/lib/ucode/commands/audit.rb +20 -0
data/lib/ucode/commands/block_feed.rb +73 -0
data/lib/ucode/commands/canonical_build.rb +138 -0
data/lib/ucode/commands/fetch.rb +37 -1
data/lib/ucode/commands/release.rb +115 -0
data/lib/ucode/commands/universal_set.rb +211 -0
data/lib/ucode/commands.rb +5 -0
data/lib/ucode/coordinator/indices.rb +11 -0
data/lib/ucode/coordinator.rb +138 -5
data/lib/ucode/error.rb +30 -2
data/lib/ucode/fetch/font_fetcher/result.rb +39 -0
data/lib/ucode/fetch/font_fetcher.rb +16 -0
data/lib/ucode/fetch/specialist_font_fetcher.rb +280 -0
data/lib/ucode/fetch.rb +7 -3
data/lib/ucode/glyphs/real_fonts/cmap_cache.rb +74 -0
data/lib/ucode/glyphs/real_fonts.rb +1 -0
data/lib/ucode/glyphs/resolver.rb +62 -0
data/lib/ucode/glyphs/source.rb +48 -0
data/lib/ucode/glyphs/source_builder.rb +61 -0
data/lib/ucode/glyphs/source_config/coverage_assertion.rb +79 -0
data/lib/ucode/glyphs/source_config/gap_report.rb +54 -0
data/lib/ucode/glyphs/source_config.rb +104 -0
data/lib/ucode/glyphs/sources/pillar1_embedded_tounicode.rb +63 -0
data/lib/ucode/glyphs/sources/pillar3_last_resort.rb +51 -0
data/lib/ucode/glyphs/sources/tier1_real_font.rb +104 -0
data/lib/ucode/glyphs/sources.rb +20 -0
data/lib/ucode/glyphs/universal_set/builder.rb +161 -0
data/lib/ucode/glyphs/universal_set/coverage_report.rb +139 -0
data/lib/ucode/glyphs/universal_set/idempotency.rb +86 -0
data/lib/ucode/glyphs/universal_set/manifest_accumulator.rb +195 -0
data/lib/ucode/glyphs/universal_set/manifest_writer.rb +61 -0
data/lib/ucode/glyphs/universal_set/pre_build_check.rb +197 -0
data/lib/ucode/glyphs/universal_set/validator.rb +204 -0
data/lib/ucode/glyphs/universal_set.rb +45 -0
data/lib/ucode/glyphs.rb +6 -0
data/lib/ucode/models/audit/baseline.rb +6 -0
data/lib/ucode/models/audit/block_summary.rb +7 -0
data/lib/ucode/models/audit/codepoint_provenance.rb +39 -0
data/lib/ucode/models/audit/release_face.rb +42 -0
data/lib/ucode/models/audit/release_formula.rb +33 -0
data/lib/ucode/models/audit/release_manifest.rb +43 -0
data/lib/ucode/models/audit/release_universal_set.rb +37 -0
data/lib/ucode/models/audit.rb +9 -0
data/lib/ucode/models/block.rb +2 -0
data/lib/ucode/models/build_report.rb +109 -0
data/lib/ucode/models/codepoint/glyph.rb +42 -0
data/lib/ucode/models/codepoint.rb +3 -0
data/lib/ucode/models/glyph_source.rb +86 -0
data/lib/ucode/models/glyph_source_map.rb +138 -0
data/lib/ucode/models/specialist_font.rb +70 -0
data/lib/ucode/models/specialist_font_manifest.rb +48 -0
data/lib/ucode/models/unihan_entry.rb +81 -9
data/lib/ucode/models/unihan_field.rb +21 -0
data/lib/ucode/models/universal_set_entry.rb +47 -0
data/lib/ucode/models/universal_set_manifest.rb +78 -0
data/lib/ucode/models/validation_report.rb +99 -0
data/lib/ucode/models.rb +9 -0
data/lib/ucode/parsers/named_sequences.rb +5 -5
data/lib/ucode/parsers/unihan.rb +50 -19
data/lib/ucode/repo/aggregate_writer.rb +34 -2
data/lib/ucode/repo/block_feed_emitter.rb +153 -0
data/lib/ucode/repo/build_report_accumulator.rb +138 -0
data/lib/ucode/repo/build_report_writer.rb +46 -0
data/lib/ucode/repo/build_validator.rb +229 -0
data/lib/ucode/repo/codepoint_writer.rb +50 -1
data/lib/ucode/repo/paths.rb +8 -0
data/lib/ucode/repo.rb +4 -0
data/lib/ucode/version.rb +1 -1
data/schema/block-feed.output.schema.yml +134 -0
metadata +143 -2
data/ucode.gemspec +0 -56

data/lib/ucode/audit/browser/templates/missing_glyph_page.html.erb ADDED Viewed

@@ -0,0 +1,58 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title><%= block_name %> — missing glyphs — ucode audit</title>
+  <style>
+<%= _css %>
+  </style>
+</head>
+<body data-universal-set-available="<%= universal_set_available %>">
+  <header class="page-header">
+    <h1><%= block_name %></h1>
+    <p class="tagline">
+      <%= total_count %> missing codepoint<%= total_count == 1 ? "" : "s" %>
+      <% if overflow_count.positive? %>
+        — showing first <%= visible_count %>
+      <% end %>
+      <% unless universal_set_available %>
+        — universal-set glyphs unavailable
+      <% end %>
+    </p>
+  </header>
+  <main>
+    <% if panels.empty? %>
+      <p class="hint">No missing codepoints in this block.</p>
+    <% else %>
+      <ul class="glyph-grid">
+        <% panels.each do |panel| %>
+          <li class="glyph-cell" data-codepoint="<%= panel["codepoint"] %>">
+            <div class="glyph-thumb">
+              <% if panel["svg"] %>
+                <%= panel["svg"] %>
+              <% else %>
+                <span class="glyph-na">n/a</span>
+              <% end %>
+            </div>
+            <div class="glyph-meta">
+              <span class="cp-id"><%= panel["id"] %></span>
+              <% if panel["source"] %>
+                <span class="source"><%= panel["source"] %></span>
+              <% end %>
+            </div>
+          </li>
+        <% end %>
+      </ul>
+      <% if overflow_count.positive? %>
+        <p class="overflow">+<%= overflow_count %> more codepoints not shown — see the face browser for the full list.</p>
+      <% end %>
+    <% end %>
+  </main>
+  <script>
+<%= _js %>
+  </script>
+</body>
+</html>

data/lib/ucode/audit/browser/templates/missing_glyph_page.js ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ // ucode audit missing-glyph gallery — static page, no interactivity required.
2	+ // SVGs are inlined into the HTML at render time so the page works under file://.

data/lib/ucode/audit/browser.rb ADDED Viewed

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+require "pathname"
+module Ucode
+  module Audit
+    # Standalone HTML browsers for Mode 2 audit output.
+    #
+    # Two pages:
+    #
+    #   - {Browser::FacePage}   — one face's audit, fully self-contained
+    #     (no external CSS/JS), with JSON inlined for instant render via
+    #     `file://`. Block expansion and codepoint detail lazy-fetch
+    #     the chunks emitted by {Emitter::FaceDirectory}.
+    #   - {Browser::LibraryPage} — one library's index, also self-contained,
+    #     with cards linking into each face page.
+    #
+    # Both pages reuse the chunk files emitted by {Emitter} — they don't
+    # duplicate the JSON, they just inline the overview slice that the
+    # initial render needs.
+    module Browser
+      TEMPLATE_DIR = Pathname.new(__dir__).join("browser/templates")
+      private_constant :TEMPLATE_DIR
+      autoload :Template,         "ucode/audit/browser/template"
+      autoload :FacePage,         "ucode/audit/browser/face_page"
+      autoload :LibraryPage,      "ucode/audit/browser/library_page"
+      autoload :GlyphPanel,       "ucode/audit/browser/glyph_panel"
+      autoload :MissingGlyphPage, "ucode/audit/browser/missing_glyph_page"
+    end
+  end
+end

data/lib/ucode/audit/context.rb CHANGED Viewed

@@ -39,14 +39,21 @@ module Ucode
       # @param options [Hash{Symbol=>Object}] audit options (ucd_version,
       #   all_codepoints, with_glyphs, etc.).
       # @param renderer [Object, nil] glyph renderer for --with-glyphs mode.
+      # @param reference [CoverageReference, nil] the baseline the
+      #   audit compares the font's cmap against. When nil, defaults
+      #   to a {UcdOnlyReference} built from the resolved baseline
+      #   database (TODO 25). Passing a {UniversalSetReference}
+      #   attaches per-codepoint provenance to every missing-codepoint
+      #   row.
       def initialize(font:, font_path:, font_index:, num_fonts_in_source:,
-                     options:, renderer: nil)
+                     options:, renderer: nil, reference: nil)
         @font = font
         @font_path = font_path
         @font_index = font_index
         @num_fonts_in_source = num_fonts_in_source
         @options = options
         @renderer = renderer
+        @reference_override = reference
       end
       # Codepoints the font's cmap actually maps. Memoized.
@@ -63,6 +70,18 @@ module Ucode
         @baseline ||= resolve_baseline
       end
+      # The {CoverageReference} the audit compares against. Defaults
+      # to a {UcdOnlyReference} built from the resolved baseline
+      # database. When the caller supplied a reference at construction
+      # (typically a {UniversalSetReference}), that one is used
+      # verbatim. Memoized.
+      #
+      # @return [CoverageReference, nil] nil when the baseline itself
+      #   couldn't be resolved (database missing).
+      def reference
+        @reference ||= @reference_override || build_default_reference
+      end
       # Detected source format string ("ttf", "otf", "ttc", ...). Memoized.
       # @return [String, nil]
       def source_format
@@ -132,6 +151,13 @@ module Ucode
           generated_at: Time.now.utc.iso8601,
         )
       end
+      def build_default_reference
+        database = baseline.database
+        return nil if database.nil?
+        UcdOnlyReference.new(database: database)
+      end
     end
   end
 end

data/lib/ucode/audit/coverage_reference.rb ADDED Viewed

@@ -0,0 +1,103 @@
+# frozen_string_literal: true
+module Ucode
+  module Audit
+    # Common interface for any "what is the assigned codepoint set"
+    # reference used by the audit pipeline.
+    #
+    # Two implementations:
+    #
+    # - {UcdOnlyReference} — derives the assigned set from the UCD
+    #   database alone (block ranges). Carries no per-codepoint
+    #   provenance. This is the legacy behaviour: a font audit
+    #   compares against the abstract Unicode assigned-codepoint list.
+    #
+    # - {UniversalSetReference} — derives the assigned set from a
+    #   universal-set manifest (TODO 24). Every codepoint carries
+    #   tier + source provenance, so a missing-codepoint report can
+    #   answer "what does the missing glyph look like, and where did
+    #   the universal set get it from?".
+    #
+    # The audit pipeline (Context → Aggregations extractor →
+    # BlockAggregator) talks exclusively to this interface. Adding a
+    # new reference kind = one new subclass; no caller changes
+    # (open/closed).
+    class CoverageReference
+      # Immutable per-codepoint row exposed by every reference. The
+      # `tier` and `source` fields are nil for references that don't
+      # carry provenance (e.g. {UcdOnlyReference}).
+      Entry = Struct.new(:codepoint, :id, :tier, :source, keyword_init: true) do
+        # True when this entry carries provenance from a universal-set
+        # manifest. False for UCD-only references.
+        def provenance?
+          !tier.nil? || !source.nil?
+        end
+      end
+      def initialize; end
+      # Symbol identifying the reference kind. Used by the audit
+      # report's `baseline.reference_kind` field so consumers know
+      # which reference produced the per-block counts.
+      #
+      # @return [Symbol] e.g. :ucd, :universal_set
+      def kind
+        raise NotImplementedError
+      end
+      # @param codepoint [Integer]
+      # @return [Boolean] true if the codepoint is in the reference set
+      def include?(codepoint)
+        raise NotImplementedError
+      end
+      # Block name (verbatim Unicode identifier, e.g. "Basic_Latin")
+      # the codepoint falls under, or nil if it isn't in any known
+      # block. Used by {BlockAggregator} to group a font's cmap by
+      # block without needing direct access to the underlying
+      # {Ucode::Database}.
+      #
+      # @param codepoint [Integer]
+      # @return [String, nil]
+      def block_name_for(codepoint)
+        raise NotImplementedError
+      end
+      # Every assigned codepoint in the block, with tier + source
+      # attached when the reference carries provenance.
+      #
+      # @param block_id [String] verbatim Unicode block name
+      #   (e.g. "Basic_Latin", "Greek_and_Coptic")
+      # @return [Array<Entry>] sorted by codepoint; empty for unknown
+      #   block names or blocks with no assigned codepoints
+      def entries_for_block(block_id)
+        raise NotImplementedError
+      end
+      # Stable identifier for the reference, embedded in audit reports
+      # so consumers can detect drift. Examples:
+      #
+      #   "ucd:17.0.0"
+      #   "universal-set:17.0.0:abc12345"
+      #
+      # @return [String]
+      def reference_id
+        raise NotImplementedError
+      end
+      # Provenance rows for a list of codepoints, or nil when the
+      # reference carries no provenance (UCD-only). Returning nil
+      # (rather than an empty array) is the signal that the audit
+      # report should omit the `missing_codepoint_provenance` field
+      # entirely — preserving the legacy wire shape for UCD-only
+      # audits.
+      #
+      # @param codepoints [Enumerable<Integer>]
+      # @return [Array<Hash{Symbol=>Object}>, nil] one hash per
+      #   codepoint with `:codepoint`, `:tier`, `:source` keys; or nil
+      def provenance_for(codepoints)
+        raise NotImplementedError
+      end
+    end
+  end
+end

data/lib/ucode/audit/differ.rb ADDED Viewed

@@ -0,0 +1,121 @@
+# frozen_string_literal: true
+module Ucode
+  module Audit
+    # Computes a {Models::Audit::AuditDiff} between two AuditReports.
+    #
+    # Pure: no I/O, no font parsing. Both reports must already be built
+    # — the CLI's compare command loads them from disk or audits fresh
+    # fonts before invoking the differ.
+    #
+    # Comparison shape:
+    #   - Scalar fields: one {Models::Audit::FieldChange} per differing
+    #     field.
+    #   - Codepoint coverage: {Models::Audit::CodepointSetDiff} built
+    #     from the cmap range lists (expanded to integer sets for set
+    #     arithmetic, then re-coalesced to ranges for output).
+    #   - Structural inventories (features, scripts, blocks): simple
+    #     array set-diffs. ucode drops the CLDR languages diff that
+    #     fontisan carries (CLDR is out of scope here).
+    class Differ
+      # Scalar AuditReport fields compared field-by-field. Excludes
+      # generated_at / source_sha256 / source_file (per-report identity),
+      # codepoints / codepoint_ranges (handled via CodepointSetDiff),
+      # and nested models (surfaced via structural add/remove lists).
+      COMPARED_FIELDS = %i[
+        family_name subfamily_name full_name postscript_name version
+        font_revision weight_class width_class italic bold panose
+        total_codepoints total_glyphs
+      ].freeze
+      # @param left_report [Models::Audit::AuditReport]
+      # @param right_report [Models::Audit::AuditReport]
+      def initialize(left_report, right_report)
+        @left = left_report
+        @right = right_report
+      end
+      # @return [Models::Audit::AuditDiff]
+      def diff
+        Models::Audit::AuditDiff.new(
+          left_source: @left.source_file,
+          right_source: @right.source_file,
+          field_changes: field_changes,
+          codepoints: codepoint_diff,
+          added_features: set_diff(features(@right), features(@left)),
+          removed_features: set_diff(features(@left), features(@right)),
+          added_scripts: set_diff(scripts(@right), scripts(@left)),
+          removed_scripts: set_diff(scripts(@left), scripts(@right)),
+          added_blocks: set_diff(blocks(@right), blocks(@left)),
+          removed_blocks: set_diff(blocks(@left), blocks(@right)),
+        )
+      end
+      private
+      def field_changes
+        COMPARED_FIELDS.filter_map do |field|
+          left_val = @left.public_send(field)
+          right_val = @right.public_send(field)
+          next if left_val == right_val
+          Models::Audit::FieldChange.new(
+            field: field.to_s,
+            left: serialize_value(left_val),
+            right: serialize_value(right_val),
+          )
+        end
+      end
+      def codepoint_diff
+        left_set = codepoints_from_ranges(@left)
+        right_set = codepoints_from_ranges(@right)
+        added = right_set - left_set
+        removed = left_set - right_set
+        unchanged = left_set & right_set
+        Models::Audit::CodepointSetDiff.new(
+          added: CodepointRangeCoalescer.call(added.to_a),
+          removed: CodepointRangeCoalescer.call(removed.to_a),
+          added_count: added.size,
+          removed_count: removed.size,
+          unchanged_count: unchanged.size,
+        )
+      end
+      # Expand a report's compact codepoint range list into a Set<Integer>.
+      def codepoints_from_ranges(report)
+        ranges = report.codepoint_ranges || []
+        ranges.each_with_object(Set.new) do |range, set|
+          (range.first_cp..range.last_cp).each { |cp| set << cp }
+        end
+      end
+      def features(report)
+        Array(report.opentype_layout&.features)
+      end
+      # ucode's report carries ScriptSummary[] (structured), not String[].
+      # Diff on the script_code key — it's the stable identifier.
+      def scripts(report)
+        Array(report.scripts).map(&:script_code)
+      end
+      def blocks(report)
+        Array(report.blocks).map(&:name)
+      end
+      def set_diff(minuend, subtrahend)
+        (Array(minuend) - Array(subtrahend)).sort
+      end
+      def serialize_value(value)
+        case value
+        when nil then ""
+        when String, Integer, Float, true, false then value.to_s
+        else value.to_yaml
+        end
+      end
+    end
+  end
+end

data/lib/ucode/audit/emitter/block_emitter.rb ADDED Viewed

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+require "pathname"
+require "ucode/repo/atomic_writes"
+require "ucode/audit/emitter/paths"
+module Ucode
+  module Audit
+    module Emitter
+      # Writes `<face_dir>/blocks/<NAME>.json` — one file per touched
+      # block.
+      #
+      # The filename uses the block name verbatim (no slugifying) per
+      # `03-directory-output-spec.md` §"Block filename encoding". The
+      # only character that needs escaping is `/`, which Unicode block
+      # names never contain today.
+      #
+      # Each file is a single BlockSummary serialized via lutaml-model.
+      # The browser fetches these lazily when the user expands a block
+      # in the coverage map.
+      class BlockEmitter
+        include Ucode::Repo::AtomicWrites
+        # @param face_dir [String, Pathname]
+        # @param block [Models::Audit::BlockSummary]
+        # @return [Boolean] true if written, false if skipped
+        def emit(face_dir, block)
+          path = Paths.block_under(face_dir, encode_name(block.name))
+          write_atomic(path, to_pretty_json(serialize_block(block)))
+        end
+        private
+        # Spec: per-block `missing_codepoints` is always embedded even
+        # when empty. lutaml-model omits empty arrays by default, so we
+        # restore the key post-serialization.
+        def serialize_block(block)
+          block.to_hash.tap do |hash|
+            hash["missing_codepoints"] = block.missing_codepoints
+          end
+        end
+        # Unicode block names are filesystem-safe as-is (no slashes).
+        # This is a defensive guard.
+        def encode_name(name)
+          name.to_s.tr("/", "_")
+        end
+      end
+    end
+  end
+end

data/lib/ucode/audit/emitter/codepoint_emitter.rb ADDED Viewed

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+require "pathname"
+require "ucode/repo/atomic_writes"
+require "ucode/audit/emitter/paths"
+require "ucode/models/audit/codepoint_detail"
+module Ucode
+  module Audit
+    module Emitter
+      # Writes `<face_dir>/codepoints/<NAME>.json` — the verbose
+      # per-block codepoint detail list, emitted only in `--verbose`
+      # mode.
+      #
+      # For each touched block, walks the font's covered codepoints in
+      # that block and emits a {Models::Audit::CodepointDetail} per row,
+      # enriched with UCD metadata (name, gc, script, age) via the
+      # supplied {Ucode::Database}.
+      #
+      # Per-block chunking keeps each file under ~1MB even for CJK
+      # Extension J (~4,300 codepoints × ~200 bytes/detail ≈ 850KB).
+      #
+      # Glyph SVG paths are written as relative URIs so the browser can
+      # fetch each glyph on click. The `with_glyph_paths` flag controls
+      # whether to populate the path field — when false, the field is
+      # omitted entirely.
+      class CodepointEmitter
+        include Ucode::Repo::AtomicWrites
+        # @param face_dir [String, Pathname]
+        # @param block [Models::Audit::BlockSummary]
+        # @param database [Ucode::Database, nil] baseline lookup; when
+        #   nil, UCD fields are omitted
+        # @param with_glyph_paths [Boolean] when true, each detail
+        #   includes a relative `glyph_svg_path` linking into `glyphs/`
+        # @return [Boolean] true if written, false if skipped
+        def emit(face_dir, block, database: nil, with_glyph_paths: false)
+          path = Paths.codepoints_under(face_dir, encode_name(block.name))
+          payload = to_pretty_json(build_chunk(block, database, with_glyph_paths))
+          write_atomic(path, payload)
+        end
+        private
+        def build_chunk(block, database, with_glyph_paths)
+          {
+            "block_name" => block.name,
+            "first_cp" => block.first_cp,
+            "last_cp" => block.last_cp,
+            "codepoints" => build_details(block, database, with_glyph_paths),
+          }
+        end
+        def build_details(block, database, with_glyph_paths)
+          block.covered_codepoints.map do |cp|
+            build_detail(cp, block, database, with_glyph_paths)
+          end
+        end
+        def build_detail(codepoint, block, database, with_glyph_paths)
+          detail = Models::Audit::CodepointDetail.new(
+            codepoint: codepoint,
+            block_name: block.name,
+          )
+          enrich_from_baseline(detail, codepoint, database)
+          detail.glyph_svg_path = glyph_relative_path(codepoint) if with_glyph_paths
+          detail.to_hash.compact
+        end
+        def enrich_from_baseline(detail, codepoint, database)
+          return unless database
+          detail.script = database.lookup_script(codepoint)
+        end
+        def glyph_relative_path(codepoint)
+          "glyphs/#{format('U+%04X', codepoint)}.svg"
+        end
+        def encode_name(name)
+          name.to_s.tr("/", "_")
+        end
+      end
+    end
+  end
+end

data/lib/ucode/audit/emitter/collection_emitter.rb ADDED Viewed

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+require "pathname"
+require "ucode/repo/atomic_writes"
+require "ucode/audit/emitter/paths"
+module Ucode
+  module Audit
+    module Emitter
+      # Writes the per-collection layout for TTC/OTC inputs.
+      #
+      # For a collection with N faces, produces:
+      #
+      #   output/font_audit/<source_label>/
+      #   ├── index.json                  # collection-level summary
+      #   ├── 00-<face_ps>/index.json
+      #   ├── 00-<face_ps>/blocks/…
+      #   ├── 01-<face_ps>/index.json
+      #   └── …
+      #
+      # Per-face chunks are delegated to {FaceDirectory} via the
+      # `emit_collection_face` hook; this class owns only the
+      # collection-level summary that points at each sibling face
+      # directory.
+      class CollectionEmitter
+        include Ucode::Repo::AtomicWrites
+        # @param output_root [String, Pathname]
+        # @param source_label [String] sanitized collection label
+        # @param reports [Array<Models::Audit::AuditReport>] one per face
+        # @param face_directory [FaceDirectory] per-face emitter
+        # @return [Array<String>] the per-face subdirectory names written
+        def emit(output_root, source_label, reports, face_directory:)
+          face_dirs = reports.each_with_index.map do |report, index|
+            face_directory.emit_collection_face(
+              source_label: source_label, face_index: index, report: report,
+            )
+          end
+          emit_collection_index(output_root, source_label, reports, face_dirs)
+          face_dirs
+        end
+        private
+        def emit_collection_index(output_root, source_label, reports, face_dirs)
+          return if reports.empty?
+          payload = build_collection_index(reports, face_dirs)
+          path = Paths.face_index_path(output_root, source_label)
+          write_atomic(path, to_pretty_json(payload))
+        end
+        def build_collection_index(reports, face_dirs)
+          {
+            "num_fonts_in_source" => reports.first&.num_fonts_in_source || reports.size,
+            "source_file" => reports.first&.source_file,
+            "source_sha256" => reports.first&.source_sha256,
+            "faces" => face_cards(reports, face_dirs),
+          }.compact
+        end
+        def face_cards(reports, face_dirs)
+          reports.each_with_index.map do |report, index|
+            {
+              "font_index" => index,
+              "postscript_name" => report.postscript_name,
+              "family_name" => report.family_name,
+              "weight_class" => report.weight_class,
+              "total_codepoints" => report.total_codepoints,
+              "total_glyphs" => report.total_glyphs,
+              "directory" => face_dirs[index],
+            }
+          end
+        end
+      end
+    end
+  end
+end