parseapi 1.9.0 → 1.9.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b27f8a145b9ad37ccd82a61e8e175665416036116ed037bb68640d5bd17d3d5c
-  data.tar.gz: 216cee2f23076dbe2cdcb1339313a157356d63cae236c2204d795fa17242cda7
+  metadata.gz: 9305f04eec9c9f1ed484906fb69244df03127edae6b7466c023e5855631ec6dd
+  data.tar.gz: 2adccd9a7bfc7a456b7f0b4b5bab86f3d8b30bb4fa744b2c510a14933b99b4bf
 SHA512:
-  metadata.gz: 63b2f6b437f1c2e77b8d39a7da11b497a473616f22ac819cc838253495f1ec2b9b146a5f7f6f89025df9a2bc66e18b58a7037b9156bdfc84bc39116280757df2
-  data.tar.gz: 3fd6e9ef3a55d5c35a7ae693573b17b1fe84aa41936e2836de0def9c1819f0347ee8d49bbff0718d794fc279a26a7b4520d3383805f6e56ca83b6ad806808ec6
+  metadata.gz: 4f71799f8c0304a0281fd4b3e50c08d66e4123243515eb85d0077acedbd420bb753ac5a67040e73382005d88cb8f7fd891cc495af7c958c553b8206399e8bf7f
+  data.tar.gz: 98f12a7c2d8ef6886cd78587a9a2578c1858aa85bf33e1be6d2ba407d2185f705a0e385b1d6c1da010246b2750c9614850a8f9d7c3a1d580290aa47d8f396a4b

data/README.md

@@ -228,6 +228,8 @@ units = parse.measure_units(unit: 'm')
 
 `amount` is a decimal string, such as `"180.34"`. Without `to`, the API returns the canonical unit for the measurement type. Pass `locale` for number formatting and `system` (`us` or `imperial`) when a customary unit needs context. Ambiguous input returns `valid: false`, a `reason`, and available `choices`. Invalid or incompatible target units use the normal API error.
 
+Successful HTTP JSON contains `measure`, `valid`, `type`, `amount`, and `unit`. Invalid input adds `reason`. `choices` appears only when unit alternatives are available.
+
 Unit discovery accepts optional `query`, `type`, and `unit` filters. `unit` selects compatible targets. Omit the filters for the reviewed catalog. Both operations use pooled requests.
 
 ## Place statistics and optional detail
@@ -419,3 +421,35 @@ Successful checks may be reused for up to 24 hours. `pretty` optionally formats
 Stack defaults to a 35-second transport timeout so a first scan has time to finish. Other lookups retain their 10-second default. An explicit client timeout takes precedence.
 
 Vehicle lookups use `vin` as the input and response field. Existing VIN methods remain available for compatibility.
+
+## Emoji catalog additions
+
+Resolve Unicode emoji or a named shortcode, search or browse a bounded catalog,
+parse emoji positions in text, and convert between Unicode and a selected shortcode source.
+The ordinary lookup remains four fields:
+
+```http
+GET /emoji/rocket
+```
+
+```json
+{"emoji":"🚀","name":"Rocket","shortcodes":[":rocket:","rocket"],"category":"Travel & Places"}
+```
+
+Use `deep=true` for Unicode facts, keywords, tone families and available artwork.
+Artwork is keyed by style: `deep.artwork.openmoji.svg` is the SVG URL, and
+`deep.artwork.openmoji.png["72"]` is the 72×72 PNG URL (use your language’s map
+access syntax). The same shape applies to `noto` and `twemoji`. Missing styles
+and formats are omitted. URLs pin immutable artwork editions and retain their bytes.
+Core values stay unchanged. Text parsing returns `emojis` with UTF-16 `positions`;
+conversion returns `text` and unresolved tokens with positions and reasons.
+
+The compact JSON catalog contains offline identity, qualification-form and
+shortcode indexes. Request `profile=full` when artwork is needed and `lang` when
+localized names and keywords are needed. `/emoji/metadata` carries dataset
+coverage and shared source notices once. Artwork supports Google Noto, Twemoji
+and OpenMoji, with real SVG/PNG availability and immutable first-party URLs.
+A device's emoji font remains the ordinary display.
+
+These additions are a local release candidate until the matching SDK and
+backend are published. Existing lookup and search contracts are preserved.

