dcc 0.2.0 → 0.2.1

data/lib/dcc/plugin/base.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+module Dcc
+  module Plugin
+    # Included by a plugin class so it can declare what it adds to Dcc.
+    #
+    # @example
+    #   class MyPlugin
+    #     include Dcc::Plugin::Base
+    #     register_validator MyRule
+    #   end
+    module Base
+      # @param base [Class] the including class.
+      def self.included(base)
+        base.extend(ClassMethods)
+      end
+
+      # `Profile#call` does `rule_class.new.check_on(dcc)`, so a validator
+      # has to be a class. An instance responds to `#check_on` and so looks
+      # right, but would fail deep inside validation with a message naming
+      # neither the plugin nor the author's line.
+      #
+      # @param entry [Object] the candidate rule.
+      # @raise [ArgumentError] unless entry is a class defining #check_on.
+      # @return [Class] the entry.
+      def self.rule_class!(entry)
+        return entry if rule_class?(entry)
+
+        raise ::ArgumentError,
+              "expected a rule class responding to #check_on, " \
+              "got #{describe(entry)}"
+      end
+
+      # @param entry [Object]
+      # @return [Boolean]
+      def self.rule_class?(entry)
+        entry.is_a?(::Class) && entry.method_defined?(:check_on)
+      end
+      private_class_method :rule_class?
+
+      # @param entry [Object]
+      # @return [String]
+      def self.describe(entry)
+        return entry.inspect if entry.is_a?(::Class)
+
+        "an instance of #{entry.class}"
+      end
+      private_class_method :describe
+
+      # Declaration helpers available on the including class.
+      module ClassMethods
+        # Add a Schematron rule to the active validation profile.
+        #
+        # @param rule_class [Class] a rule class defining `#check_on(dcc)`.
+        # @raise [ArgumentError] unless rule_class is such a class.
+        # @return [Class] the rule class.
+        def register_validator(rule_class)
+          checked = ::Dcc::Plugin::Base.rule_class!(rule_class)
+          ::Dcc::Plugin.register(:validators, checked)
+        end
+      end
+    end
+  end
+end

data/lib/dcc/plugin/registry.rb

@@ -9,12 +9,17 @@ module Dcc
       @mutex = ::Mutex.new
 
       class << self
+        # Idempotent per (category, entry): registering the same entry in
+        # the same category twice is a no-op, so a doubly-loaded plugin does
+        # not run its validators twice.
+        #
         # @param category [Symbol]
         # @param entry [Class, Object]
         # @return [Class, Object]
         def register(category, entry)
           @mutex.synchronize do
-            @categories[category.to_sym] << entry
+            entries = @categories[category.to_sym]
+            entries << entry unless entries.include?(entry)
             entry
           end
         end
@@ -42,4 +47,4 @@ module Dcc
       end
     end
   end
-end
+end

data/lib/dcc/plugin.rb

@@ -5,13 +5,17 @@
 # without modifying the core codebase (Open/Closed Principle).
 #
 # @example Register a custom validator
-#   Dcc::Plugin.register(:validators, MyCustomRule)
+#   class MyPlugin
+#     include Dcc::Plugin::Base
+#     register_validator MyCustomRule
+#   end
 #
 # @example List all registered validators
 #   Dcc::Plugin.all(:validators)
 module Dcc
   module Plugin
     autoload :Registry, "dcc/plugin/registry"
+    autoload :Base, "dcc/plugin/base"
 
     class << self
       # @param category [Symbol] e.g. :validators, :converters, :cli_commands.
@@ -39,4 +43,4 @@ module Dcc
       end
     end
   end
-end
+end

data/lib/dcc/quantity_format/formatter.rb

@@ -45,25 +45,24 @@ module Dcc
       private
 
       def format_value
-        # Two decimals by default; tightened to uncertainty precision when known.
-        return @value.round(2).to_s("F") if uncertainty.nil?
+        # Two decimals by default, tightened to the uncertainty's precision
+        # when it has any. Neither a nil nor a NaN uncertainty has one.
+        return @value.round(2).to_s("F") if uncertainty.nil? || uncertainty.nan?
 
