First commit

Author: kojix2

.editorconfig

@@ -0,0 +1,9 @@
+root = true
+
+[*.cr]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+indent_style = space
+indent_size = 2
+trim_trailing_whitespace = true

.github/dependabot.yml

@@ -0,0 +1,6 @@
+version: 2
+updates:
+- package-ecosystem: "github-actions"
+  directory: "/"
+  schedule:
+    interval: "weekly"

.github/workflows/docs.yml

@@ -0,0 +1,23 @@
+name: docs
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v6
+      - uses: crystal-lang/install-crystal@v1
+      - name: Install dependencies
+        run: shards install
+      - name: Generate document
+        run: crystal docs
+      - name: Deploy to GitHub Pages
+        uses: peaceiris/actions-gh-pages@v4
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./docs

.github/workflows/test.yml

@@ -0,0 +1,42 @@
+name: Test
+
+on:
+  push:
+  pull_request:
+  workflow_dispatch:
+
+jobs:
+  test:
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest]
+        crystal: [latest]
+
+    runs-on: ${{ matrix.os }}
+
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          submodules: recursive
+
+      - name: Install Crystal
+        uses: crystal-lang/install-crystal@v1
+        with:
+          crystal: ${{ matrix.crystal }}
+
+      - name: Install shards
+        run: shards install --without-development
+
+      - name: Run specs
+        run: crystal spec
+
+      - name: Build examples
+        run: |
+          find examples -name "*.cr" | sort | while read f; do
+            echo "Building $f ..."
+            crystal build --no-codegen "$f"
+          done
+
+      - name: Check formatting
+        run: crystal tool format --check

.gitignore

@@ -0,0 +1,9 @@
+/docs/
+/lib/
+/bin/
+/.shards/
+*.dwarf
+
+# Libraries don't need dependency lock
+# Dependencies will be locked in applications that use them
+/shard.lock

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "UnicodePlots.jl"]
+	path = UnicodePlots.jl
+	url = https://github.com/JuliaPlots/UnicodePlots.jl

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 kojix2 <2xijok@gmail.com>
+
+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.

README.md

@@ -0,0 +1,101 @@
+# unicode_plot.cr
+
+[![Test](https://github.com/kojix2/unicode_plot/actions/workflows/test.yml/badge.svg)](https://github.com/kojix2/unicode_plot/actions/workflows/test.yml)
+
+Unicode terminal plots for Crystal — a port of Julia's [UnicodePlots.jl](https://github.com/JuliaPlots/UnicodePlots.jl).
+
+The code was ported from Julia using an AI tool
+
+**UNDER CONSTRUCTION** Until the first version is released, this repository will be updated by force push.
+
+## Installation
+
+Add to your `shard.yml`:
+
+```yaml
+dependencies:
+  unicode_plot:
+    github: kojix2/unicode_plot
+```
+
+Then run `shards install`.
+
+## Usage
+
+```crystal
+require "unicode_plot"
+include UnicodePlot
+```
+
+### Line plot
+
+```crystal
+x = (0..62).map { |i| i * Math::PI / 31.0 }
+y = x.map { |v| Math.sin(v) }
+puts lineplot(x, y, title: "sin(x)", xlabel: "x", ylabel: "sin(x)", color: :blue)
+```
+
+### Scatter plot
+
+```crystal
+x1 = (1..15).map { Random.rand * 3.0 + 1.0 }
+y1 = (1..15).map { Random.rand * 3.0 + 1.0 }
+x2 = (1..15).map { Random.rand * 3.0 + 6.0 }
+y2 = (1..15).map { Random.rand * 3.0 + 6.0 }
+
+p = scatterplot(x1, y1, name: "cluster A", color: :blue,
+  title: "Two clusters", xlim: {0.0, 11.0}, ylim: {0.0, 11.0})
+scatterplot!(p, x2, y2, name: "cluster B", color: :red)
+puts p
+```
+
+### Bar plot
+
+```crystal
+cities  = ["Tokyo", "Delhi", "Shanghai", "São Paulo", "Mexico City"]
+popmill = [13.96, 16.79, 24.18, 12.33, 9.21]
+puts barplot(cities, popmill, title: "City populations", xlabel: "population [mil]")
+```
+
+You can also pass a `Hash(String, Float64)` directly (sorted by key):
+
+```crystal
+puts barplot({"Ruby" => 95.0, "Python" => 98.0, "Crystal" => 72.0}, title: "Scores")
+```
+
+### Histogram
+
+```crystal
+data = (1..500).map { Random.rand * 10.0 }
+puts histogram(data, title: "Uniform [0, 10)", nbins: 15)
+```
+
+### Multiple series / incremental plots
+
+All plot types support a mutating `!` variant for adding series to an existing plot:
+
+```crystal
+x = (1..20).map(&.to_f)
+p = lineplot(x, x.map { |v| Math.sqrt(v) }, name: "√x", color: :green, title: "Functions")
+lineplot!(p, x, x.map { |v| Math.log(v) }, name: "ln(x)", color: :red)
+puts p
+```
+
+### Options
+
+| Option | Description |
+|---|---|
+| `title` | Plot title |
+| `xlabel` / `ylabel` | Axis labels |
+| `xlim` / `ylim` | Axis limits as `{min, max}` tuple |
+| `color` | Line/point color (`:red`, `:blue`, `:green`, `:cyan`, `:magenta`, `:yellow`, `:normal`) |
+| `name` | Series name (shown in legend) |
+| `xscale` / `yscale` | Scale function (`:log2`, `:log10`, or a `Proc(Float64, Float64)`) |
+| `width` / `height` | Canvas size in characters |
+| `canvas` | Canvas type (`:braille`, `:block`, `:ascii`) |
+
+See `examples/` for runnable demos.
+
+## License
+
+MIT — see [LICENSE](LICENSE).

UnicodePlots.jl

@@ -0,0 +1,34 @@
+require "../src/unicode_plot"
+
+include UnicodePlot
+
+# Basic bar plot
+levels = ["layer_1", "layer_2", "layer_3", "layer_4", "layer_5"]
+weights = [13.96, 16.79, 24.18, 12.33, 9.21]
+
+p = barplot(levels, weights,
+  title: "Relative weights", xlabel: "weight")
+puts p
+puts
+
+# From a Hash (sorted by key automatically)
+data = {"axis_a" => 95.0, "axis_b" => 98.0, "axis_c" => 72.0, "axis_d" => 68.0, "axis_e" => 85.0}
+p = barplot(data, title: "Axis scores", xlabel: "score", color: :cyan)
+puts p
+puts
+
+# Gradient bar symbols (sub-character resolution)
+bands = ["band_1", "band_2", "band_3", "band_4", "band_5"]
+vals = [100.0, 88.5, 75.2, 92.1, 89.4]
+p = barplot(bands, vals,
+  title: "Resolution bands",
+  symbols: [' ', '▏', '▎', '▍', '▌', '▋', '▊', '▉', '█'],
+  color: :green)
+puts p
+puts
+
+# Adding bars to an existing plot with barplot!
+p = barplot(["stage_1"], [42.0], title: "Incremental stages")
+barplot!(p, "stage_2", 67.0)
+barplot!(p, "stage_3", 31.0, color: :yellow)
+puts p