sscharter 0.7.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1695717274c0888590e92f6a3dabf86fca4a2d34aaad9f17dc9a88ab20311207
-  data.tar.gz: 78096695809b63551d5f48a3c11d4120ead84157c1146b4064a9f8f1262b66c7
+  metadata.gz: 77116185ddcbeeeff551d0584bc35b8a10da9f0d7fcbae95a520b95909c355dd
+  data.tar.gz: 5594955220d37210bf710314b379e88d8a23a5a5174291c7d06c91cf25e37dee
 SHA512:
-  metadata.gz: 8e64530c4c426710eae970e9bd7fd4609d307a75102cdea4920f9ed5ae8208313cc48efae86c545b95cdecaec79e6da6738d92d5db1f8861ea142b3f2b843c88
-  data.tar.gz: 64725aa5bf3336f3ab3965f583cf4ed80e02296a18a1be9c1427542d9bc79164b602f99b19a2c7f45e243d32e8456911940971ffd3794e8027ec6e4db17d5221
+  metadata.gz: b67bc6805cf36ab1d69c4b85bbe0dce05d0db8b794caa6c8cc0cc8a7f2f28bb5c840688122527f2e2b44190740756020d4308a0ba0ca3bfbec570108cdf0a108
+  data.tar.gz: 6523d03c7b22171f37829136a21e4a378947eed410dd9f22c825046c6ffdb71269392d65f6b6621cb7c43521e994a8b6fc1d11351d9141432898fd12e61e5dc9

data/Gemfile

@@ -2,17 +2,4 @@
 
 source "https://rubygems.org"
 
-# Specify your gem's dependencies in sscharter.gemspec
 gemspec
-
-group :develop do
-	gem 'rake', '~> 13.0'
-	gem 'minitest', '~> 5.0'
-end
-
-gem 'rubyzip', '~> 2.3'
-gem 'launchy', '~> 2.5'
-gem 'webrick', '~> 1.8'
-gem 'filewatcher', '~> 2.0'
-gem 'em-websocket', '~> 0.5'
-gem 'concurrent-ruby', '~> 1.3'

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    sscharter (0.7.0)
+    sscharter (0.8.0)
       concurrent-ruby (~> 1.3)
       em-websocket (~> 0.5)
       filewatcher (~> 2.0)
@@ -24,27 +24,23 @@ GEM
     http_parser.rb (0.8.0)
     launchy (2.5.2)
       addressable (~> 2.8)
-    minitest (5.25.1)
+    minitest (5.25.4)
     module_methods (0.1.0)
     public_suffix (6.0.1)
     rake (13.2.1)
-    rubyzip (2.3.2)
-    webrick (1.8.1)
+    rubyzip (2.4.1)
+    webrick (1.9.1)
+    yard (0.9.37)
 
 PLATFORMS
   x64-mingw-ucrt
   x86_64-linux
 
 DEPENDENCIES
-  concurrent-ruby (~> 1.3)
-  em-websocket (~> 0.5)
-  filewatcher (~> 2.0)
-  launchy (~> 2.5)
   minitest (~> 5.0)
   rake (~> 13.0)
-  rubyzip (~> 2.3)
   sscharter!
-  webrick (~> 1.8)
+  yard (~> 0.9)
 
 BUNDLED WITH
-   2.5.17
+   2.6.2

data/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2023 sunniesnow
+Copyright (c) 2025 sunniesnow
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -1,4 +1,4 @@
-# Sscharter
+# sscharter
 
 A Ruby DSL for writing Sunniesnow charts.
 