-        # Decimal places = 1 - floor(log10(uncertainty))
-        decimal_places = [0, 1 - Integer(Math.log10(uncertainty.to_f).floor)].max
         @value.round(decimal_places).to_s("F")
       end
 
       def format_uncertainty
         return "" if uncertainty.nil?
+        return "NaN" if uncertainty.nan?
 
-        decimal_places = [0, 1 - Integer(Math.log10(uncertainty.to_f).floor)].max
         uncertainty.round(decimal_places).to_s("F")
       end
 
       def align_value_and_uncertainty
         return [@value.to_s("F"), uncertainty.to_s("F")] if uncertainty.nil?
+        return [format_value, "NaN"] if uncertainty.nan?
 
-        decimal_places = [0, 1 - Integer(Math.log10(uncertainty.to_f).floor)].max
         v_str = @value.round(decimal_places).to_s("F")
         u_str = uncertainty.round(decimal_places).to_s("F")
         # Short form: digits of uncertainty after the last common digit
@@ -71,6 +70,13 @@ module Dcc
         [v_str, last_digits]
       end
 
+      # Decimal places = 1 - floor(log10(uncertainty)). D-SI writes `NaN` for a
+      # not-measured entry (SI_Format.xsd:1195) and `Math.log10` cannot answer
+      # for it, so every caller excludes nil and NaN first.
+      def decimal_places
+        [0, 1 - Integer(Math.log10(uncertainty.to_f).floor)].max
+      end
+
       def unit_suffix
         return "" if unit.nil? || unit.empty?
 
@@ -81,10 +87,10 @@ module Dcc
         unit
           .to_s
           .gsub(/\\([a-z]+)/, '\\1') # \kelvin → kelvin
-          .gsub(/\\per/, '/')
-          .gsub(/\\cubic/, '^3')
-          .gsub(/\\square/, '^2')
+          .gsub("\\per", "/")
+          .gsub("\\cubic", "^3")
+          .gsub("\\square", "^2")
       end
     end
   end
-end
+end

data/lib/dcc/quantity_format.rb

@@ -7,4 +7,4 @@ module Dcc
   module QuantityFormat
     autoload :Formatter, "dcc/quantity_format/formatter"
   end
-end
+end

data/lib/dcc/quantity_math/quantity.rb

@@ -43,4 +43,4 @@ module Dcc
       end
     end
   end
-end
+end

data/lib/dcc/quantity_math/real.rb

@@ -52,7 +52,7 @@ module Dcc
       # @param exponent [Integer]
       # @return [Real]
       def **(exponent)