data/lib/parseapi/client.rb

@@ -394,16 +394,46 @@ module ParseAPI
 			get('/weather', lat: lat, lon: lon, deep: deep, date: date)
 		end
 
-		def emoji(emoji, deep: false, lang: nil)
-			get("/emoji/#{seg(emoji)}", deep: deep, lang: lang)
+		def emoji(emoji, deep: false, lang: nil, shortcode_source: nil)
+			get("/emoji/#{seg(emoji)}", deep: deep, lang: lang, shortcode_source: shortcode_source)
 		end
 
-		def emoji_search(query, limit: nil, deep: false, lang: nil)
-			get('/emoji', q: query, limit: limit, deep: deep, lang: lang)
+		def emoji_search(query, limit: nil, deep: false, lang: nil, category: nil, subcategory: nil, version: nil, max_version: nil, include_skin_tones: nil, offset: nil)
+			get('/emoji', q: query, limit: limit, deep: deep, lang: lang, category: category, subcategory: subcategory, version: version, max_version: max_version, include_skin_tones: include_skin_tones.nil? ? nil : include_skin_tones.to_s, offset: offset)
 		end
 
+		def emoji_browse(limit: nil, deep: false, lang: nil, category: nil, subcategory: nil, version: nil, max_version: nil, include_skin_tones: nil, offset: nil)
+			get('/emoji', limit: limit, deep: deep, lang: lang, category: category, subcategory: subcategory, version: version, max_version: max_version, include_skin_tones: include_skin_tones.nil? ? nil : include_skin_tones.to_s, offset: offset)
+		end
+
+		# Download the full filtered JSON catalog, including offline resolution maps.
+		def emoji_catalog(deep: true, lang: nil, category: nil, subcategory: nil, version: nil, max_version: nil, include_skin_tones: nil, profile: nil)
+			get('/emoji/catalog', profile: profile, deep: deep.to_s, lang: lang, category: category, subcategory: subcategory, version: version, max_version: max_version, include_skin_tones: include_skin_tones.nil? ? nil : include_skin_tones.to_s)
+		end
+
+		def emoji_metadata
+			get('/emoji/metadata')
+		end
+
+		def emoji_categories
+			get('/emoji/categories')
+		end
+
+		# Positions are UTF-16 code units; end is exclusive.
+		def emoji_parse(text, deep: false, lang: nil)
+			get('/emoji/parse', { deep: deep, lang: lang }, {}, { text: text })
+		end
+
+		def emoji_convert(text, direction:, shortcode_source:)
+			get('/emoji/convert', {direction: direction, shortcode_source: shortcode_source}, {}, {text: text})
+		end
+
+
+
+
 		# Parse or convert a measurement. Amount is a decimal string. Without to, use the
 		# type's canonical unit. Locale and system (us or imperial) resolve explicit ambiguity.
+		# Successful JSON omits reason and choices. Invalid input adds reason and alternatives add choices.
 		def measure(measure, to: nil, locale: nil, system: nil)
 			get("/measure/#{seg(measure)}", to: to, locale: locale, system: system)
 		end

data/lib/parseapi/version.rb

@@ -1,3 +1,3 @@
 module ParseAPI
-	VERSION = '1.9.0'.freeze
+	VERSION = '1.9.2'.freeze
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: parseapi
 version: !ruby/object:Gem::Version
-  version: 1.9.0
+  version: 1.9.2
 platform: ruby
 authors:
 - ParseAPI
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-29 00:00:00.000000000 Z
+date: 2026-10-14 00:00:00.000000000 Z
 dependencies: []
 description:
 email: