cleo_design_tokens 0.2.4 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4b26b7b458c43724454d2827bf71e276857f7948f46dfade6a22c0a78ed068f3
-  data.tar.gz: 13ff4a6a39778fe89c931a6cd1f01931e3d08b901262aa582bde3b054b366889
+  metadata.gz: 0a44c38f546ec1f31af8273066fa31c77538d6e9812225b0da0a763e5622afa6
+  data.tar.gz: 4a141717fc6df4973d260296903ce7e0f95525c6f9caee385ddf166877e7b615
 SHA512:
-  metadata.gz: fa1dc9fec6338e93595ef7b0252bd96a7a427b810ef5a262669e89874ded5882377a2a2fa6318e13d335b721af4e45f1e3e959fb72355d9165101307998a96ad
-  data.tar.gz: ff7a54aa890e5ebf7a3dce4d1364db1ce7e9ac6312f04fa7ac949d4f49582fce02218ddbebef0a1e0e77c093f88c82a235dc93f1a80480589a4f307681ee067b
+  metadata.gz: 9049839cd022f9c7cb925a3c443ccad2e0ae2145d68d463bfc19afc2cc55564e52b496f09c6c9cb93a3835a73d25cc975e3b6c8c078cdaa3afc02901abec67dc
+  data.tar.gz: 273d641074a554f32656ff6beabf7e723a19f7dff52506f1a57f7119b4821a3fcf6bbeb76a4d3bf7ec0c10d9edfcdd1bfd520284f1bc6bdcb2e882fde9187f87

data/lib/cleo_design_tokens/configuration.rb

@@ -48,9 +48,10 @@ module CleoDesignTokens
     private
 
     def build_palette(experience)
+      primitives = LookupBuilder.build_lookup(@primitives, experience: experience).freeze
       Palette.new(
-        primitives: LookupBuilder.build_lookup(@primitives, experience: experience).freeze,
-        semantic: LookupBuilder.build_semantic_lookup(@semantic, experience: experience).freeze,
+        primitives: primitives,
+        semantic: LookupBuilder.build_semantic_lookup(@semantic, experience: experience, primitives: primitives).freeze,
       )
     end
   end

data/lib/cleo_design_tokens/lookup_builder.rb

@@ -21,8 +21,21 @@ module CleoDesignTokens
 
     # Flattens `semantic.json` into a key -> SemanticEntry lookup, one entry
     # per role — the theme axis lives inside the entry, not in the key.
-    def self.build_semantic_lookup(tree, experience: :current)
-      flatten_tree(tree) { |leaf, key| semantic_entry(experience_leaf(leaf, experience, key), experience, key) }
+    def self.build_semantic_lookup(tree, experience: :current, primitives: nil)
+      schema = tree["$schema"]
+      if tree.key?("$schema") && schema != "cleo-semantic-references/1"
+        raise UnknownExperienceError, "unsupported semantic schema: #{schema.inspect}"
+      end
+      references = schema == "cleo-semantic-references/1"
+      flatten_tree(tree) do |leaf, key|
+        snapshots = leaf["$experiences"]
+        if references && leaf.key?("$experiences") && !snapshots.is_a?(Hash)
+          raise UnknownExperienceError, "invalid semantic experiences for #{key.inspect}"
+        end
+        shared = references && (experience.to_s == "current" || !snapshots.is_a?(Hash) || !snapshots.key?("cleoRefresh"))
+        snapshot = shared ? leaf : experience_leaf(leaf, experience, key)
+        semantic_entry(snapshot, experience, key, primitives: primitives, references: references)
+      end
     end
 
     # Walks `tree`, turning each leaf into a lookup entry via the block —
@@ -70,20 +83,20 @@ module CleoDesignTokens
     end
     private_class_method :experience_leaf
 
-    def self.semantic_entry(leaf, experience, key)
+    def self.semantic_entry(leaf, experience, key, primitives:, references:)
       themes = {}
       raw_themes = leaf["$themes"] || {}
       unless raw_themes.is_a?(Hash)
         raise UnknownExperienceError, "design token #{key.inspect} has invalid themes for experience #{experience.inspect}"
       end
       raw_themes.each do |theme, override|
-        value = override.is_a?(Hash) ? override["$value"] : nil
+        value = override.is_a?(Hash) ? semantic_value(override, key, primitives: primitives, references: references) : nil
         unless value.is_a?(String)
           raise UnknownExperienceError, "design token #{key.inspect} has no value for theme #{theme.inspect} in experience #{experience.inspect}"
         end
         themes[theme] = value.freeze
       end
-      value = leaf["$value"]
+      value = semantic_value(leaf, key, primitives: primitives, references: references)
       if (leaf.key?("$value") && !value.is_a?(String)) || (value.nil? && themes.empty?)
         raise UnknownExperienceError, "design token #{key.inspect} has no semantic values for experience #{experience.inspect}"
       end
@@ -93,5 +106,15 @@ module CleoDesignTokens
       SemanticEntry.new(value&.freeze, themes.freeze)
     end
     private_class_method :semantic_entry
+
+    def self.semantic_value(binding, key, primitives:, references:)
+      return binding["$value"] unless references && binding.key?("$ref")
+      ref = binding["$ref"]
+      if !ref.is_a?(String) || !primitives&.key?(ref) || binding.key?("$value")
+        raise UnknownExperienceError, "invalid primitive reference #{ref.inspect} for #{key.inspect}"
+      end
+      primitives.fetch(ref)
+    end
+    private_class_method :semantic_value
   end
 end

data/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meetcleo/design-tokens",
-  "version": "0.2.4",
+  "version": "0.3.0",
   "description": "Canonical source of truth for Cleo's design tokens (DTCG JSON), plus a TypeScript reader.",
   "type": "module",
   "license": "UNLICENSED",