-        new_value = value ** exponent
+        new_value = value**exponent
         Real.new(
           value: new_value,
           unit: unit && "^#{exponent}",
@@ -75,7 +75,7 @@ module Dcc
         return other.uncertainty if uncertainty.nil?
         return uncertainty if other.uncertainty.nil?
 
-        sum_of_squares = (uncertainty ** 2) + (other.uncertainty ** 2)
+        sum_of_squares = (uncertainty**2) + (other.uncertainty**2)
         BigDecimal(Math.sqrt(sum_of_squares.to_f).to_s)
       end
 
@@ -86,15 +86,15 @@ module Dcc
 
         a_rel = uncertainty / value
         b_rel = other.uncertainty / other.value
-        sum_of_squares = (a_rel ** 2) + (b_rel ** 2)
+        sum_of_squares = (a_rel**2) + (b_rel**2)
         BigDecimal(Math.sqrt(sum_of_squares.to_f).to_s) * new_value.abs
       end
 
       # Power rule: σ_y = |n * x^(n-1)| * σ_x
-      def power_uncertainty(exponent, new_value)
+      def power_uncertainty(exponent, _new_value)
         return nil unless uncertain?
 
-        derivative = exponent * (value ** (exponent - 1))
+        derivative = exponent * (value**(exponent - 1))
         (derivative.abs * uncertainty)
       end
 
@@ -113,4 +113,4 @@ module Dcc
       end
     end
   end
-end
+end

data/lib/dcc/quantity_math.rb

@@ -11,4 +11,4 @@ module Dcc
     autoload :Quantity, "dcc/quantity_math/quantity"
     autoload :Real, "dcc/quantity_math/real"
   end
-end
+end

data/lib/dcc/schema/version.rb

@@ -30,7 +30,7 @@ module Dcc
         def normalize(v)
           return nil if v.nil?
 
-          s = v.to_s.sub(/\Av/, "").gsub(/_/, ".")
+          s = v.to_s.sub(/\Av/, "").gsub("_", ".")
           s.empty? ? nil : s
         end
 
@@ -56,7 +56,7 @@ module Dcc
         # from the XML body.
         def resolve_dcc(version, xml: nil)
           v = normalize(version)
-          return detect_from_xml(xml) if v.nil? || v == "auto"
+          return detect_from_xml(xml) || DCC_LATEST if v.nil? || v == "auto"
           return DCC_LATEST if v == "latest"
 
           unless dcc?(v)

data/lib/dcc/server/app.html

@@ -0,0 +1,282 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width,initial-scale=1.0">
+<title>DCC Validator</title>
+<script src="https://unpkg.com/vue@3/dist/vue.global.prod.js"></script>
+<script src="https://unpkg.com/@tailwindcss/browser@4"></script>
+<style>
+[v-cloak] { display: none; }
+@keyframes slideUp { from { opacity: 0; transform: translateY(8px); } to { opacity: 1; transform: translateY(0); } }
+.slide-up { animation: slideUp 0.4s ease-out both; }
+.slide-up:nth-child(2) { animation-delay: .06s; }
+.slide-up:nth-child(3) { animation-delay: .12s; }
+.slide-up:nth-child(4) { animation-delay: .18s; }
+.slide-up:nth-child(5) { animation-delay: .24s; }
+.pulse-dot { animation: pd 2s ease-in-out infinite; }
+@keyframes pd { 0%,100% { opacity:1; } 50% { opacity:.3; } }
+</style>
+</head>
+<body class="bg-slate-950 text-slate-200 font-sans antialiased min-h-screen" style="font-family: 'Inter', system-ui, sans-serif;">
+<div id="app" v-cloak>
+
+<!-- Header bar -->
+<div class="border-b border-slate-800 bg-slate-900/50 backdrop-blur sticky top-0 z-50">
+  <div class="max-w-5xl mx-auto px-6 py-3 flex items-center gap-4">
+    <div class="flex items-center gap-2">
+      <div class="w-8 h-8 rounded-lg bg-cyan-500/10 border border-cyan-500/30 flex items-center justify-center">
+        <span class="text-cyan-400 text-lg font-bold">D</span>
+      </div>
+      <span class="font-semibold text-slate-100">DCC Validator</span>
+      <span class="text-xs text-slate-500 hidden sm:inline">v{{ version }}</span>
+    </div>
+    <div class="flex-1"></div>
+    <button @click="loadDemo" class="px-3 py-1.5 text-xs font-medium rounded-lg border border-slate-700 hover:border-cyan-500/50 hover:text-cyan-400 transition-colors">
+      Load Demo Certificate
+    </button>
+    <label class="cursor-pointer px-3 py-1.5 text-xs font-medium rounded-lg bg-cyan-500/10 border border-cyan-500/30 text-cyan-400 hover:bg-cyan-500/20 transition-colors">
+      Upload DCC XML
+      <input type="file" accept=".xml,.dcc" class="hidden" @change="onUpload($event)">
+    </label>
+  </div>
+</div>
+
+<!-- Drop zone (when no cert loaded) -->
+<div v-if="!cert && !loading" class="max-w-2xl mx-auto px-6 pt-24">
+  <div
+    @dragover.prevent="dragActive = true"
+    @dragleave.prevent="dragActive = false"
+    @drop.prevent="onDrop($event)"
+    :class="['border-2 border-dashed rounded-2xl p-16 text-center transition-all', dragActive ? 'border-cyan-500 bg-cyan-500/5' : 'border-slate-800']"
+  >
+    <div class="text-5xl mb-4 opacity-30">📋</div>
+    <p class="text-slate-400 mb-1">Drag a DCC XML file here</p>
+    <p class="text-slate-600 text-sm">or click upload above</p>
+    <button @click="loadDemo" class="mt-6 px-4 py-2 text-sm font-medium rounded-lg bg-cyan-500/10 border border-cyan-500/30 text-cyan-400 hover:bg-cyan-500/20 transition-colors">
+      Try a demo certificate →
+    </button>
+  </div>
+</div>
+
+<!-- Loading -->
+<div v-if="loading" class="max-w-2xl mx-auto px-6 pt-32 text-center">
+  <div class="inline-block w-8 h-8 border-2 border-cyan-500/30 border-t-cyan-500 rounded-full animate-spin mb-4"></div>
+  <p class="text-slate-400 text-sm">Validating certificate...</p>
+</div>
+
+<!-- Certificate view -->
+<div v-if="cert && !loading" class="max-w-5xl mx-auto px-6 py-8 space-y-4">
+
+  <!-- Validity banner -->
+  <div :class="['rounded-2xl p-5 border slide-up flex items-center gap-4',
+       validation.ok ? 'bg-green-500/5 border-green-500/20' : 'bg-red-500/5 border-red-500/20']">
+    <div :class="['w-12 h-12 rounded-xl flex items-center justify-center text-2xl',
+         validation.ok ? 'bg-green-500/10' : 'bg-red-500/10']">
+      {{ validation.ok ? '✓' : '✕' }}
+    </div>
+    <div class="flex-1">
+      <div :class="['font-semibold text-lg', validation.ok ? 'text-green-400' : 'text-red-400']">
+        {{ validation.ok ? 'Certificate Valid' : 'Validation Failed' }}
+      </div>
+      <div class="text-sm text-slate-500">
+        {{ validation.errors.length }} error{{ validation.errors.length === 1 ? '' : 's' }},
+        {{ validation.warnings.length }} warning{{ validation.warnings.length === 1 ? '' : 's' }}
+        <span v-if="cert.schemaVersion"> · Schema v{{ cert.schemaVersion }}</span>
+      </div>
+    </div>
+    <div class="flex items-center gap-1.5 px-3 py-1 rounded-full text-xs font-medium"
+         :class="validation.ok ? 'bg-green-500/10 text-green-400 border border-green-500/20' : 'bg-red-500/10 text-red-400 border border-red-500/20'">
+      <span class="w-1.5 h-1.5 rounded-full pulse-dot" :class="validation.ok ? 'bg-green-400' : 'bg-red-400'"></span>
+      {{ validation.ok ? 'VALID' : 'INVALID' }}
+    </div>
+  </div>
+
+  <!-- Errors list -->
+  <div v-if="validation.errors.length" class="slide-up rounded-xl border border-red-500/15 bg-red-500/[0.03] overflow-hidden">
+    <div class="px-5 py-3 border-b border-red-500/10 text-xs font-semibold uppercase tracking-wide text-red-400/80">Validation Errors</div>
+    <div class="divide-y divide-red-500/5">
+      <div v-for="e in validation.errors" :key="e.line" class="px-5 py-3 flex gap-3">
+        <span class="text-red-500/50 text-xs font-mono pt-0.5">{{ e.line ? 'L'+e.line : '—' }}</span>
+        <span class="text-sm text-slate-300">{{ e.message }}</span>
+      </div>
+    </div>
+  </div>
+
+  <!-- Certificate identity -->
+  <div class="slide-up rounded-2xl border border-slate-800 bg-slate-900 overflow-hidden">
+    <div class="bg-gradient-to-br from-slate-900 to-slate-800/50 p-6 relative overflow-hidden">
+      <div class="absolute top-0 right-0 w-64 h-64 bg-cyan-500/5 rounded-full blur-3xl"></div>
+      <div class="relative flex justify-between items-start gap-4">
+        <div>
+          <div class="inline-flex items-center gap-1.5 px-2.5 py-1 rounded-full text-[10px] font-semibold uppercase tracking-wider border border-cyan-500/30 text-cyan-400 bg-cyan-500/5 mb-3">
+            <span class="w-1 h-1 rounded-full bg-cyan-400 pulse-dot"></span>
+            Digital Calibration Certificate
+          </div>
+          <h1 class="text-2xl font-bold text-slate-100 mb-1">{{ cert.itemName || 'Calibration Certificate' }}</h1>
+          <p class="text-slate-400">{{ cert.labName || '' }}</p>
+          <p class="font-mono text-xs text-slate-600 mt-1.5">ID: {{ cert.uniqueId || '—' }}</p>
+        </div>
+        <div class="text-right border-l border-slate-700 pl-6">
+          <div class="text-[10px] uppercase tracking-wider text-slate-500">Schema</div>
+          <div class="font-mono text-green-400 font-medium">v{{ cert.schemaVersion }}</div>
+          <div class="mt-2 text-[10px] uppercase tracking-wider text-slate-500">Country</div>
+          <div class="font-mono text-lg">{{ cert.country || '—' }}</div>
+        </div>
+      </div>
+    </div>
+  </div>
+
+  <!-- Core data -->
+  <div v-if="cert.coreData" class="slide-up rounded-xl border border-slate-800 bg-slate-900 overflow-hidden">
+    <div class="px-5 py-3 border-b border-slate-800 flex items-center gap-2">
+      <span class="text-slate-500">⚙</span>
+      <span class="text-xs font-semibold uppercase tracking-wide text-slate-500">Core Data</span>
+    </div>
+    <div class="p-5 grid grid-cols-2 sm:grid-cols-3 gap-px bg-slate-800/50">
+      <div class="bg-slate-900 p-3" v-for="f in cert.coreData">
+        <div class="text-[10px] uppercase tracking-wider text-slate-600 mb-0.5">{{ f.label }}</div>
+        <div class="font-mono text-sm text-slate-200">{{ f.value }}</div>
+      </div>
+    </div>
+  </div>
+
+  <!-- Measurement results -->
+  <div v-if="cert.measurements && cert.measurements.length" class="slide-up rounded-xl border border-slate-800 bg-slate-900 overflow-hidden">
+    <div class="px-5 py-3 border-b border-slate-800 flex items-center gap-2">
+      <span class="text-slate-500">⚡</span>
+      <span class="text-xs font-semibold uppercase tracking-wide text-slate-500">Measurement Results</span>
+    </div>
+    <div class="p-5 space-y-3">
+      <div v-for="mr in cert.measurements" :key="mr.name" class="rounded-lg border border-slate-800 bg-slate-800/40 p-4">
+        <div class="font-medium text-slate-200 mb-3">{{ mr.name }}</div>
+        <div v-if="mr.results && mr.results.length" class="space-y-2">
+          <div v-for="r in mr.results" :key="r.name" class="flex items-center justify-between py-2 border-l-2 border-cyan-500/30 pl-3 bg-cyan-500/[0.03] rounded-r-lg">
+            <span class="text-sm text-slate-400">{{ r.name }}</span>
+            <span v-if="r.values" class="font-mono text-sm">
+              <span v-for="(v, i) in r.values" :key="i" class="ml-2">
+                <span class="text-green-400">{{ v.value }}</span>
+                <span class="text-slate-600"> {{ v.unit }}</span>
+                <span v-if="v.uncertainty" class="text-amber-400/60 text-xs"> ±{{ v.uncertainty }}</span>
+              </span>
+            </span>
+          </div>
+        </div>
+      </div>
+    </div>
+  </div>
+
+  <!-- Lab / Signer -->
+  <div class="slide-up grid sm:grid-cols-2 gap-4">
+    <div v-if="cert.lab" class="rounded-xl border border-slate-800 bg-slate-900 overflow-hidden">
+      <div class="px-5 py-3 border-b border-slate-800 text-xs font-semibold uppercase tracking-wide text-slate-500">Calibration Laboratory</div>
+      <div class="p-5">
+        <div class="font-medium text-slate-200 mb-1">{{ cert.lab.name }}</div>
+        <div v-if="cert.lab.email" class="font-mono text-xs text-slate-500">{{ cert.lab.email }}</div>
+        <div v-if="cert.lab.address" class="text-sm text-slate-400 mt-2">{{ cert.lab.address }}</div>
+      </div>
+    </div>
+    <div v-if="cert.signers && cert.signers.length" class="rounded-xl border border-slate-800 bg-slate-900 overflow-hidden">
+      <div class="px-5 py-3 border-b border-slate-800 text-xs font-semibold uppercase tracking-wide text-slate-500">Responsible Persons</div>
+      <div class="p-5 space-y-2">
+        <div v-for="s in cert.signers" :key="s.name" class="flex items-center gap-3 rounded-lg border border-slate-800 bg-slate-800/40 px-3 py-2">
+          <div class="w-8 h-8 rounded-full bg-cyan-500 text-slate-900 flex items-center justify-center text-xs font-bold">{{ initials(s.name) }}</div>
+          <div class="flex-1">
+            <div class="text-sm font-medium text-slate-200">{{ s.name }}</div>
+            <div v-if="s.email" class="font-mono text-xs text-slate-500">{{ s.email }}</div>
+          </div>
+          <span v-if="s.main" class="px-2 py-0.5 rounded-full text-[10px] font-semibold uppercase tracking-wider text-green-400 border border-green-500/20 bg-green-500/10">Main</span>
+        </div>
+      </div>
+    </div>
+  </div>
+
+  <!-- XML source -->
+  <div class="slide-up rounded-xl border border-slate-800 bg-slate-900 overflow-hidden">
+    <button @click="showXml = !showXml" class="w-full px-5 py-3 flex items-center justify-between text-xs font-semibold uppercase tracking-wide text-slate-500 hover:bg-slate-800/50 transition-colors">
+      <span>XML Source</span>
+      <span>{{ showXml ? '▲' : '▼' }}</span>
+    </button>
+    <div v-if="showXml" class="p-5 overflow-auto max-h-96">
+      <pre class="text-xs text-slate-400 font-mono whitespace-pre-wrap">{{ rawXml }}</pre>
+    </div>
+  </div>
+
+</div>
+</div>
+
+<script>
+(function() {
+  const { createApp, ref, computed } = Vue;
+
+  createApp({
+    setup() {
+      const cert = ref(null);
+      const loading = ref(false);
+      const dragActive = ref(false);
+      const showXml = ref(false);
+      const rawXml = ref('');
+      const validation = ref({ ok: true, errors: [], warnings: [] });
+      const version = ref('0.2.0');
+
+      async function validate(xml) {
+        loading.value = true;
+        try {
+          const res = await fetch('/validate', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/xml' },
+            body: xml,
+          });
+          const data = await res.json();
+          cert.value = data.cert;
+          validation.value = data.validation;
+          rawXml.value = xml;
+        } catch (e) {
+          validation.value = { ok: false, errors: [{ line: null, message: 'Server error: ' + e.message }], warnings: [] };
+        }
+        loading.value = false;
+      }
+
+      async function loadDemo() {
+        loading.value = true;
+        try {
+          const res = await fetch('/demo.xml');
+          const xml = await res.text();
+          await validate(xml);
+        } catch (e) {
+          loading.value = false;
+        }
+      }
+
+      function onUpload(e) {
+        const file = e.target.files[0];
+        if (!file) return;
+        const reader = new FileReader();
+        reader.onload = (ev) => validate(ev.target.result);
+        reader.readAsText(file);
+      }
+
+      function onDrop(e) {
+        dragActive.value = false;
+        const file = e.dataTransfer.files[0];
+        if (!file) return;
+        const reader = new FileReader();
+        reader.onload = (ev) => validate(ev.target.result);
+        reader.readAsText(file);
+      }
+
+      function initials(name) {
+        if (!name) return '?';
+        const parts = name.trim().split(/\s+/);
+        if (parts.length === 1) return parts[0][0].toUpperCase();
+        return (parts[0][0] + parts[parts.length - 1][0]).toUpperCase();
+      }
+
+      return { cert, loading, dragActive, showXml, rawXml, validation, version,
+               loadDemo, onUpload, onDrop, initials };
+    }
+  }).mount('#app');
+})();
+</script>
+</body>
+</html>