id-calendar-tui-clariant 0.1.3

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 1e14fda49a87e3fd1897c0c50c1881d9c553d80f236c4088f4b545b320fa7622
+  data.tar.gz: 50c43991b6a0180eb526caeabf8b879dd5b6628fde6ee9f542555b2e146e121c
+SHA512:
+  metadata.gz: 6c03f07c54d43aa7f5b2e590012a9c843da1c90682984c12b29991a21f1a154de9c51abc7729eae8274d960d69c3601456a17b6d39ac3ba5aebaa2dda923e0c7
+  data.tar.gz: a1be0fa468e16d463c335eac7921e49a297acaaf3566da6924de4092daf2f470634ac2446a9c55dda7297f4a177ca7c55e9e1c14ae9a01637e44ebab1342875f

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Adi Purnama
+
+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,152 @@
+# ID Calendar TUI
+
+[![Gem Version](https://badge.fury.io/rb/id-calendar-tui-clariant.svg)](https://badge.fury.io/rb/id-calendar-tui-clariant)
+[![Docker Image](https://img.shields.io/badge/GHCR-latest-blue?logo=docker)](https://github.com/clariantb/id-calendar-tui/pkgs/container/id-calendar-tui)
+
+A terminal-based calendar application for Indonesian public holidays with vim-like navigation.
+
+Fork of [adiprnm/id-calendar-tui](https://github.com/adiprnm/id-calendar-tui) that
+takes holiday data from the official SKB 3 Menteri announcements and releases it
+automatically, published as the `id-calendar-tui-clariant` gem.
+
+![Calendar Screenshot](screenshot.png)
+
+## Features
+
+- Full calendar view with Indonesian public holidays
+- Vim-like navigation (h/j/k/l)
+- Navigate months with arrow keys
+- Jump to today with `g`
+- Color-coded holidays (National, Religious, Cultural)
+- Clean, centered TUI interface
+
+## Installation
+
+### Via RubyGems
+
+```bash
+gem install id-calendar-tui-clariant
+calendar
+```
+
+### Via Docker (GHCR)
+
+```bash
+docker run --rm -it ghcr.io/clariantb/id-calendar-tui:latest
+```
+
+### From Source
+
+```bash
+git clone https://github.com/clariantb/id-calendar-tui.git
+cd id-calendar-tui
+bundle install
+bundle exec ruby bin/calendar
+```
+
+## Usage
+
+```bash
+# Run the calendar
+calendar
+
+# Or with bundle
+bundle exec calendar
+```
+
+## Navigation
+
+| Key | Action |
+|-----|--------|
+| `h`, `←` | Previous month |
+| `l`, `→` | Next month |
+| `j`, `k` | Previous/Next year |
+| `g` | Go to today |
+| `q`, `Ctrl+C` | Quit |
+
+## Holidays Included
+
+- **National Holidays**: New Year, Independence Day, etc.
+- **Islamic Holidays**: Eid al-Fitr, Eid al-Adha, etc.
+- **Hindu Holidays**: Nyepi (Day of Silence)
+- **Chinese New Year**: Imlek, Cap Go Meh
+- **Christian Holidays**: Good Friday, Easter, Christmas
+
+### Holiday Data
+
+Holiday dates (libur nasional and *cuti bersama*) live in `data/holidays.json` and
+come from the government's official SKB 3 Menteri announcement as published by
+Setneg/Setkab. There is no official machine-readable source, so
+`scripts/fetch_holidays.rb` parses the press release and accepts it only if it
+matches the article's own stated totals ("sebanyak N hari") and the weekday printed
+beside every date.
+
+A weekly GitHub Action (`.github/workflows/update-holidays.yml`) imports next
+year's list as soon as it is announced (usually September–October) and commits it.
+The action fails, so GitHub notifies the repository owner, when Google's public
+Indonesian holiday calendar shows that a decree is out but the import found
+nothing, or that a holiday was added by an amendment (*SKB perubahan*). To fix:
+
+```bash
+# Announcement published under a new URL
+ruby scripts/fetch_holidays.rb --year 2028 --url https://www.setneg.go.id/baca/index/...
+```
+
+Amendments are added by hand to that year's `holidays` in `data/holidays.json`,
+with the announcement URL in `sources`; `--year`/`--url` refuses to re-import an
+existing year unless given `--force`, which would drop them. Scheduled runs never
+overwrite a year that is already imported. Years that have not been announced
+show *"belum diumumkan"* instead of guessed dates.
+
+The app reads only this file (no network at runtime), so the same workflow also
+releases: whenever `data/holidays.json` differs from the latest `v*` tag (a new
+import or a pushed amendment), it bumps the patch version, adds a CHANGELOG
+entry, tags, and dispatches `release.yml`, which validates the data and publishes
+the gem and Docker image.
+
+## Requirements
+
+- Ruby 2.6+
+- Terminal with color support
+
+## Development
+
+```bash
+# Install dependencies
+bundle install
+
+# Run the application
+bundle exec ruby bin/calendar
+
+# Build gem
+bundle exec gem build id-calendar-tui.gemspec
+
+# Build Docker image
+docker build -t id-calendar-tui .
+```
+
+## Releasing
+
+Holiday data releases are automatic (see [Holiday Data](#holiday-data)). For a
+code release:
+
+```bash
+# Update version in id-calendar-tui.gemspec and CHANGELOG.md
+git add .
+git commit -m "Bump version to x.x.x"
+git tag vx.x.x
+git push origin vx.x.x
+```
+
+Either way `release.yml` publishes to
+[RubyGems](https://rubygems.org/gems/id-calendar-tui-clariant) and
+[GHCR](https://github.com/clariantb/id-calendar-tui/pkgs/container/id-calendar-tui).
+One-time setup is in [RELEASING.md](RELEASING.md).
+
+## Contributing
+
+Bug reports and pull requests are welcome.
+
+## License
+
+MIT License - see [LICENSE](LICENSE) file for details.

data/bin/calendar

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+
+require_relative '../lib/calendar_app'
+
+IndonesiaCalendar::CalendarApp.new.run

data/data/holidays.json

@@ -0,0 +1,422 @@
+{
+  "_comment": "Official SKB 3 Menteri holidays, imported by scripts/fetch_holidays.rb. Scheduled runs only add missing years; hand-added amendments are kept.",
+  "years": {
+    "2025": {
+      "sources": [
+        "https://setkab.go.id/pemerintah-tetapkan-hari-libur-nasional-dan-cuti-bersama-tahun-2025/",
+        "https://www.setneg.go.id/baca/index/sambut_hut_ke_80_kemerdekaan_ri_pemerintah_tetapkan_18_agustus_2025_sebagai_cuti_bersama"
+      ],
+      "holidays": [
+        {
+          "date": "2025-01-01",
+          "name": "Tahun Baru 2025 Masehi",
+          "type": "national"
+        },
+        {
+          "date": "2025-01-27",
+          "name": "Isra Mikraj Nabi Muhammad saw.",
+          "type": "religious"
+        },
+        {
+          "date": "2025-01-28",
+          "name": "Cuti Bersama Tahun Baru Imlek 2576 Kongzili",
+          "type": "cultural"
+        },
+        {
+          "date": "2025-01-29",
+          "name": "Tahun Baru Imlek 2576 Kongzili",
+          "type": "cultural"
+        },
+        {
+          "date": "2025-03-28",
+          "name": "Cuti Bersama Hari Suci Nyepi (Tahun Baru Saka 1947)",
+          "type": "religious"
+        },
+        {
+          "date": "2025-03-29",
+          "name": "Hari Suci Nyepi (Tahun Baru Saka 1947)",
+          "type": "religious"
+        },
+        {
+          "date": "2025-03-31",
+          "name": "Idulfitri 1446 Hijriah",
+          "type": "religious"
+        },
+        {
+          "date": "2025-04-01",
+          "name": "Idulfitri 1446 Hijriah",
+          "type": "religious"
+        },
+        {
+          "date": "2025-04-02",
+          "name": "Cuti Bersama Idulfitri 1446 Hijriah",
+          "type": "religious"
+        },
+        {
+          "date": "2025-04-03",
+          "name": "Cuti Bersama Idulfitri 1446 Hijriah",
+          "type": "religious"
+        },
+        {
+          "date": "2025-04-04",
+          "name": "Cuti Bersama Idulfitri 1446 Hijriah",
+          "type": "religious"
+        },
+        {
+          "date": "2025-04-07",
+          "name": "Cuti Bersama Idulfitri 1446 Hijriah",
+          "type": "religious"
+        },
+        {
+          "date": "2025-04-18",
+          "name": "Wafat Yesus Kristus",
+          "type": "religious"
+        },
+        {
+          "date": "2025-04-20",
+          "name": "Kebangkitan Yesus Kristus (Paskah)",
+          "type": "religious"
+        },
+        {
+          "date": "2025-05-01",
+          "name": "Hari Buruh Internasional",
+          "type": "national"
+        },
+        {
+          "date": "2025-05-12",
+          "name": "Hari Raya Waisak 2569 BE",
+          "type": "religious"
+        },
+        {
+          "date": "2025-05-13",
+          "name": "Cuti Bersama Hari Raya Waisak 2569 BE",
+          "type": "religious"
+        },
+        {
+          "date": "2025-05-29",
+          "name": "Kenaikan Yesus Kristus",
+          "type": "religious"
+        },
+        {
+          "date": "2025-05-30",
+          "name": "Cuti Bersama Kenaikan Yesus Kristus",
+          "type": "religious"
+        },
+        {
+          "date": "2025-06-01",
+          "name": "Hari Lahir Pancasila",
+          "type": "national"
+        },
+        {
+          "date": "2025-06-06",
+          "name": "Iduladha 1446 Hijriah",
+          "type": "religious"
+        },
+        {
+          "date": "2025-06-09",
+          "name": "Cuti Bersama Idul Adha 1446 Hijriah",
+          "type": "religious"
+        },
+        {
+          "date": "2025-06-27",
+          "name": "1 Muharam Tahun Baru Islam 1447 Hijriah",
+          "type": "religious"
+        },
+        {
+          "date": "2025-08-17",
+          "name": "Proklamasi Kemerdekaan",
+          "type": "national"
+        },
+        {
+          "date": "2025-08-18",
+          "name": "Cuti Bersama Proklamasi Kemerdekaan",
+          "type": "national"
+        },
+        {
+          "date": "2025-09-05",
+          "name": "Maulid Nabi Muhammad saw.",
+          "type": "religious"
+        },
+        {
+          "date": "2025-12-25",
+          "name": "Kelahiran Yesus Kristus",
+          "type": "religious"
+        },
+        {
+          "date": "2025-12-26",
+          "name": "Cuti Bersama Kelahiran Yesus Kristus",
+          "type": "religious"
+        }
+      ]
+    },
+    "2026": {
+      "sources": [
+        "https://www.setneg.go.id/baca/index/inilah_skb_3_menteri_libur_nasional_dan_cuti_bersama_2026"
+      ],
+      "holidays": [
+        {
+          "date": "2026-01-01",
+          "name": "Tahun Baru 2026 Masehi",
+          "type": "national"
+        },
+        {
+          "date": "2026-01-16",
+          "name": "Isra Mikraj Nabi Muhammad saw.",
+          "type": "religious"
+        },
+        {
+          "date": "2026-02-16",
+          "name": "Cuti Bersama Tahun Baru Imlek 2577 Kongzili",
+          "type": "cultural"
+        },
+        {
+          "date": "2026-02-17",
+          "name": "Tahun Baru Imlek 2577 Kongzili",
+          "type": "cultural"
+        },
+        {
+          "date": "2026-03-18",
+          "name": "Cuti Bersama Hari Suci Nyepi (Tahun Baru Saka 1948)",
+          "type": "religious"
+        },
+        {
+          "date": "2026-03-19",
+          "name": "Hari Suci Nyepi (Tahun Baru Saka 1948)",
+          "type": "religious"
+        },
+        {
+          "date": "2026-03-20",
+          "name": "Cuti Bersama Idulfitri 1447 H",
+          "type": "religious"
+        },
+        {
+          "date": "2026-03-21",
+          "name": "Idulfitri 1447 H",
+          "type": "religious"
+        },
+        {
+          "date": "2026-03-22",
+          "name": "Idulfitri 1447 H",
+          "type": "religious"
+        },
+        {
+          "date": "2026-03-23",
+          "name": "Cuti Bersama Idulfitri 1447 H",
+          "type": "religious"
+        },
+        {
+          "date": "2026-03-24",
+          "name": "Cuti Bersama Idulfitri 1447 H",
+          "type": "religious"
+        },
+        {
+          "date": "2026-04-03",
+          "name": "Wafat Yesus Kristus",
+          "type": "religious"
+        },
+        {
+          "date": "2026-04-05",
+          "name": "Kebangkitan Yesus Kristus (Paskah)",
+          "type": "religious"
+        },
+        {
+          "date": "2026-05-01",
+          "name": "Hari Buruh Internasional",
+          "type": "national"
+        },
+        {
+          "date": "2026-05-14",
+          "name": "Kenaikan Yesus Kristus",
+          "type": "religious"
+        },
+        {
+          "date": "2026-05-15",
+          "name": "Cuti Bersama Kenaikan Yesus Kristus",
+          "type": "religious"
+        },
+        {
+          "date": "2026-05-27",
+          "name": "Iduladha 1447 H",
+          "type": "religious"
+        },
+        {
+          "date": "2026-05-28",
+          "name": "Cuti Bersama Iduladha 1447 H",
+          "type": "religious"
+        },
+        {
+          "date": "2026-05-31",
+          "name": "Hari Raya Waisak 2570 BE",
+          "type": "religious"
+        },
+        {
+          "date": "2026-06-01",
+          "name": "Hari Lahir Pancasila",
+          "type": "national"
+        },
+        {
+          "date": "2026-06-16",
+          "name": "1 Muharam Tahun Baru Islam 1448 H",
+          "type": "religious"
+        },
+        {
+          "date": "2026-08-17",
+          "name": "Proklamasi Kemerdekaan",
+          "type": "national"
+        },
+        {
+          "date": "2026-08-25",
+          "name": "Maulid Nabi Muhammad saw.",
+          "type": "religious"
+        },
+        {
+          "date": "2026-12-24",
+          "name": "Cuti Bersama Kelahiran Yesus Kristus",
+          "type": "religious"
+        },
+        {
+          "date": "2026-12-25",
+          "name": "Kelahiran Yesus Kristus",
+          "type": "religious"
+        }
+      ]
+    },
+    "2027": {
+      "sources": [
+        "https://www.setneg.go.id/baca/index/inilah_skb_3_menteri_libur_nasional_dan_cuti_bersama_2027"
+      ],
+      "holidays": [
+        {
+          "date": "2027-01-01",
+          "name": "Tahun Baru 2027 Masehi",
+          "type": "national"
+        },
+        {
+          "date": "2027-01-05",
+          "name": "Isra Mikraj Nabi Muhammad saw.",
+          "type": "religious"
+        },
+        {
+          "date": "2027-02-05",
+          "name": "Cuti Bersama Tahun Baru Imlek 2578 Kongzili",
+          "type": "cultural"
+        },
+        {
+          "date": "2027-02-06",
+          "name": "Tahun Baru Imlek 2578 Kongzili",
+          "type": "cultural"
+        },
+        {
+          "date": "2027-03-08",
+          "name": "Hari Suci Nyepi (Tahun Baru Saka 1949)",
+          "type": "religious"
+        },
+        {
+          "date": "2027-03-09",
+          "name": "Cuti Bersama Hari Raya Idulfitri 1448 Hijriah",
+          "type": "religious"
+        },
+        {
+          "date": "2027-03-10",
+          "name": "Idulfitri 1448 Hijriah",
+          "type": "religious"
+        },
+        {
+          "date": "2027-03-11",
+          "name": "Idulfitri 1448 Hijriah",
+          "type": "religious"
+        },
+        {
+          "date": "2027-03-12",
+          "name": "Cuti Bersama Hari Raya Idulfitri 1448 Hijriah",
+          "type": "religious"
+        },
+        {
+          "date": "2027-03-15",
+          "name": "Cuti Bersama Hari Raya Idulfitri 1448 Hijriah",
+          "type": "religious"
+        },
+        {
+          "date": "2027-03-25",
+          "name": "Cuti Bersama Wafat Yesus Kristus",
+          "type": "religious"
+        },
+        {
+          "date": "2027-03-26",
+          "name": "Wafat Yesus Kristus",
+          "type": "religious"
+        },
+        {
+          "date": "2027-03-28",
+          "name": "Hari Kebangkitan Yesus Kristus (Paskah)",
+          "type": "religious"
+        },
+        {
+          "date": "2027-05-01",
+          "name": "Hari Buruh Internasional",
+          "type": "national"
+        },
+        {
+          "date": "2027-05-06",
+          "name": "Kenaikan Yesus Kristus",
+          "type": "religious"
+        },
+        {
+          "date": "2027-05-17",
+          "name": "Iduladha 1448 Hijriah",
+          "type": "religious"
+        },
+        {
+          "date": "2027-05-18",
+          "name": "Cuti Bersama Iduladha 1448 H",
+          "type": "religious"
+        },
+        {
+          "date": "2027-05-19",
+          "name": "Cuti Bersama Waisak 2571 BE",
+          "type": "religious"
+        },
+        {
+          "date": "2027-05-20",
+          "name": "Hari Raya Waisak 2571 BE",
+          "type": "religious"
+        },
+        {
+          "date": "2027-06-01",
+          "name": "Hari Lahir Pancasila",
+          "type": "national"
+        },
+        {
+          "date": "2027-06-06",
+          "name": "1 Muharam Tahun Baru Islam 1449 Hijriah",
+          "type": "religious"
+        },
+        {
+          "date": "2027-08-15",
+          "name": "Maulid Nabi Muhammad SAW",
+          "type": "religious"
+        },
+        {
+          "date": "2027-08-17",
+          "name": "Proklamasi Kemerdekaan",
+          "type": "national"
+        },
+        {
+          "date": "2027-12-24",
+          "name": "Cuti Bersama Kelahiran Yesus Kristus (Natal)",
+          "type": "religious"
+        },
+        {
+          "date": "2027-12-25",
+          "name": "Kelahiran Yesus Kristus (Natal)",
+          "type": "religious"
+        },
+        {
+          "date": "2027-12-26",
+          "name": "Isra Mikraj Nabi Muhammad saw.",
+          "type": "religious"
+        }
+      ]
+    }
+  }
+}

data/lib/calendar_app.rb

@@ -0,0 +1,447 @@
+require 'date'
+require 'pastel'
+require 'tty-cursor'
+
+require_relative 'holidays'
+
+module IndonesiaCalendar
+  class CalendarApp
+    MONTHS_ID = %w[
+      Januari Februari Maret April Mei Juni
+      Juli Agustus September Oktober November Desember
+    ].freeze
+
+    WEEKDAYS_ID = %w[Min Sen Sel Rab Kam Jum Sab].freeze
+
+    CELL_WIDTH = 4
+
+    attr_reader :view_date
+
+    def initialize
+      @pastel = Pastel.new
+      @view_date = Date.today
+      @running = true
+      @show_help = true
+      @mode = :calendar
+      @screen_width = 70
+      @cursor = TTY::Cursor
+      @needs_redraw = false
+    end
+
+    def run
+      setup_terminal
+      render
+      main_loop
+    ensure
+      cleanup_terminal
+      puts
+      puts @pastel.green('Terima kasih telah menggunakan Kalender Indonesia!')
+    end
+
+    private
+
+    def windows?
+      RUBY_PLATFORM =~ /mswin|mingw|cygwin/
+    end
+
+    def setup_terminal
+      @cursor.hide
+      print "\e[?1049h"
+      print "\e[?25l"  # Hide cursor using escape sequence
+
+      if windows?
+        setup_windows_terminal
+      else
+        @original_stty = `stty -g 2>/dev/null`.chomp
+        system('stty cbreak -echo min 1 time 0 2>/dev/null') || system('stty -icanon -echo min 1 time 0 2>/dev/null')
+      end
+      $stdout.flush
+    end
+
+    def setup_windows_terminal
+      require 'io/console'
+      require 'win32api'
+
+      # Get the Windows console handle
+      kernel32 = Win32API.new('kernel32', 'GetStdHandle', ['L'], 'L')
+      @stdout_handle = kernel32.call(-11)  # STD_OUTPUT_HANDLE = -11
+      @stdin_handle = kernel32.call(-10)   # STD_INPUT_HANDLE = -10
+
+      # Save and set console input mode
+      get_mode = Win32API.new('kernel32', 'GetConsoleMode', %w[L P], 'I')
+      set_mode = Win32API.new('kernel32', 'SetConsoleMode', %w[L L], 'I')
+
+      mode_buf = [0].pack('L')
+      get_mode.call(@stdin_handle, mode_buf)
+      @original_console_mode = mode_buf.unpack1('L')
+
+      # Enable window input, disable line input and echo
+      new_mode = 0x0080 | 0x0008 # ENABLE_WINDOW_INPUT | ENABLE_PROCESSED_INPUT
+      set_mode.call(@stdin_handle, new_mode)
+
+      # Set output mode for virtual terminal processing
+      get_mode.call(@stdout_handle, mode_buf)
+      @original_stdout_mode = mode_buf.unpack1('L')
+      set_mode.call(@stdout_handle, @original_stdout_mode | 0x0004) # ENABLE_VIRTUAL_TERMINAL_PROCESSING
+    rescue LoadError
+      # Fall back to basic mode
+    end
+
+    def cleanup_terminal
+      if windows?
+        cleanup_windows_terminal
+      elsif @original_stty && !@original_stty.empty?
+        system("stty #{@original_stty} 2>/dev/null")
+      end
+      print "\e[?25h" # Show cursor using escape sequence
+      @cursor.show
+      print "\e[?1049l"
+      $stdout.flush
+    end
+
+    def cleanup_windows_terminal
+      if @stdin_handle && @original_console_mode
+        set_mode = Win32API.new('kernel32', 'SetConsoleMode', %w[L L], 'I')
+        set_mode.call(@stdin_handle, @original_console_mode)
+      end
+      if @stdout_handle && @original_stdout_mode
+        set_mode = Win32API.new('kernel32', 'SetConsoleMode', %w[L L], 'I')
+        set_mode.call(@stdout_handle, @original_stdout_mode)
+      end
+    rescue StandardError
+      # Ignore errors during cleanup
+    end
+
+    def get_terminal_size
+      if windows?
+        get_windows_terminal_size
+      else
+        height, width = `stty size`.split.map(&:to_i)
+        [height, width]
+      end
+    rescue StandardError
+      [24, 80] # Default fallback
+    end
+
+    def get_windows_terminal_size
+      require 'io/console'
+      $stdout.winsize
+    rescue StandardError
+      [24, 80]
+    end
+
+    def main_loop
+      while @running
+        changed = handle_input
+        render if changed || @needs_redraw
+        @needs_redraw = false
+      end
+    end
+
+    def render
+      terminal_height, terminal_width = get_terminal_size
+
+      # Calculate vertical centering - position in upper third of screen
+      ui_height = 15 # Smaller value = higher on screen
+      top_padding = [(terminal_height - ui_height) / 3, 0].max
+
+      # Calculate horizontal centering
+      left_padding = [(terminal_width - @screen_width) / 2, 0].max
+
+      print "\e[2J"  # Clear entire screen
+      print "\e[H"   # Move to home position
+
+      # Move cursor to calculated vertical position
+      print "\e[#{top_padding}H" if top_padding > 0
+
+      # Render each component centered
+      title = render_title
+      calendar = render_calendar
+      holiday_panel = render_holiday_panel
+      status_bar = render_status_bar
+
+      all_content = [title, calendar, holiday_panel, status_bar].join("\n")
+
+      # Add left padding to each line
+      centered_lines = all_content.split("\n").map do |line|
+        ' ' * left_padding + line
+      end
+
+      print centered_lines.join("\n")
+      $stdout.flush
+    end
+
+    def render_title
+      title_text = 'KALENDER INDONESIA'
+      date_text = "#{MONTHS_ID[@view_date.month - 1]} #{@view_date.year}"
+      today_text = "Hari Ini: #{Date.today.day} #{MONTHS_ID[Date.today.month - 1]} #{Date.today.year}"
+
+      lines = []
+      lines << @pastel.cyan("┌#{'─' * (@screen_width - 2)}┐")
+      lines << @pastel.cyan('│') + (' ' * (@screen_width - 2)) + @pastel.cyan('│')
+      lines << @pastel.cyan('│') + center_text(@pastel.bold.yellow("★ #{title_text} ★"),
+                                               @screen_width - 2) + @pastel.cyan('│')
+      lines << @pastel.cyan('│') + center_text(@pastel.white(date_text), @screen_width - 2) + @pastel.cyan('│')
+      lines << @pastel.cyan('│') + center_text(@pastel.bright_black(today_text), @screen_width - 2) + @pastel.cyan('│')
+      lines << @pastel.cyan('│') + (' ' * (@screen_width - 2)) + @pastel.cyan('│')
+      lines << @pastel.cyan("└#{'─' * (@screen_width - 2)}┘")
+
+      lines.join("\n")
+    end
+
+    def render_calendar
+      month_holidays = IndonesiaCalendar::Holidays.holidays_for_month(@view_date.year, @view_date.month)
+
+      first_day = Date.new(@view_date.year, @view_date.month, 1)
+      last_day = Date.new(@view_date.year, @view_date.month, -1)
+      days_in_month = last_day.day
+      start_wday = first_day.wday
+
+      lines = []
+
+      # Calendar content width should match screen width minus borders
+      content_width = @screen_width - 4 # │ space ... space │
+      calendar_grid_width = CELL_WIDTH * 7 + 6 # 7 cells + 6 spaces between
+      calendar_padding = (content_width - calendar_grid_width) / 2
+
+      title = " #{MONTHS_ID[@view_date.month - 1]} #{@view_date.year} "
+      lines << @pastel.cyan("┌─#{title}#{'─' * (@screen_width - 3 - title.length)}┐")
+      lines << @pastel.cyan('│') + (' ' * (@screen_width - 2)) + @pastel.cyan('│')
+
+      header = WEEKDAYS_ID.each_with_index.map do |d, i|
+        if [0, 6].include?(i)
+          @pastel.red(d.center(CELL_WIDTH))
+        else
+          @pastel.yellow(d.center(CELL_WIDTH))
+        end
+      end.join(' ')
+
+      header_visible = header.gsub(/\e\[[0-9;]*m/, '')
+      # Center the header in the content area
+      lines << @pastel.cyan("│ #{' ' * calendar_padding}#{header}#{' ' * (content_width - calendar_padding - header_visible.length)} │")
+      lines << @pastel.cyan("│ #{' ' * calendar_padding}#{'─' * calendar_grid_width}#{' ' * (content_width - calendar_padding - calendar_grid_width)} │")
+
+      current_line = Array.new(start_wday) { ' ' * CELL_WIDTH }
+
+      (1..days_in_month).each do |day|
+        current_date = Date.new(@view_date.year, @view_date.month, day)
+        day_str = format_day_cell(current_date, day, month_holidays)
+        current_line << day_str
+
+        next unless current_line.length == 7
+
+        line_content = current_line.join(' ')
+        line_visible = line_content.gsub(/\e\[[0-9;]*m/, '')
+        lines << @pastel.cyan("│ #{' ' * calendar_padding}#{line_content}#{' ' * (content_width - calendar_padding - line_visible.length)} │")
+        current_line = []
+      end
+
+      unless current_line.empty?
+        current_line += Array.new(7 - current_line.length, ' ' * CELL_WIDTH)
+        line_content = current_line.join(' ')
+        line_visible = line_content.gsub(/\e\[[0-9;]*m/, '')
+        lines << @pastel.cyan("│ #{' ' * calendar_padding}#{line_content}#{' ' * (content_width - calendar_padding - line_visible.length)} │")
+      end
+
+      weeks_count = ((days_in_month + start_wday) / 7.0).ceil
+      (5 - weeks_count).times do
+        lines << @pastel.cyan("│ #{' ' * calendar_padding}#{' ' * calendar_grid_width}#{' ' * (content_width - calendar_padding - calendar_grid_width)} │")
+      end
+
+      lines << @pastel.cyan('│') + (' ' * (@screen_width - 2)) + @pastel.cyan('│')
+      lines << @pastel.cyan("└#{'─' * (@screen_width - 2)}┘")
+
+      lines.join("\n")
+    end
+
+    def format_day_cell(date, day, month_holidays)
+      day_num = day.to_s.rjust(2)
+      is_holiday = month_holidays.key?(date)
+      is_today = date == Date.today
+      is_weekend = date.wday == 0 || date.wday == 6
+
+      if is_today
+        @pastel.on_green.black(" #{day_num} ")
+      elsif is_holiday
+        @pastel.red(" #{day_num}*")
+      elsif is_weekend
+        @pastel.bright_black(" #{day_num} ")
+      else
+        @pastel.white(" #{day_num} ")
+      end
+    end
+
+    def render_holiday_panel
+      month_holidays = IndonesiaCalendar::Holidays.holidays_for_month(@view_date.year, @view_date.month)
+
+      lines = []
+      lines << @pastel.yellow("┌─ Hari Libur #{'─' * (@screen_width - 15)}┐")
+      lines << @pastel.yellow('│') + (' ' * (@screen_width - 2)) + @pastel.yellow('│')
+
+      if !IndonesiaCalendar::Holidays.announced?(@view_date.year)
+        unknown_year_notice(@view_date.year).each do |text|
+          lines << @pastel.yellow('│') + @pastel.bright_black(text.ljust(@screen_width - 2)) + @pastel.yellow('│')
+        end
+      elsif month_holidays.empty?
+        text = '  Tidak ada hari libur bulan ini'
+        lines << @pastel.yellow('│') + text.ljust(@screen_width - 2) + @pastel.yellow('│')
+      else
+        month_holidays.each do |date, holiday|
+          type = format_holiday_type(holiday[:type])
+          type_visible = type.gsub(/\e\[[0-9;]*m/, '')
+
+          # Truncate long official names (e.g. "Cuti Bersama ...") so the panel
+          # border stays aligned and the padding below can never go negative.
+          fixed_width = 4 + 2 + 2 + 1 + type_visible.length # "    " + day + ". " + " " + type
+          name_budget = [@screen_width - 2 - fixed_width, 1].max
+          name_text = holiday[:name]
+          name_text = "#{name_text[0, name_budget - 1]}…" if name_text.length > name_budget
+
+          day_str = @pastel.cyan(date.day.to_s.rjust(2))
+          name = @pastel.white(name_text)
+
+          line = "    #{day_str}. #{name} #{type}"
+          line_visible = line.gsub(/\e\[[0-9;]*m/, '')
+          lines << @pastel.yellow('│') + line + ' ' * [@screen_width - 2 - line_visible.length, 0].max + @pastel.yellow('│')
+        end
+      end
+
+      lines << @pastel.yellow("│#{' ' * (@screen_width - 2)}│")
+      lines << @pastel.yellow("└#{'─' * (@screen_width - 2)}┘")
+
+      lines.join("\n")
+    end
+
+    def unknown_year_notice(year)
+      latest = IndonesiaCalendar::Holidays.latest_announced_year
+      if latest.nil? || year > latest
+        ["  Hari libur #{year} belum diumumkan pemerintah.",
+         '  Menunggu SKB 3 Menteri tentang libur nasional dan cuti bersama.']
+      else
+        ["  Data hari libur #{year} tidak tersedia."]
+      end
+    end
+
+    def format_holiday_type(type)
+      case type
+      when :national
+        @pastel.red('[Nasional]')
+      when :religious
+        @pastel.magenta('[Keagamaan]')
+      when :cultural
+        @pastel.cyan('[Budaya]')
+      else
+        ''
+      end
+    end
+
+    def render_status_bar
+      lines = []
+
+      help_items = [
+        "#{@pastel.bright_black('h')} #{@pastel.bright_black('Bulan')}#{@pastel.bright_black(' -')}",
+        "#{@pastel.bright_black('l')} #{@pastel.bright_black('Bulan')}#{@pastel.bright_black(' +')}",
+        "#{@pastel.bright_black('j')} #{@pastel.bright_black('Tahun')}#{@pastel.bright_black(' -')}",
+        "#{@pastel.bright_black('k')} #{@pastel.bright_black('Tahun')}#{@pastel.bright_black(' +')}",
+        "#{@pastel.bright_black('g')} #{@pastel.bright_black('Today')}",
+        "#{@pastel.bright_black('q')} #{@pastel.bright_black('Keluar')}"
+      ]
+
+      help_text = help_items.join('  ')
+      help_visible = help_text.gsub(/\e\[[0-9;]*m/, '')
+      content_width = @screen_width - 4 # │ space ... space │
+      help_padding = (content_width - help_visible.length) / 2
+      help_line = " #{' ' * help_padding}#{help_text}#{' ' * (content_width - help_visible.length - help_padding)} "
+
+      lines << ''
+      lines << " #{help_line} "
+
+      lines.join("\n")
+    end
+
+    def handle_input
+      changed = false
+      begin
+        key = read_char
+        return false if key.nil?
+
+        if key == "\e"
+          c2 = read_char
+          return false if c2.nil?
+
+          if c2 == '['
+            c3 = read_char
+            case c3
+            when 'C'
+              @view_date = @view_date >> 1
+              changed = true
+            when 'D'
+              @view_date = @view_date << 1
+              changed = true
+            end
+          end
+          return changed
+        end
+
+        case key
+        when 'q', 'Q', "\u0003"
+          @running = false
+        when 'h', 'H'
+          @view_date = @view_date << 1
+          changed = true
+        when 'l', 'L'
+          @view_date = @view_date >> 1
+          changed = true
+        when 'j', 'J'
+          @view_date = Date.new(@view_date.year - 1, @view_date.month, 1)
+          changed = true
+        when 'k', 'K'
+          @view_date = Date.new(@view_date.year + 1, @view_date.month, 1)
+          changed = true
+        when 'g'
+          @view_date = Date.today
+          changed = true
+        end
+      rescue IOError, Errno::EIO
+        @running = false
+      rescue StandardError => e
+        # Ignore errors
+      end
+      changed
+    end
+
+    def read_char
+      if windows?
+        read_char_windows
+      else
+        read_char_unix
+      end
+    end
+
+    def read_char_windows
+      require 'io/console'
+      # On Windows, use console API for proper key reading
+      begin
+        # Use IO#raw if available (Ruby 2.4+)
+        $stdin.raw do
+          return $stdin.getch
+        end
+      rescue StandardError
+        # Fallback for older Ruby versions
+        $stdin.getch
+      end
+    end
+
+    def read_char_unix
+      $stdin.getc
+    end
+
+    def center_text(text, width)
+      visible_width = text.gsub(/\e\[[0-9;]*m/, '').length
+      total_padding = [(width - visible_width), 0].max
+      left_padding = total_padding / 2
+      right_padding = total_padding - left_padding
+      ' ' * left_padding + text + ' ' * right_padding
+    end
+  end
+end

data/lib/holidays.rb

@@ -0,0 +1,46 @@
+require 'date'
+require 'json'
+
+module IndonesiaCalendar
+  module Holidays
+    DATA_FILE = File.expand_path('../data/holidays.json', __dir__)
+
+    TYPE_SYMBOLS = { 'national' => :national, 'religious' => :religious, 'cultural' => :cultural }.freeze
+
+    # Loaded once and memoized: { year(Integer) => { Date => { name:, type: } } }
+    # Only years whose SKB 3 Menteri has been imported are present; nothing is
+    # guessed for other years, because most holidays follow lunar calendars and
+    # cuti bersama is a yearly government decision.
+    def self.data
+      @data ||= load_data
+    end
+
+    def self.load_data
+      raw = JSON.parse(File.read(DATA_FILE))
+      (raw['years'] || {}).each_with_object({}) do |(year_str, record), result|
+        days = {}
+        record['holidays'].each do |entry|
+          date = Date.parse(entry['date'])
+          days[date] ||= { name: entry['name'], type: TYPE_SYMBOLS.fetch(entry['type'], :national) }
+        end
+        result[year_str.to_i] = days.sort.to_h
+      end
+    rescue JSON::ParserError, ArgumentError, NoMethodError => e
+      # The file is hand-edited for amendments; a broken edit must be loud, not
+      # silently turn every year into "belum diumumkan".
+      raise "#{DATA_FILE} is invalid (#{e.class}: #{e.message})"
+    end
+
+    def self.announced?(year)
+      data.key?(year)
+    end
+
+    def self.latest_announced_year
+      data.keys.max
+    end
+
+    def self.holidays_for_month(year, month)
+      data.fetch(year, {}).select { |date, _| date.month == month }
+    end
+  end
+end

metadata

@@ -0,0 +1,74 @@
+--- !ruby/object:Gem::Specification
+name: id-calendar-tui-clariant
+version: !ruby/object:Gem::Version
+  version: 0.1.3
+platform: ruby
+authors:
+- clariantb
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: pastel
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+- !ruby/object:Gem::Dependency
+  name: tty-cursor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+description: A TUI calendar application displaying Indonesian public holidays and
+  cuti bersama from the official SKB 3 Menteri announcements, with vim-like navigation
+executables:
+- calendar
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- bin/calendar
+- data/holidays.json
+- lib/calendar_app.rb
+- lib/holidays.rb
+homepage: https://github.com/clariantb/id-calendar-tui
+licenses:
+- MIT
+metadata: {}
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.6.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: Terminal-based Indonesian calendar with official holiday data
+test_files: []