@@ -7,7 +7,7 @@ A Ruby DSL for writing Sunniesnow charts.
 [Install Ruby](https://www.ruby-lang.org/en/documentation/installation/).
 Then, run
 
-```shell
+```
 gem install sscharter
 ```
 
@@ -27,4 +27,4 @@ Bug reports and pull requests are welcome on GitHub at https://github.com/sunnie
 
 ## Code of Conduct
 
-Everyone interacting in the Sscharter project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/sscharter/blob/master/CODE_OF_CONDUCT.md).
+Everyone interacting in the sscharter project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/sunniesnow/sscharter/blob/master/CODE_OF_CONDUCT.md).

data/Rakefile

@@ -1,12 +1,18 @@
 # frozen_string_literal: true
 
-require "bundler/gem_tasks"
-require "rake/testtask"
+require 'bundler/gem_tasks'
+require 'rake/testtask'
+require 'yard'
 
-Rake::TestTask.new(:test) do |t|
-  t.libs << "test"
-  t.libs << "lib"
-  t.test_files = FileList["test/**/test_*.rb"]
+Rake::TestTask.new :test do |t|
+	t.libs << 'test'
+	t.libs << 'lib'
+	t.test_files = FileList['test/**/test_*.rb']
+end
+
+YARD::Rake::YardocTask.new do |t|
+	t.files.concat %w[README.md]
+	t.options.concat %w[--title sscharter --output-dir doc --exclude lib/sscharter/cli.rb --readme]
 end
 
 task default: :test

data/lib/sscharter/chart.rb

@@ -2,14 +2,41 @@
 
 require 'json'
 
+# A class to represent a chart.
+# Basically a wrapper around the metadata and events ({Sunniesnow::Event}) of a chart.
+# The main method is {#to_json}, which converts the chart to a JSON string
+# that is actually recognizable by Sunniesnow.
 class Sunniesnow::Chart
 
 	using Sunniesnow::Utils
 
-	attr_accessor :title, :artist, :charter
-	attr_accessor :difficulty_name, :difficulty_color, :difficulty, :difficulty_sup
+	# The schema URL for the output JSON.
+	# This will be set as the `$schema` property in the generated JSON.
+	SCHEMA = 'https://sunniesnow.github.io/schema/chart-1.0.json'
+
+	# The title of the music.
+	# This is one of the metadata of the chart which will be reflected in the generated JSON.
+	# Also, see
+	# {chart file specifications}[https://sunniesnow.github.io/doc/chart.html#title]
+	# for more info.
+	attr_accessor :title
+	
+	attr_accessor :artist
+	attr_accessor :charter
+	attr_accessor :difficulty_name
+	attr_accessor :difficulty_color
+	attr_accessor :difficulty
+	attr_accessor :difficulty_sup
+
+	# An array of Sunniesnow::Event.
 	attr_reader :events
 
+	# @param [Integer] live_reload_port The port to use for live reload.
+	#   It is useless if +production+ is +true+.
+	# @param [Boolean] production Whether the chart is in production or not.
+	#   If +true+, the generated JSON (see {#to_json}) will not contain
+	#   necessary information for sscharter integration in Sunniesnow
+	#   (such as the live reload feature and reverse search feature).
 	def initialize live_reload_port: 31108, production: false
 		@title = ''
 		@artist = ''
@@ -23,8 +50,13 @@ class Sunniesnow::Chart
 		@production = production
 	end
 
+	##
+	# Convert to JSON.
+	# A Sunniesnow chart is always a JSON file in the level file.
+	# This method is used to generate that JSON file.
 	def to_json *args
 		hash = {
+			'$schema': SCHEMA,
 			title: @title,
 			artist: @artist,
 			charter: @charter,

data/lib/sscharter/cli.rb

@@ -22,13 +22,12 @@ module Sunniesnow
 			module_function
 
 			def config
-				config_filename = File.join PROJECT_DIR, '.sscharter.yml'
-				config_filename = File.join PROJECT_DIR, '.sscharter.yaml' unless File.exist? config_filename
-				unless File.exist? config_filename
-					puts 'No .sscharter.yml found'
+				filenames = %w[sscharter.yml sscharter.yaml .sscharter.yml .sscharter.yaml].map { File.join PROJECT_DIR, _1 }
+				unless filename = filenames.find { File.exist? _1 }
+					$stderr.puts 'Config file sscharter.yml not found'
 					return nil
 				end
-				YAML.load_file config_filename, symbolize_names: true
+				YAML.load_file filename, symbolize_names: true
 			end
 
 			singleton_class.attr_reader :commands
@@ -87,20 +86,18 @@ Sunniesnow::Charter::CLI::Subcommand.new :init, option_parser do |project_dir =
 	FileUtils.cp_r files, files_dir
 	FileUtils.cd project_dir do
 		File.write 'Gemfile', <<~GEMFILE
-			# frozen_string_literal: true
 			source 'https://rubygems.org'
 			gem 'sscharter', '~> #{Sunniesnow::Charter::VERSION}'
 			gem 'rake', '~> #{Rake::VERSION}'
 			gem 'bundler', '~> #{Bundler::VERSION}'
 		GEMFILE
 		File.write 'Rakefile', <<~RAKEFILE
-			# frozen_string_literal: true
 			task default: :build
 			task :build do
 				exec 'bundle exec sscharter build'
 			end
 			task :serve do
-				exec 'bundle exec sscharter serve'
+				exec 'bundle exec sscharter serve --no-open-browser'
 			end
 		RAKEFILE
 		File.write '.gitignore', <<~GITIGNORE
@@ -108,7 +105,7 @@ Sunniesnow::Charter::CLI::Subcommand.new :init, option_parser do |project_dir =
 			/tmp/
 			/build/
 		GITIGNORE
-		File.write '.sscharter.yml', <<~SSCHARTER
+		File.write 'sscharter.yml', <<~SSCHARTER
 			---
 			project_name: #{File.basename project_dir}
 			build_dir: build
@@ -136,21 +133,19 @@ Sunniesnow::Charter::CLI::Subcommand.new :init, option_parser do |project_dir =
 		README
 		FileUtils.mkdir_p 'src'
 		File.write 'src/master.rb', <<~CHART
-			# frozen_string_literal: true
-
 			Sunniesnow::Charter.open 'master' do
 
 			title 'The title of the music'
 			artist 'The artist of the music'
 			charter 'Your name'
 			difficulty_name 'Master'
-			difficulty_color '#8c68f3'
+			difficulty_color :master
 			difficulty '12'
 
 			offset 0
 			bpm 120
 
-			tp_chain 0, 0, 1 do
+			tp_chain 0, 100, 1 do
 				t -50, 0, 'hello'
 				b 1 # proceed by 1 beat
 				t 50, 0, 'world'

data/lib/sscharter/version.rb

@@ -2,6 +2,6 @@
 
 module Sunniesnow
 	class Charter
-		VERSION = "0.7.0"
+		VERSION = "0.8.0"
 	end
 end

data/lib/sscharter.rb

@@ -30,6 +30,8 @@ class Sunniesnow::Charter
 	class BpmChangeList
 
 		class BpmChange
+			include Comparable
+
 			attr_accessor :beat, :bps
 
 			def initialize beat, bpm
@@ -51,6 +53,8 @@ class Sunniesnow::Charter
 
 		def add beat, bpm
 			@list.push BpmChange.new beat, bpm
+			@list.sort!
+			self
 		end
 
 		def time_at beat
@@ -286,16 +290,6 @@ class Sunniesnow::Charter
 	}.freeze
 
 	DIRECTIONS = {
-		right: 0.0,
-		up_right: Math::PI / 4,
-		up: Math::PI / 2,
-		up_left: Math::PI * 3 / 4,
-		left: Math::PI,
-		down_left: -Math::PI * 3 / 4,
-		down: -Math::PI / 2,
-		down_right: -Math::PI / 4
-	}
-	{
 		right: %i[r],
 		up_right: %i[ur ru],
 		up: %i[u],
@@ -304,22 +298,60 @@ class Sunniesnow::Charter
 		down_left: %i[dl ld],
 		down: %i[d],
 		down_right: %i[dr rd]
-	}.each do |direction_name, aliases|
-		aliases.each { DIRECTIONS[_1] = DIRECTIONS[direction_name] }
-	end
+	}.each_with_object({
+		right: 0.0,
+		up_right: Math::PI / 4,
+		up: Math::PI / 2,
+		up_left: Math::PI * 3 / 4,
+		left: Math::PI,
+		down_left: -Math::PI * 3 / 4,
+		down: -Math::PI / 2,
+		down_right: -Math::PI / 4
+	}) do |(direction_name, aliases), directions|
+		aliases.each { directions[_1] = directions[direction_name] }
+	end.freeze
+	
 	DIRECTIONS.freeze
 
-	singleton_class.attr_reader :charts
+	class << self
+		# A hash containing all the charts opened by {::open}.
+		# The keys are the names of the charts, and the values are the {Sunniesnow::Charter} objects.
+		# @return [Hash<String, Sunniesnow::Charter>]
+		attr_reader :charts
+	end
 	@charts = {}
 
+	# An array of events.
+	# @return [Array<Sunniesnow::Charter::Event>]
 	attr_reader :events
 
+	# Create a new chart or open an existing chart for editing.
+	# The +name+ is used to check whether the chart already exists.
+	# If a new chart needs to be created, it is added to {.charts}.
+	#
+	# The given +block+ will be evaluated in the context of the chart
+	# (inside the block, +self+ is the same as the return value, a {Charter} instance).
+	# This method is intended to be called at the top level of a Ruby script
+	# to open a context for writing a Sunniesnow chart using the DSL.
+	#
+	# In the examples in the documentation of other methods,
+	# it is assumed that they are run inside a block passed to this method.
+	#
+	# @param name [String] the name of the chart.
+	# @return [Sunniesnow::Charter] the chart.
+	# @example
+	#   Sunniesnow::Charter.open 'master' do
+	#     # write the chart here
+	#   end
 	def self.open name, &block
 		result = @charts[name] ||= new name
 		result.instance_eval &block if block
 		result
 	end
 
+	# Create a new chart.
+	# Usually you should use {.open} instead of this method.
+	# @param name [String] the name of the chart.
 	def initialize name
 		@name = name
 		init_chart_info
@@ -350,30 +382,192 @@ class Sunniesnow::Charter
 		@current_tip_point_group_stack = []
 		@tip_point_peak = 0
 		@current_duplicate = 0
+		@tip_point_start_stack = [nil]
 		@tip_point_start_to_add_stack = [nil]
 		@groups = [@events]
 	end
 
+	def to_sunniesnow **opts
+		result = Sunniesnow::Chart.new **opts
+		result.title = @title
+		result.artist = @artist
+		result.charter = @charter
+		result.difficulty_name = @difficulty_name
+		result.difficulty_color = @difficulty_color
+		result.difficulty = @difficulty
+		result.difficulty_sup = @difficulty_sup
+		@events.each { result.events.push _1.to_sunniesnow }
+		result
+	end
+
+	def output_json **opts
+		to_sunniesnow(**opts).to_json
+	end
+
+	def inspect
+		"#<Sunniesnow::Charter #@name>"
+	end
+
+	def time_at beat = @current_beat
+		raise OffsetError.new __method__ unless @bpm_changes
+		@bpm_changes.time_at beat
+	end
+
+	def backup_beat
+		{current_beat: @current_beat, bpm_changes: @bpm_changes}
+	end
+
+	def restore_beat backup
+		@current_beat = backup[:current_beat]
+		@bpm_changes = backup[:bpm_changes]
+	end
+
+	def backup_state
+		{
+			current_beat: @current_beat,
+			bpm_changes: @bpm_changes,
+			tip_point_mode_stack: @tip_point_mode_stack.dup,
+			current_tip_point_stack: @current_tip_point_stack.dup,
+			current_tip_point_group_stack: @current_tip_point_group_stack.dup,
+			current_duplicate: @current_duplicate,
+			tip_point_start_stack: @tip_point_start_stack.dup,
+			tip_point_start_to_add_stack: @tip_point_start_to_add_stack.dup,
+			groups: @groups.dup
+		}
+	end
+
+	def restore_state backup
+		@current_beat = backup[:current_beat]
+		@bpm_changes = backup[:bpm_changes]
+		@tip_point_mode_stack = backup[:tip_point_mode_stack]
+		@current_tip_point_stack = backup[:current_tip_point_stack]
+		@current_tip_point_group_stack = backup[:current_tip_point_group_stack]
+		@current_duplicate = backup[:current_duplicate]
+		@tip_point_start_to_add_stack = backup[:tip_point_start_to_add_stack]
+		@groups = backup[:groups]
+		nil
+	end
+
+	def event type, duration_beats = nil, **properties
+		raise OffsetError.new __method__ unless @bpm_changes
+		event = Event.new type, @current_beat, duration_beats, @bpm_changes, **properties
+		@groups.each { _1.push event }
+		return event unless event.tip_pointable?
+		case @tip_point_mode_stack.last
+		when :chain
+			if @tip_point_start_to_add_stack.last
+				@current_tip_point_stack[-1] = @tip_point_peak
+				@tip_point_peak += 1
+			end
+			push_tip_point_start event
+			@tip_point_start_to_add_stack[-1] = nil
+		when :drop
+			@current_tip_point_stack[-1] = @tip_point_peak
+			@tip_point_peak += 1
+			push_tip_point_start event
+		when :none
+			# pass
+		end
+		event
+	end
+
+	def push_tip_point_start start_event
+		start_event[:tip_point] = @current_tip_point_stack.last.to_s
+		tip_point_start = @tip_point_start_to_add_stack.last&.get_start_placeholder start_event
+		return unless tip_point_start
+		@groups.each do |group|
+			group.push tip_point_start
+			break if group.equal?(@current_tip_point_group_stack.last) && @tip_point_mode_stack.last != :drop
+		end
+	end
+
+	def tip_point mode, *args, preserve_beat: true, **opts, &block
+		@tip_point_mode_stack.push mode
+		if mode == :none
+			@tip_point_start_stack.push nil
+			@tip_point_start_to_add_stack.push nil
+			@current_tip_point_stack.push nil
+		else
+			if args.empty? && opts.empty?
+				unless @tip_point_start_stack.last
+					raise TipPointError, 'cannot omit tip point arguments at top level or inside tip_point_none'
+				end
+				@tip_point_start_stack.push @tip_point_start_stack.last.dup
+			else
+				@tip_point_start_stack.push TipPointStart.new *args, **opts
+			end
+			@tip_point_start_to_add_stack.push @tip_point_start_stack.last
+			@current_tip_point_stack.push nil
+		end
+		result = group preserve_beat: do
+			@current_tip_point_group_stack.push @groups.last
+			instance_eval &block
+		end
+		@tip_point_start_stack.pop
+		@tip_point_start_to_add_stack.pop
+		@tip_point_mode_stack.pop
+		@current_tip_point_stack.pop
+		@current_tip_point_group_stack.pop
+		result
+	end
+
+	# @!group DSL methods
+
+	# Set the title of the music for the chart.
+	# This will be reflected in the return value of {#to_sunniesnow}.
+	# @see Sunniesnow::Chart#title
+	# @param title [String] the title of the music.
+	# @return [String] the title of the music, the same as the argument +title+.
+	# @raise [ArgumentError] if +title+ is not a String.
 	def title title
 		raise ArgumentError, 'title must be a string' unless title.is_a? String
 		@title = title
 	end
 
+	# Set the artist of the music for the chart.
+	# This will be reflected in the return value of {#to_sunniesnow}.
+	# @see Sunniesnow::Chart#artist
+	# @param artist [String] the artist of the music.
+	# @return [String] the artist of the music, the same as the argument +artist+.
+	# @raise [ArgumentError] if +artist+ is not a String.
 	def artist artist
 		raise ArgumentError, 'artist must be a string' unless artist.is_a? String
 		@artist = artist
 	end
 
+	# Set the name of the chart author for the chart.
+	# This will be reflected in the return value of {#to_sunniesnow}.
+	# @see Sunniesnow::Chart#charter
+	# @param charter [String] the name of the charter.
+	# @return [String] the name of the chart author, the same as the argument +charter+.
+	# @raise [ArgumentError] if +charter+ is not a String.
 	def charter charter
 		raise ArgumentError, 'charter must be a string' unless charter.is_a? String
 		@charter = charter
 	end
 
+	# Set the name of the difficulty for the chart.
+	# This will be reflected in the return value of {#to_sunniesnow}.
+	# @see Sunniesnow::Chart#difficulty_name
+	# @param difficulty_name [String] the name of the difficulty.
+	# @return [String] the name of the difficulty, the same as the argument +difficulty_name+.
+	# @raise [ArgumentError] if +difficulty_name+ is not a String.
 	def difficulty_name difficulty_name
 		raise ArgumentError, 'difficulty_name must be a string' unless difficulty_name.is_a? String
 		@difficulty_name = difficulty_name
 	end
 
+	# Set the color of the difficulty for the chart.
+	# This will be reflected in the return value of {#to_sunniesnow}.
+	#
+	# The argument +difficulty_color+ can be a color name (a key of {COLORS}),
+	# an RGB color in hexadecimal format (e.g. +'#8c68f3'+, +'#8CF'+),
+	# an RGB color in decimal format (e.g. +'rgb(140, 104, 243)'+),
+	# or an integer representing an RGB color (e.g. +0x8c68f3+).
+	# @see Sunniesnow::Chart#difficulty_color
+	# @param difficulty_color [Symbol, String, Integer] the color of the difficulty.
+	# @return [String] the color of the difficulty in hexadecimal format (e.g. +'#8c68f3'+).
+	# @raise [ArgumentError] if +difficulty_color+ is not a valid color format.
 	def difficulty_color difficulty_color
 		@difficulty_color = case difficulty_color
 		when Symbol
@@ -393,25 +587,98 @@ class Sunniesnow::Charter
 		end
 	end
 
+	# Set the difficulty level for the chart.
+	# This will be reflected in the return value of {#to_sunniesnow}.
+	#
+	# The argument +difficulty+ should be a string representing the difficulty level.
+	# Anything other than a string will be converted to a string using +to_s+.
+	# @see Sunniesnow::Chart#difficulty
+	# @param difficulty [String] the difficulty level.
+	# @return [String] the difficulty level (converted to a string).
 	def difficulty difficulty
 		@difficulty = difficulty.to_s
 	end
 
+	# Set the difficulty superscript for the chart.
+	# This will be reflected in the return value of {#to_sunniesnow}.
+	#
+	# The argument +difficulty_sup+ should be a string representing the difficulty superscript.
+	# Anything other than a string will be converted to a string using +to_s+.
+	# @see Sunniesnow::Chart#difficulty_sup
+	# @param difficulty_sup [String] the difficulty superscript.
+	# @return [String] the difficulty superscript (converted to a string).
 	def difficulty_sup difficulty_sup
 		@difficulty_sup = difficulty_sup.to_s
 	end
 
+	# Set the offset.
+	# This is the time in seconds of the zeroth beat.
+	# This method must be called before any other methods that require a beat,
+	# or an {OffsetError} will be raised.
+	#
+	# After calling this method, the current beat (see {#beat} and {#beat!}) is set to zero,
+	# and a new BPM needs to be set using {#bpm}.
+	# Only after that can the time of any positive beat be calculated.
+	#
+	# Though not commonly useful, this method can be called multiple times in a chart.
+	# A new call of this method does not affect the events and BPM changes set before.
+	# Technically, each event is associated with a BPM change list (see {Event#bpm_changes}),
+	# and each call of this method creates a new BPM change list,
+	# which is used for the events set after.
+	# @param offset [Numeric] the offset in seconds.
+	# @return [BpmChangeList] the BPM changes.
+	# @see BpmChangeList
+	# @raise [ArgumentError] if +offset+ is not a number.
+	# @example
+	#   offset 0.1
+	#   p time_at # Outputs 0.1, which is the offset
+	#   offset 0.2
+	#   p time_at # Outputs 0.2, which is the updated offset by the second call
 	def offset offset
 		raise ArgumentError, 'offset must be a number' unless offset.is_a? Numeric
 		@current_beat = 0r
 		@bpm_changes = BpmChangeList.new offset.to_f
 	end
 
+	# Set the BPM starting at the current beat.
+	# This method must be called after {#offset}.
+	# The method can be called multiple times,
+	# which is useful when the music changes its tempo from time to time.
+	#
+	# Internally, this simply calls {BpmChangeList#add} on the BPM changes created by {#offset}.
+	# @param bpm [Numeric] the BPM.
+	# @raise [OffsetError] if {#offset} has not been called.
+	# @return [BpmChangeList] the BPM changes.
 	def bpm bpm
 		raise OffsetError.new __method__ unless @bpm_changes
 		@bpm_changes.add @current_beat, bpm
 	end
 
+	# Increments the current beat by the given delta set by +delta_beat+.
+	# It is recommended that +delta_beat+ be a Rational or an Integer for accuracy.
+	# Float will be converted to Rational, and a warning will be issued
+	# when a Float is used.
+	#
+	# This method is also useful for inspecting the current beat.
+	# If the method is called without an argument, it simply returns the current beat.
+	# For this purpose, this method is equivalent to {#beat!}.
+	#
+	# This method must be called after {#offset}.
+	# @param delta_beat [Rational, Integer] the delta to increment the current beat by.
+	# @raise [OffsetError] if {#offset} has not been called.
+	# @return [Rational] the new current beat.
+	# @see #beat!
+	# @example Increment the current beat and inspect it
+	#   offset 0.1; bpm 120
+	#   p b       # Outputs 0, this is the initial value
+	#   p b 1     # Outputs 1, because it is incremented by 1 when it was 0
+	#   p b 1/2r  # Outputs 3/2, because it is incremented by 3/2 when it was 1
+	#   p time_at # Outputs 0.85, which is offset + 60s / BPM * beat
+	# @example Time the notes
+	#   offset 0.1; bpm 120
+	#   t 0, 0; b 1
+	#   t 50, 0; b 1
+	#   # Now there are two tap notes, one at beat 0, and the other at beat 1
 	def beat delta_beat = 0
 		raise OffsetError.new __method__ unless @current_beat
 		case delta_beat
@@ -426,6 +693,24 @@ class Sunniesnow::Charter
 	end
 	alias b beat
 
+	# Sets the current beat to the given value.
+	# It is recommended that +beat+ be a Rational or an Integer for accuracy.
+	# Float will be converted to Rational, and a warning will be issued.
+	#
+	# When called without an argument, this method does nothing and returns the current beat.
+	# For this purpose, this method is equivalent to {#beat}.
+	#
+	# This method must be called after {#offset}.
+	# @param beat [Rational, Integer] the new current beat.
+	# @raise [OffsetError] if {#offset} has not been called.
+	# @return [Rational] the new current beat.
+	# @see #beat
+	# @example Set the current beat and inspect it
+	#   offset 0.1; bpm 120
+	#   p b!      # Outputs 0, this is the initial value
+	#   p b! 1    # Outputs 1, because it is set to 1
+	#   p b! 1/2r # Outputs 1/2, because it is set to 1/2
+	#   p time_at # Outputs 0.35, which is offset + 60s / BPM * beat
 	def beat! beat = @current_beat
 		raise OffsetError.new __method__ unless @current_beat
 		case beat
@@ -440,156 +725,24 @@ class Sunniesnow::Charter
 	end
 	alias b! beat!
 
-	def time_at beat = @current_beat
-		raise OffsetError.new __method__ unless @bpm_changes
-		@bpm_changes.time_at beat
-	end
-
-	%i[chain drop none].each do |mode|
-		define_method "tip_point_#{mode}" do |*args, **opts, &block|
-			tip_point mode, *args, **opts, &block
-		end
-		alias_method "tp_#{mode}", "tip_point_#{mode}"
-	end
-
-	def backup_beat
-		{current_beat: @current_beat, bpm_changes: @bpm_changes}
-	end
-
-	def restore_beat backup
-		@current_beat = backup[:current_beat]
-		@bpm_changes = backup[:bpm_changes]
-	end
-
-	def group preserve_beat: true, &block
-		raise ArgumentError, 'no block given' unless block
-		@groups.push result = []
-		beat_backup = backup_beat unless preserve_beat
-		instance_eval &block
-		restore_beat beat_backup unless preserve_beat
-		@groups.delete_if { result.equal? _1 }
-		result
-	end
-
-	def backup_state
-		{
-			current_beat: @current_beat,
-			bpm_changes: @bpm_changes,
-			tip_point_mode_stack: @tip_point_mode_stack.dup,
-			current_tip_point_stack: @current_tip_point_stack.dup,
-			current_tip_point_group_stack: @current_tip_point_group_stack.dup,
-			current_duplicate: @current_duplicate,
-			tip_point_start_to_add_stack: @tip_point_start_to_add_stack.dup,
-			groups: @groups.dup
-		}
-	end
-
-	def restore_state backup
-		@current_beat = backup[:current_beat]
-		@bpm_changes = backup[:bpm_changes]
-		@tip_point_mode_stack = backup[:tip_point_mode_stack]
-		@current_tip_point_stack = backup[:current_tip_point_stack]
-		@current_tip_point_group_stack = backup[:current_tip_point_group_stack]
-		@current_duplicate = backup[:current_duplicate]
-		@tip_point_start_to_add_stack = backup[:tip_point_start_to_add_stack]
-		@groups = backup[:groups]
-		nil
-	end
-
-	def mark name
-		@bookmarks[name] = backup_state
-		name
-	end
-
-	def at name, preserve_beat: false, update_mark: false, &block
-		raise ArgumentError, 'no block given' unless block
-		raise ArgumentError, "unknown bookmark #{name}" unless bookmark = @bookmarks[name]
-		backup = backup_state
-		restore_state bookmark
-		result = group &block
-		mark name if update_mark
-		beat_backup = backup_beat if preserve_beat
-		restore_state backup
-		restore_beat beat_backup if preserve_beat
-		result
-	end
-
-	def tip_point mode, *args, preserve_beat: true, **opts, &block
-		@tip_point_mode_stack.push mode
-		if mode == :none
-			@tip_point_start_to_add_stack.push nil
-			@current_tip_point_stack.push nil
-		else
-			@tip_point_start_to_add_stack.push TipPointStart.new *args, **opts
-			@current_tip_point_stack.push @tip_point_peak
-			@tip_point_peak += 1
-		end
-		result = group preserve_beat: do
-			@current_tip_point_group_stack.push @groups.last
-			instance_eval &block
-		end
-		@tip_point_start_to_add_stack.pop
-		@tip_point_mode_stack.pop
-		@current_tip_point_stack.pop
-		@current_tip_point_group_stack.pop
-		result
-	end
-
-	def remove *events
-		events.each { |event| @groups.each { _1.delete event } }
-	end
-
-	def event type, duration_beats = nil, **properties
-		raise OffsetError.new __method__ unless @bpm_changes
-		event = Event.new type, @current_beat, duration_beats, @bpm_changes, **properties
-		@groups.each { _1.push event }
-		return event unless event.tip_pointable?
-		case @tip_point_mode_stack.last
-		when :chain
-			push_tip_point_start event
-			@tip_point_start_to_add_stack[-1] = nil
-		when :drop
-			push_tip_point_start event
-			@current_tip_point_stack[-1] = @tip_point_peak
-			@tip_point_peak += 1
-		when :none
-			# pass
-		end
-		event
-	end
-
-	def push_tip_point_start start_event
-		start_event[:tip_point] = @current_tip_point_stack.last.to_s
-		tip_point_start = @tip_point_start_to_add_stack.last&.get_start_placeholder start_event
-		return unless tip_point_start
-		@groups.each do |group|
-			group.push tip_point_start
-			break if group.equal?(@current_tip_point_group_stack.last) && @tip_point_mode_stack.last != :drop
-		end
-	end
-
-	def transform events, &block
-		raise ArgumentError, 'no block given' unless block
-		events = [events] if events.is_a? Event
-		transform = Transform.new
-		transform.instance_eval &block
-		events.each { transform.apply _1 }
-	end
-
-	def duplicate events, new_tip_points: true
-		result = []
-		events.each do |event|
-			next if event.type == :placeholder && !new_tip_points
-			result.push event = event.dup
-			if event[:tip_point] && new_tip_points
-				event[:tip_point] = "#@current_duplicate #{event[:tip_point]}"
-			end
-			@groups.each { _1.push event }
-		end
-		@current_duplicate += 1 if new_tip_points
-		result
-	end
-
+	# Creates a tap note at the given coordinates with the given text.
+	# The coordinates +x+ and +y+ must be numbers.
+	# The argument +text+ is the text to be displayed on the note
+	# (it is converted to a string via +to_s+ if it is not a string).
+	#
+	# Technically, this adds an event of type +:tap+ to the chart at the current time
+	# with properties containing the information provided by +x+, +y+, and +text+.
+	# @param x [Numeric] the x-coordinate of the note.
+	# @param y [Numeric] the y-coordinate of the note.
+	# @param text [String] the text to be displayed on the note.
+	# @return [Event] the event representing the tap note.
+	# @raise [ArgumentError] if +x+ or +y+ is not a number.
+	# @example
+	#   offset 0.1; bpm 120
+	#   t 0, 0, 'Hello'
+	#   t 50, 0, 'world'
+	#   # Now there are two simultaneous tap notes at (0, 0) and (50, 0)
+	#   # with texts 'Hello' and 'world' respectively
 	def tap x, y, text = ''
 		if !x.is_a?(Numeric) || !y.is_a?(Numeric)
 			raise ArgumentError, 'x and y must be numbers'
@@ -598,6 +751,29 @@ class Sunniesnow::Charter
 	end
 	alias t tap
 
+	# Creates a hold note at the given coordinates with the given duration and text.
+	# The coordinates +x+ and +y+ must be numbers.
+	# The argument +duration_beats+ is the duration of the hold note in beats.
+	# It needs to be a positive Rational or Integer.
+	# If it is a Float, it will be converted to a Rational, and a warning will be issued.
+	# The argument +text+ is the text to be displayed on the note
+	# (it is converted to a string via +to_s+ if it is not a string).
+	#
+	# Technically, this adds an event of type +:hold+ to the chart at the current time
+	# with properties containing the information provided by +x+, +y+, +duration_beats+, and +text+.
+	# @param x [Numeric] the x-coordinate of the note.
+	# @param y [Numeric] the y-coordinate of the note.
+	# @param duration_beats [Rational, Integer] the duration of the hold note in beats.
+	# @param text [String] the text to be displayed on the note.
+	# @return [Event] the event representing the hold note.
+	# @raise [ArgumentError] if +x+, +y+, or +duration_beats+ is not a number,
+	#   or if +duration_beats+ is not positive.
+	# @example
+	#   offset 0.1; bpm 120
+	#   h 0, 0, 1, 'Hello'
+	#   h 50, 0, 2, 'world'
+	#   # Now there are two hold notes at (0, 0) and (50, 0)
+	#   # with durations 1 and 2 beats and texts 'Hello' and 'world' respectively
 	def hold x, y, duration_beats, text = ''
 		if !x.is_a?(Numeric) || !y.is_a?(Numeric) || !duration_beats.is_a?(Numeric)
 			raise ArgumentError, 'x, y, and duration must be numbers'
@@ -612,6 +788,20 @@ class Sunniesnow::Charter
 	end
 	alias h hold
 
+	# Creates a drag note at the given coordinates.
+	# The coordinates +x+ and +y+ must be numbers.
+	#
+	# Technically, this adds an event of type +:drag+ to the chart at the current time
+	# with properties containing the information provided by +x+ and +y+.
+	# @param x [Numeric] the x-coordinate of the note.
+	# @param y [Numeric] the y-coordinate of the note.
+	# @return [Event] the event representing the drag note.
+	# @raise [ArgumentError] if +x+ or +y+ is not a number.
+	# @example
+	#   offset 0.1; bpm 120
+	#   d 0, 0
+	#   d 50, 0
+	#   # Now there are two drag notes at (0, 0) and (50, 0)
 	def drag x, y
 		if !x.is_a?(Numeric) || !y.is_a?(Numeric)
 			raise ArgumentError, 'x and y must be numbers'
@@ -620,6 +810,32 @@ class Sunniesnow::Charter
 	end
 	alias d drag
 
+	# Creates a flick note at the given coordinates with the given direction and text.
+	# The coordinates +x+ and +y+ must be numbers.
+	# The argument +direction+ is the direction of the flick note in radians or a symbol.
+	# If it is a symbol, it should be one of the keys of {DIRECTIONS}
+	# (which are +:right+, +:up_right+, etc., abbreviated as +:r+, +:ur+ etc.).
+	# If it is a number, it should be a number representing the angle in radians,
+	# specifying the angle rorated anticlockwise starting from the positive x-direction.
+	# The argument +text+ is the text to be displayed on the note
+	# (it is converted to a string via +to_s+ if it is not a string).
+	#
+	# Technically, this adds an event of type +:flick+ to the chart at the current time
+	# with properties containing the information provided by +x+, +y+, +direction+, and +text+.
+	# @param x [Numeric] the x-coordinate of the note.
+	# @param y [Numeric] the y-coordinate of the note.
+	# @param direction [Numeric, Symbol] the direction of the flick note in radians or a symbol.
+	# @param text [String] the text to be displayed on the note.
+	# @return [Event] the event representing the flick note.
+	# @raise [ArgumentError] if +x+ or +y+ is not a number,
+	#   if +direction+ is not a symbol or a number,
+	#   or if the direction is a symbol that does not represent a known direction.
+	# @example
+	#   offset 0.1; bpm 120
+	#   f 0, 0, :r, 'Hello'
+	#   f 50, 0, Math::PI / 4, 'world'
+	#   # Now there are two flick notes at (0, 0) and (50, 0)
+	#   # with directions right and up right and texts 'Hello' and 'world' respectively
 	def flick x, y, direction, text = ''
 		if !x.is_a?(Numeric) || !y.is_a?(Numeric)
 			raise ArgumentError, 'x and y must be numbers'
@@ -637,6 +853,32 @@ class Sunniesnow::Charter
 	end
 	alias f flick
 
+	# Creates a background note at the given coordinates with the given duration and text.
+	# The coordinates +x+ and +y+ must be numbers.
+	# The argument +duration_beats+ is the duration of the background note in beats.
+	# It needs to be a non-negative Rational or Integer.
+	# If it is a Float, it will be converted to a Rational, and a warning will be issued.
+	# The argument +text+ is the text to be displayed on the note
+	# (it is converted to a string via +to_s+ if it is not a string).
+	#
+	# Both the +duration_beats+ and the +text+ arguments are optional.
+	# When there are three arguments given in total,
+	# the method determines whether the third is +duration_beats+ or +text+ based on its type.
+	#
+	# Technically, this adds an event of type +:bg_note+ to the chart at the current time
+	# with properties containing the information provided by +x+, +y+, +duration_beats+, and +text+.
+	# @param x [Numeric] the x-coordinate of the note.
+	# @param y [Numeric] the y-coordinate of the note.
+	# @param duration_beats [Rational, Integer] the duration of the background note in beats.
+	# @param text [String] the text to be displayed on the note.
+	# @return [Event] the event representing the background note.
+	# @raise [ArgumentError] if +x+, +y+, or +duration_beats+ is not a number,
+	#   or if +duration_beats+ is negative.
+	# @example
+	#   offset 0.1; bpm 120
+	#   bg_note 0, 0, 1, 'Hello' # duration is 1, text is 'Hello'
+	#   bg_note 50, 0, 'world'   # duration is 0, text is 'world'
+	#   bg_note -50, 0, 2        # duration is 2, text is ''
 	def bg_note x, y, duration_beats = 0, text = nil
 		if text.nil?
 			if duration_beats.is_a? String
@@ -658,6 +900,23 @@ class Sunniesnow::Charter
 		event :bg_note, duration_beats.to_r, x: x.to_f, y: y.to_f, text: text.to_s
 	end
 
+	# Creates a big text.
+	# The argument +duration_beats+ is the duration of the big text in beats.
+	# It needs to be a non-negative Rational or Integer.
+	# If it is a Float, it will be converted to a Rational, and a warning will be issued.
+	# The argument +text+ is the text to be displayed.
+	#
+	# Technically, this adds an event of type +:big_text+ to the chart at the current time
+	# with properties containing the information provided by +duration_beats+ and +text+.
+	# @param duration_beats [Rational, Integer] the duration of the big text in beats.
+	# @param text [String] the text to be displayed.
+	# @return [Event] the event representing the big text.
+	# @raise [ArgumentError] if +duration_beats+ is not a number or is negative.
+	# @example
+	#   offset 0.1; bpm 120
+	#   big_text 1, 'Hello, world!' # duration is 1, text is 'Hello, world!'
+	#   b 1
+	#   big_text 'Goodbye!'         # duration is 0, text is 'Goodbye!'
 	def big_text duration_beats = 0, text
 		unless duration_beats.is_a? Numeric
 			raise ArgumentError, 'duration_beats must be a number'
@@ -671,6 +930,30 @@ class Sunniesnow::Charter
 		event :big_text, duration_beats.to_r, text: text.to_s
 	end
 
+	# @!macro [attach] bg_pattern
+	#   @!method $1(duration_beats = 0)
+	#   Creates a $2 background pattern.
+	#   The argument +duration_beats+ is the duration of the background pattern in beats.
+	#   It needs to be a non-negative Rational or Integer.
+	#   If it is a Float, it will be converted to a Rational, and a warning will be issued.
+	#
+	#   Technically, this adds an event of type +:bg_pattern+ to the chart at the current time
+	#   with properties containing the information provided by +duration_beats+.
+	#   @param duration_beats [Rational, Integer] the duration of the background pattern in beats.
+	#   @return [Event] the event representing the background pattern.
+	#   @raise [ArgumentError] if +duration_beats+ is not a number or is negative.
+	#   @example
+	#     offset 0.1; bpm 120
+	#     $1 1 # duration is 1
+	#     b 1
+	#     $1 0 # duration is 0
+	# @!parse bg_pattern :grid, 'grid'
+	# @!parse bg_pattern :hexagon, 'hexagon'
+	# @!parse bg_pattern :checkerboard, 'checkerboard'
+	# @!parse bg_pattern :diamond_grid, 'diamond grid'
+	# @!parse bg_pattern :pentagon, 'pentagon'
+	# @!parse bg_pattern :turntable, 'turntable'
+	# @!parse bg_pattern :hexagram, 'hexagram'
 	%i[grid hexagon checkerboard diamond_grid pentagon turntable hexagram].each do |method_name|
 		define_method method_name do |duration_beats = 0|
 			unless duration_beats.is_a? Numeric
@@ -686,25 +969,82 @@ class Sunniesnow::Charter
 		end
 	end
 
-	def to_sunniesnow **opts
-		result = Sunniesnow::Chart.new **opts
-		result.title = @title
-		result.artist = @artist
-		result.charter = @charter
-		result.difficulty_name = @difficulty_name
-		result.difficulty_color = @difficulty_color
-		result.difficulty = @difficulty
-		result.difficulty_sup = @difficulty_sup
-		@events.each { result.events.push _1.to_sunniesnow }
+	# Duplicate all events in a given array.
+	# This method is useful when you want to duplicate a set of events.
+	# The argument +events+ is an array of events to be duplicated.
+	# The argument +new_tip_points+ is a boolean indicating whether to create new tip points.
+	# If it is +true+, new tip points will be created for the duplicated events.
+	# If it is +false+, each duplicated event shares the same tip point as the original event.
+	# @param events [Array<Event>] the events to be duplicated.
+	# @param new_tip_points [Boolean] whether to create new tip points for the duplicated events.
+	# @return [Array<Event>] the duplicated events.
+	# @example Duplicate a note
+	#   offset 0.1; bpm 120
+	#   duplicate [t 0, 0]
+	# @example Duplicate notes that share tip points with the original notes
+	#   offset 0.1; bpm 120
+	#   duplicate tp_chain(0, 100, 1) { t 0, 0 }
+	def duplicate events, new_tip_points: true
+		result = []
+		events.each do |event|
+			next if event.type == :placeholder && !new_tip_points
+			result.push event = event.dup
+			if event[:tip_point] && new_tip_points
+				event[:tip_point] = "#@current_duplicate #{event[:tip_point]}"
+			end
+			@groups.each { _1.push event }
+		end
+		@current_duplicate += 1 if new_tip_points
 		result
 	end
 
-	def output_json **opts
-		to_sunniesnow(**opts).to_json
+	# Transform all events in a given array in time and/or space.
+	# Space transformation does not affect background patterns.
+	def transform events, &block
+		raise ArgumentError, 'no block given' unless block
+		events = [events] if events.is_a? Event
+		transform = Transform.new
+		transform.instance_eval &block
+		events.each { transform.apply _1 }
 	end
 
-	def inspect
-		"#<Sunniesnow::Charter #@name>"
+	def group preserve_beat: true, &block
+		raise ArgumentError, 'no block given' unless block
+		@groups.push result = []
+		beat_backup = backup_beat unless preserve_beat
+		instance_eval &block
+		restore_beat beat_backup unless preserve_beat
+		@groups.delete_if { result.equal? _1 }
+		result
+	end
+
+	def remove *events
+		events.each { |event| @groups.each { _1.delete event } }
+	end
+
+	%i[chain drop none].each do |mode|
+		define_method "tip_point_#{mode}" do |*args, **opts, &block|
+			tip_point mode, *args, **opts, &block
+		end
+		alias_method "tp_#{mode}", "tip_point_#{mode}"
+	end
+
+	def mark name
+		@bookmarks[name] = backup_state
+		name
+	end
+
+	def at name, preserve_beat: false, update_mark: false, &block
+		raise ArgumentError, 'no block given' unless block
+		raise ArgumentError, "unknown bookmark #{name}" unless bookmark = @bookmarks[name]
+		backup = backup_state
+		restore_state bookmark
+		result = group &block
+		mark name if update_mark
+		beat_backup = backup_beat if preserve_beat
+		restore_state backup
+		restore_beat beat_backup if preserve_beat
+		result
 	end
 
 	def check(
@@ -734,4 +1074,6 @@ class Sunniesnow::Charter
 		end
 	end
 
+	# @!endgroup
+
 end

data/tutorial/tutorial.md

@@ -107,7 +107,7 @@ big-d
 ├── README.md
 ├── src
 │   └── master.rb
-└── .sscharter.yml
+└── sscharter.yml
 ```
 
 Here are some explanation for each of them.
@@ -121,13 +121,13 @@ see [the official documentation](https://bundler.io/man/gemfile.5.html).
 If you do not use Git as the version manager for your project, it does nothing.
 - `Rakefile` contains some tasks that can be run by [Rake](https://ruby.github.io/rake/).
 - `README.md` is the README file of your project.
-- `.sscharter.yml` is the sscharter configuration for your project.
+- `sscharter.yml` is the sscharter configuration for your project.
 - `files` is the directory whose files will be included in the final level file.
-You can change the directory in `.sscharter.yml`.
+You can change the directory in `sscharter.yml`.
 - `src` is the directory that contains the source codes of your project.
-You can change the directory in `.sscharter.yml`.
+You can change the directory in `sscharter.yml`.
 
-Open `.sscharter.yml` using your text editor.
+Open `sscharter.yml` using your text editor.
 Here are the contents that you should see:
 
 ```yaml
@@ -332,7 +332,7 @@ Then, edit `Rakefile` to disable browser launching and enable live restart:
 
 ```ruby
 task :serve do
-  exec 'bundle exec sscharter serve --no-open-browser --live-restart'
+  exec 'bundle exec sscharter serve --no-open-browser'
 end
 ```
 
@@ -952,6 +952,56 @@ end
 # write something here...
 ```
 
+Sometimes even `preserve_beat: false` is not convenient enough to write complicated note patterns.
+The `mark` and `at` methods can help you with more complicated charts.
+
+Use `mark` to mark a place and label it with a symbol of your choice
+(e.g. `:left_hand`), and use `at` to write notes at that point.
+
+```ruby
+group, preserve_beat: false do
+  # write something here...
+  mark :left_hand # mark the current place with the label `:left_hand`
+end
+
+group do
+  # write something here...
+  mark :right_hand # mark the current place with the label `:right_hand`
+end
+
+at :left_hand do
+  # write notes here as if continuing where `mark :left_hand` is
+end
+
+at :right_hand do
+  # write notes here as if continuing where `mark :right_hand` is
+end
+```
+
+You can also use `at` with `update_mark: true` to update the mark
+to the place where the block in `at` is ended.
+
+```ruby
+group do
+  # ...
+  mark :x
+  # ...
+end
+
+at :x, update_mark: true do
+  # ...
+end
+
+at :x do
+  # as if continuing the last `at :x, update_mark: true` block
+end
+```
+
+Usually, when `at` finishes, the current beat is set
+to whatever it was before `at` was called.
+You can keep the current beat by using `preserve_beat: true`
+in the call of `at`.
+
 ### BPM changes
 
 > [!NOTE]
@@ -1191,6 +1241,21 @@ transform duplicate notes, new_tip_points: false do
 end
 ```
 
+When you use `mark` inside a tip point block,
+the tip point state is also preserved when you use `at` later.
+For example:
+
+```ruby
+tp_chain 0, 100, 1 do
+  t 0, 0; b 1
+  mark :my_mark
+end
+
+at :my_mark do
+  t 100, 0 # this note will be connected by the same tip point
+end
+```
+
 ## Advanced charting techniques
 
 TODO.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: sscharter
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.8.0
 platform: ruby
 authors:
 - Ulysses Zhan
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-09-09 00:00:00.000000000 Z
+date: 2025-06-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rubyzip
@@ -122,7 +122,21 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '13.0'
-description: 
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+description:
 email:
 - ulysseszhan@gmail.com
 executables:
@@ -148,7 +162,7 @@ licenses: []
 metadata:
   homepage_uri: https://github.com/sunniesnow/sscharter
   source_code_uri: https://github.com/sunniesnow/sscharter
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -163,8 +177,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.3
-signing_key: 
+rubygems_version: 3.5.16
+signing_key:
 specification_version: 4
 summary: A Ruby DSL for writing Sunniesnow charts
 test_files: []