tsukimoji 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 8cbd8314413fd0da84dc2e71d44c30a20c12b3490e2096f3217d6a1082f71e4a
+  data.tar.gz: a386a3203c772550e91df4b5edf1e80e69a8d060a886a3d7a2891c2ef1ccd0ab
+SHA512:
+  metadata.gz: 4490a686543b5a04c11a20c87a1fc41b724299d74bf1adfdc42e29aae2f5d88816ddb61ccad38d20efc699bc1a86b48f35d01d19981d1e594d786922d5add44e
+  data.tar.gz: 58c0905adba6d2f789d828b1878faecfacb964edf00100cfa5b80efd40a001edf235a4b705f6b74901ee84077a00f61dde2e3ff504ef23e0778463154879fc63

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sam Lehman
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,48 @@
+# tsukiMOJi
+
+Moon phase emoji for any date. 月 (tsuki, "moon") + moji, as in emoji.
+
+```ruby
+require "tsukimoji"
+
+phase = Tsukimoji.phase
+phase.emoji        # => "🌔"
+phase.name         # => "Waxing Gibbous"
+phase.age_days      # => 12.3
+phase.illumination  # => 0.87
+
+Tsukimoji.emoji     # just the emoji, for "now"
+Tsukimoji.phase(Time.utc(2026, 1, 1)) # phase for any specific time
+```
+
+## Installation
+
+```
+gem install tsukimoji
+```
+
+Or add to your Gemfile:
+
+```ruby
+gem "tsukimoji"
+```
+
+## How it works
+
+tsukiMOJi measures elapsed time since a known new moon (2000-01-06
+18:14 UTC) against the synodic month (29.530588853 days) to find how far
+into the current lunar cycle a given moment falls, then maps that
+fraction onto the eight standard moon-phase emoji (🌑🌒🌓🌔🌕🌖🌗🌘).
+Illumination is derived separately from the same cycle position via a
+cosine curve, for display purposes.
+
+## License
+
+MIT
+
+---
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/samlehman/tsukimoji/main/made-in-baltimore.png" alt="Made in Baltimore" width="88" align="middle">
+  &nbsp;&nbsp;☕ <a href="https://paypal.me/samlehman">Buy me a coffee</a> · <a href="https://paypal.me/samlehman">こーひーをおごって</a>
+</p>

data/lib/tsukimoji.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+require "time"
+
+# tsukiMOJi ("moon" + "moji", as in emoji) computes the current lunar
+# phase for any date and returns the matching emoji, phase name, age in
+# days, and illumination fraction.
+#
+# Ported from the original moon-phase.html JavaScript prototype.
+module Tsukimoji
+  SYNODIC_MONTH_DAYS = 29.530588853
+  SYNODIC_MONTH_SECONDS = SYNODIC_MONTH_DAYS * 24 * 60 * 60
+
+  # A known new moon reference point: 2000-01-06 18:14 UTC.
+  KNOWN_NEW_MOON = Time.utc(2000, 1, 6, 18, 14, 0)
+
+  PHASES = [
+    { emoji: "\u{1F311}", name: "New Moon" },
+    { emoji: "\u{1F312}", name: "Waxing Crescent" },
+    { emoji: "\u{1F313}", name: "First Quarter" },
+    { emoji: "\u{1F314}", name: "Waxing Gibbous" },
+    { emoji: "\u{1F315}", name: "Full Moon" },
+    { emoji: "\u{1F316}", name: "Waning Gibbous" },
+    { emoji: "\u{1F317}", name: "Last Quarter" },
+    { emoji: "\u{1F318}", name: "Waning Crescent" },
+  ].freeze
+
+  # Immutable result of a phase calculation.
+  Phase = Struct.new(:emoji, :name, :age_days, :illumination, keyword_init: true) do
+    def to_s
+      emoji
+    end
+  end
+
+  class << self
+    # Returns a Tsukimoji::Phase for the given time (defaults to now, UTC).
+    def phase(time = Time.now.utc)
+      time = time.utc
+      elapsed_seconds = time.to_f - KNOWN_NEW_MOON.to_f
+      cycles = elapsed_seconds / SYNODIC_MONTH_SECONDS
+      age = ((cycles % 1) + 1) % 1
+      index = ((age + 1.0 / 16) * 8).floor % 8
+      illumination = (1 - Math.cos(age * 2 * Math::PI)) / 2
+
+      data = PHASES[index]
+      Phase.new(
+        emoji: data[:emoji],
+        name: data[:name],
+        age_days: age * SYNODIC_MONTH_DAYS,
+        illumination: illumination
+      )
+    end
+
+    # Convenience shortcut: just the emoji for the given time.
+    def emoji(time = Time.now.utc)
+      phase(time).emoji
+    end
+
+    # Convenience shortcut: just the phase name for the given time.
+    def name(time = Time.now.utc)
+      phase(time).name
+    end
+  end
+end

metadata

@@ -0,0 +1,49 @@
+--- !ruby/object:Gem::Specification
+name: tsukimoji
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- Sam Lehman
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-10-02 00:00:00.000000000 Z
+dependencies: []
+description: tsukiMOJi computes the current (or any) lunar phase and returns the matching
+  emoji, phase name, age in days, and illumination fraction.
+email:
+- sam@bmore.md
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/tsukimoji.rb
+homepage: https://github.com/samlehman/tsukimoji
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/samlehman/tsukimoji
+  source_code_uri: https://github.com/samlehman/tsukimoji
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.7'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: Moon phase emoji for any date
+test_files: []