sevgi-showcase 0.95.0 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f3b056b346721f8c0dc42b08402803516bb6890e5999a399acf083842c5ad1f4
-  data.tar.gz: 475358290666f23737aaef97a31efbb31fa96548843eeecf03cd9c2fba55c2a6
+  metadata.gz: eecc3014d3bbf6524c0c30eed7632c3414de707442fa4c89a38b151cea344696
+  data.tar.gz: 7d8bf35039daedc891b88f55a32e622eee708c9af0350f7940d83826207e6634
 SHA512:
-  metadata.gz: 0fb1f3bc3a07900c83d3c3e32b916ac9ad87d38eb4c9b28e564ceafabae362353adf3b62c3ad93185e4b7846a0c1ef797b949dc3487c6d21025742255c755c69
-  data.tar.gz: f0a0169c177354f9ffcc3982f54c7873e0ab1d78577989dee603bcb40ca6ecc0fa2eb36ea60c91a8fab906a21a8b7f0991dbe012942237e80236e283dd640b5d
+  metadata.gz: 808da584d85c10cf7cb4587afdd1451b3d83accfc1b76c06b961680085d9ccbcdc5a0b2800bbc5ac2d16b92218b23e45076a15b9e2af0c8e979ddb11fe11ffd6
+  data.tar.gz: bbff818a26174051d81fdba11f7b4ba031a9dead679b7d31d0daf030b975a818e08bd36165e54c9636b467614dfbb33964684a45157556aa080b03bbf387e9a7

data/CHANGELOG.md

@@ -3,7 +3,226 @@
 This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html) and follows
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
-## Unreleased
+## 1.0.0 - 2026-09-16
+
+### Added
+
+- Added Hatch and Orb Showcase examples and displayed both arc lengths in the Arc example.
+
+### Changed
+
+- Matched documentation page widths to the homepage Showcase.
+- Aligned Derender user guidance with UTF-8 normalization and safe subtree selection rules.
+- Clarified the packaged skill's script invocation, subtree copying, and Derender selection and encoding rules.
+- Allowed Canvas and Paper values as the first `SVG` argument when using the default document profile.
+- Made element `dup` and `clone` own independent subtrees while retaining IDs and Ruby copy semantics.
+- Made Segment equality compare length and direction; ordering still compares length only.
+- Limited Tile cell, row, and column queries to the requested geometry and accelerated XML character validation.
+- Simplified the first-run guide and aligned library constructor examples.
+- Updated the packaged skill for canvas origins, alignment, Paper lookup, curved geometry, and export constraints.
+- Revised DSL catalog examples and packaged Sevgi skill guidance to use statement-style calls and show inspection results.
+- Refined Showcase example tabs, made Ruby and XML views fill their panels, and hid executable preambles from Ruby views.
+- Documented non-rendering element data and clarified the related DSL catalog examples.
+- Refined Showcase heading spacing, page-title colors, and DSL catalog cards across light and dark themes.
+- Removed an obsolete ruler example and unused site code.
+- Kept the Squared and Copperplate guidesheet examples together at the end of the Showcase.
+- Updated the packaged skill to avoid duplicate semantic shapes and unnecessary paint passes.
+
+### Fixed
+
+- Kept horizontal scrollbars visible in Showcase example code panels.
+- Read Derender input in its declared XML encoding and normalized generated source, XML declarations, and markup to UTF-8.
+- Preserved open-path endpoints and derived edges independently of display precision.
+- Kept near-axis and near-parallel line equations and intersections independent of angle and slope rounding.
+- Corrected the Showcase social image dimensions.
+- Added SVG namespaces to standalone drawing examples and regenerated their outputs.
+- Made failed Sevgi Rake tasks stop dependent tasks and captured required-library failures in executor results.
+- Removed executor signal-handler replacement so the host and shell retain SIGINT ownership.
+- Escaped late export CSS as XML text and inserted it only at a supported final root closing tag.
+- Preserved Derender processing instructions and rejected custom entity references and unsupported trailing document nodes before inclusion.
+- Included both box origins in `Align`, unified Tile index validation, and isolated custom numeric attribute snapshots.
+- Prevented avoidable overflow and underflow in point distances.
+- Corrected browser source-panel expectations and added executable documentation, YARD, and packaged-skill checks.
+- Rendered inline code in DSL catalog summaries and kept linked task themes visible below the sticky header.
+- Restored Showcase tab icons with embedded Font Awesome SVGs.
+
+## 0.100.0 - 2026-09-09
+
+### Added
+
+- Added `ArcTo` and `ArcBy` for SVG-native elliptical arc paths.
+- Added Geometry `Arc`, `Ellipse`, and `Circle` with bounds, length, predicates, affine transformations, and
+  linear/quadratic intersections. Closed ellipses and circles support sweeps and hatching.
+- Added Geometry `Point.midpoint`, `Element#closed?`, lined `vertices`, open-path traversal, and `Rect#center`.
+- Added Geometry aggregate bounding boxes through `Operation.box`, point collinearity through `Point.collinear?`, and
+  polygon `simple?`, `convex?`, and `concave?` predicates.
+- Added Protractor and Arc examples and documented the drawing and calculation APIs.
+
+### Changed
+
+- Removed redundant parent scans while duplicating element subtrees.
+- Reused source bounds across Tile cells to reduce repeated calculations and object allocations.
+
+### Fixed
+
+- Preserved Showcase card HTML through Markdown rendering so all examples and their tabs remain visible.
+- Preserved XML declarations, pre-root comments, CDATA sections, inline comments, and namespace-only leaves in
+  Derender output and evaluation.
+- Limited PDF stamp recoloring to replaced text and carried graphics state across a page's content streams.
+- Corrected decimal interval fitting and made Grid point queries honor the active numeric precision.
+- Prevented implicit shell interpretation of single executable arguments in `F.sh` and `F.sh!`, including paths with spaces or shell metacharacters.
+- Preserved inherited namespaces on detached Derender nodes in generated source and direct evaluation, including imports through `EvaluateChildren` and `IncludeChildren`.
+- Prevented sweep and Hatch lines from crossing the exterior between two tangent vertices of a concave polygon.
+- Aligned Tile cells with their declared bounds for circles, rotated shapes, and polygons whose first vertex differs from their bounding-box origin.
+- Limited `Load` chains to 128 active sources with `Executor::LoadDepthError`, preserving cycle detection and nested load diagnostics.
+- Rejected nil and false aggregate-box inputs with the documented geometry error.
+- Restored precision-aware rejection of zero-length Triangle sides.
+- Made point-set collinearity independent of input order and removed eager polygon edge-pair storage.
+- Applied the collinearity tolerance to every three-point subset, removing coordinate-axis-dependent baseline selection.
+
+## 0.99.0 - 2026-08-09
+
+### Added
+
+- Added `SVG.Module` for building anonymous callable drawing modules with their contract installed before definition.
+- Added responsive Mermaid diagrams for the Derender round trip and SVG validation lifecycle.
+
+### Changed
+
+- Reorganized the documentation around getting started, usage, composition, documents, layout, output, and examples.
+- Documented how the `igves` and `igsev` command names reflect their conversion directions.
+- Normalized DSL catalog provider labels to lowercase and simplified polyfill-backed editor entries to `inkscape`.
+
+### Fixed
+
+- Allowed A5-on-A4 pdfcpu conversion to replace an existing output file.
+- Pre-rendered Mermaid diagrams as inline SVG instead of parsing them in site visitors' browsers.
+- Removed duplicate provider and context labels from DSL catalog entries.
+
+## 0.98.2 - 2026-07-25
+
+### Fixed
+
+- Restored the `sevgi` CLI's main-object scope so bare toolkit calls remain available inside script helper classes.
+
+## 0.98.1 - 2026-07-20
+
+### Changed
+
+- Changed the `sevgi` CLI to use the executor's isolated scope by default.
+
+### Removed
+
+- Removed the redundant `-n` and `--nomain` CLI options; library consumers can still select `main: true` through
+  `Sevgi.execute` and `Sevgi.execute_file` when needed.
+
+## 0.98.0 - 2026-07-20
+
+### Added
+
+- Added standard-input support to `sevgi`, `igves`, and `igsev`; `sevgi --as NAME` and
+  `Sevgi.execute_file(..., as: NAME)` supply the logical source basename used by implicit SVG, PDF, and PNG
+  destinations without changing physical load identity.
+
+## 0.97.0 - 2026-07-19
+
+### Added
+
+- Added `sevgi-appendix`, containing the Sevgi agent skill and a RuboCop plugin for preserving readable `.sevgi` DSL
+  source alongside rubyfmt-formatted Ruby; the umbrella `sevgi` gem installs the matching Appendix version.
+- Added `sevgi --skill` to report the validated path of the matching packaged agent skill for product-neutral setup.
+- Added `igsev` to the umbrella gem for normalizing an SVG file through a complete SVG-to-Sevgi-to-SVG round trip.
+
+### Changed
+
+- Made Homebrew the recommended complete CLI installation while retaining Bundler and focused component gems for Ruby
+  application dependencies.
+
+## 0.96.0 - 2026-07-18
+
+### Added
+
+- Added exact, subtree-wide attribute omission to Derender content/file conversion, evaluation, and inclusion APIs;
+  `igves --omit` exposes the same behavior from the command line.
+- Added `Sevgi.SVG` as the explicit namespaced form of the top-level SVG document entrypoint.
+- Added the opt-in recursive `SVG::Modules` contract for callable drawing namespaces.
+- Added callable drawing-module `base` blocks, document and paper registry introspection, Canvas structural equality,
+  renderer options on `RenderChildren`, axis translation helpers, and a CC BY RDF helper.
+- Formalized non-rendering `-` metadata and `+` attribute updates as `Attributes::META_PREFIX` and
+  `Attributes::UPDATE_SUFFIX`; repeated Array updates now concatenate into a stable flat value.
+
+### Changed
+
+- Breaking: replaced the `SVG = Sevgi::Graphics` alias with an independent SVG facade. Facade operations now use
+  capitalized names such as `SVG.Canvas` and `SVG.Document`; lowercase component helpers remain on
+  `Sevgi::Graphics`, and the stuttering `SVG.SVG` form was removed.
+- Breaking: made low-level `Executor.execute` and `execute_file` runners private; consumers use
+  `Sevgi.execute` and `Sevgi.execute_file` while retaining the public result and error types.
+- Breaking: removed the abstract `Document::Base` layer from the selectable document-profile registry; `Minimal` and
+  `Default` are now sibling concrete profiles, and custom profile hierarchies should derive from `Base`.
+- Breaking: renamed Parallelogram segment and constraint arguments by geometric role: `base`, `side`, and
+  `constraint` replace axis-implying constructor names.
+- Made degree-based sine and cosine exact at integer quarter turns, eliminating cardinal Geometry residue.
+- Documented complete file-system failure families for file comparison, output, touch, and upward location helpers.
+- Formalized generated Tile ids, positional CSS classes, template placement, and per-use callback signatures.
+- Formalized String and Symbol ids across Derender selection APIs and documented file-read failures consistently.
+- Breaking: made top-level `Decompile`, `Derender`, `Evaluate`, and `EvaluateChildren` consume inline SVG/XML;
+  file inputs now use the corresponding `File`-suffixed entrypoints.
+- Breaking: replaced callable drawing module `call` block registration with argument-independent `base` blocks;
+  inherited bases run parent-first, and modules with one drawing method conventionally name it `call`.
+- Breaking: made bracket and call notation the canonical Geometry constructors. Among Data value types, bracket notation
+  is public only for Point, Segment, LengthAngle, Margin, and Paper; use `.new` for Location and result carriers, and
+  `Stay` for traversal stop tokens.
+- Breaking: aligned Point and Segment comparison with Ruby `Comparable`; malformed or unrelated comparison operands now
+  return nil from `<=>`.
+- Breaking: executor entrypoints now return immutable `Executor::Result` values and expose only `execute` and
+  `execute_file`; inspect `result.error`, `result.stack`, and `result.value` instead of executor scopes or lifecycle state.
+- Breaking: wrapper attributes and callable arguments use distinct channels, `With` rejects parentless receivers, and
+  unsupported direct constructors are private; use the documented factories for Content, concrete Geometry lined
+  elements, and Grid query values.
+- Breaking: Canvas uses `.new` for explicit fields, `.from_paper(paper, **overrides)` for paper conversion, and
+  `.call`/`Graphics.canvas` for dispatch; the misleading keyword-only `.from_paper(width:, height:)` form was removed.
+- Breaking: `Save`, `Write`, `PNG`, `PDF`, and Sundries native export normalize successful destinations to expanded
+  String paths and create missing parent directories; change-aware SVG writes still return nil when unchanged.
+- Breaking: renamed `Derender.evaluate_file_children` to `evaluate_children_file`; decompiled nodes now own immutable
+  public state while parser, strategy, and construction plumbing remain private.
+- Expanded runtime/YARD parity checks and exact contracts for inherited, extended, generated, and dynamic API surfaces,
+  forwarded options, error channels, path ownership, whitespace, namespaces, nil behavior, and return values.
+
+### Fixed
+
+- Rejected directories from default file discovery while preserving custom locator matchers.
+- Kept `Ancestral` context in non-rendering `-context` metadata instead of leaking it into SVG attributes.
+- Preserved source Canvas units and names when deriving fitted Grid canvases.
+- Prevented stale documentation assets from mixing old layouts with new HTML, and moved sidebar navigation into the
+  tablet menu at 1024px and below.
+- Normalized numeric slots owned by path, shape, transform, tile, and Inkscape page helpers to finite SVG number spelling;
+  arbitrary user-supplied attributes remain untouched.
+- Made named callable wrapper and symbol ids stable while omitting defaults for anonymous modules, and indexed every
+  rendered id value, including false and numeric values, through its serialized string.
+- Preserved signed Geometry constraint directions, rejected invalid sweep/export channels through Sevgi error families,
+  and validated raw output paths before expansion or rendering.
+- Made callable module configuration copy-owned and freeze-aware, document subclasses inherit their nearest profile, and
+  false executor boot receivers remain explicit rather than defaulting to an internal scope.
+- Made element trees, attributes, identifiers, locator results, document profiles, Derender nodes, shell results, and
+  executor results retain owned immutable snapshots where their public contracts promise value semantics.
+- Corrected Shell combined-output separators, nil export density errors, document render-option routing, executor source
+  snapshots, selected-node namespace/whitespace documentation, and Standard character-data validation.
+
+### Removed
+
+- Removed public access to pluralization tables and the internal SVG save extension; pluralization rules are now deeply
+  immutable.
+- Removed public documentation and constant access for command-line implementation modules; the `sevgi` and `igves`
+  executables remain unchanged.
+- Removed eager loading and public documentation of private Showcase build/test support; explicit support entrypoints
+  now keep the harness under the Showcase namespace.
+- Removed public access to document profile name normalizers; registry operations retain them as private plumbing.
+- Removed the redundant `Margin.margin` constructor; use canonical bracket notation.
+- Removed public executor orchestration, obsolete callable-module hooks, the old public attribute syntax constants, and
+  direct construction of abstract or internally wired Content, Element, and Grid query types.
+- Removed accidental public access to abstract Lined factories, internal element-name/export maps, result/location
+  bracket constructors, and direct Stop construction.
 
 ## 0.95.0 - 2026-07-11
 
@@ -87,7 +306,7 @@ This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 
 ### Changed
 
-- Added the checker board example to the documentation showcase flow.
+- Added the checkerboard example to the documentation showcase flow.
 - Consolidated Victor Book attribution for adapted showcase examples into a single documentation note.
 
 ### Fixed

data/README.md

@@ -1,6 +1,6 @@
 # Sevgi Showcase
 
-Executable examples, rendered outputs, and documentation-site support.
+Sevgi Showcase packages the executable examples, their SVG output, and support code for the documentation site.
 
 ## Install
 
@@ -8,22 +8,15 @@ Executable examples, rendered outputs, and documentation-site support.
 gem install sevgi-showcase
 ```
 
-## Require
+## Contents
 
-```ruby
-require "sevgi/showcase"
-```
-
-## Example
-
-```ruby
-suite = Sevgi::Test::Suite.new("srv")
-suite.valids.map(&:name)
-```
+The gem is an asset package rather than a runtime API. It contains executable `.sevgi` examples and their expected SVG
+output. It also contains private build support for the documentation site. The test suite runs each example and
+compares its output.
 
 ## Ruby compatibility
 
-Requires Ruby 3.4.0 or newer. CI verifies Ruby 3.4.0 and the current development Ruby from `.ruby-version`.
+Requires Ruby 3.4.0 or newer. CI verifies the current Ruby 3.4 release and the development Ruby from `.ruby-version`.
 
 ## Native prerequisites
 
@@ -47,7 +40,7 @@ gem install cairo rsvg2 hexapdf
 
 ## Links
 
-- Documentation: https://sevgi.roktas.dev
-- API documentation: https://www.rubydoc.info/gems/sevgi-showcase
-- Source: https://github.com/roktas/sevgi/tree/main/showcase
-- Changelog: https://github.com/roktas/sevgi/blob/main/CHANGELOG.md
+- Documentation: <https://sevgi.roktas.dev>
+- API documentation: <https://www.rubydoc.info/gems/sevgi-showcase>
+- Source: <https://github.com/roktas/sevgi/tree/main/showcase>
+- Changelog: <https://github.com/roktas/sevgi/blob/main/CHANGELOG.md>

data/lib/sevgi/showcase/dark.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require_relative "../showcase"
+
 module Sevgi
   module Showcase
     # Applies dark-theme color mappings to showcase source files.
@@ -60,5 +62,7 @@ module Sevgi
         end
       end
     end
+
+    private_constant :Dark
   end
 end

data/lib/sevgi/showcase/minitest/script.rb

@@ -1,78 +1,80 @@
 # frozen_string_literal: true
 
 module Sevgi
-  # Minitest helpers used by the showcase component.
-  # @api private
-  module Test
-    # Executable showcase script descriptor.
+  module Showcase
+    # Minitest helpers used by the showcase component.
     # @api private
-    class Script
-      # @return [String] absolute script path
-      attr_reader :file
+    module Test
+      # Executable showcase script descriptor.
+      # @api private
+      class Script
+        # @return [String] absolute script path
+        attr_reader :file
 
-      # Creates a script descriptor.
-      # @param file [String] executable .sevgi file
-      # @return [void]
-      # @raise [Sevgi::ArgumentError] when the file is missing or not executable
-      def initialize(file) = @file = ::File.expand_path(sanitize(file))
+        # Creates a script descriptor.
+        # @param file [String] executable .sevgi file
+        # @return [void]
+        # @raise [Sevgi::ArgumentError] when the file is missing or not executable
+        def initialize(file) = @file = ::File.expand_path(sanitize(file))
 
-      # Returns the script directory.
-      # @return [String]
-      def dir = @dir ||= ::File.dirname(file)
+        # Returns the script directory.
+        # @return [String]
+        def dir = @dir ||= ::File.dirname(file)
 
-      # Returns the script basename.
-      # @return [String]
-      def file! = ::File.basename(file)
+        # Returns the script basename.
+        # @return [String]
+        def file! = ::File.basename(file)
 
-      # Returns the script name without extension.
-      # @return [String]
-      def name = @name ||= ::File.basename(file, ".*")
+        # Returns the script name without extension.
+        # @return [String]
+        def name = @name ||= ::File.basename(file, ".*")
 
-      # @overload run(*args)
-      #   Runs the script directly.
-      #   @param args [Array<String>] extra command arguments
-      #   @return [Sevgi::Test::Shell::Result]
-      def run(*) = Shell.run(file, *)
+        # @overload run(*args)
+        #   Runs the script directly.
+        #   @param args [Array<String>] extra command arguments
+        #   @return [Sevgi::Function::Shell::Result]
+        def run(*) = F.sh(file, *)
 
-      # Returns the script suite name.
-      # @return [String]
-      def suite = @suite ||= ::File.basename(dir)
+        # Returns the script suite name.
+        # @return [String]
+        def suite = @suite ||= ::File.basename(dir)
 
-      # Reports whether the expected SVG output exists.
-      # @return [Boolean]
-      def svg? = ::File.exist?(svg)
+        # Reports whether the expected SVG output exists.
+        # @return [Boolean]
+        def svg? = ::File.exist?(svg)
 
-      # Returns the expected SVG output path.
-      # @return [String]
-      def svg = @svg ||= ::File.expand_path("#{dir}/#{name}.svg")
+        # Returns the expected SVG output path.
+        # @return [String]
+        def svg = @svg ||= ::File.expand_path("#{dir}/#{name}.svg")
 
-      # Returns the expected SVG output basename.
-      # @return [String]
-      def svg! = ::File.basename(svg)
+        # Returns the expected SVG output basename.
+        # @return [String]
+        def svg! = ::File.basename(svg)
 
-      # Returns the optional YAML metadata path.
-      # @return [String]
-      def yml = @yml ||= ::File.expand_path("#{dir}/#{name}.yml")
+        # Returns the optional YAML metadata path.
+        # @return [String]
+        def yml = @yml ||= ::File.expand_path("#{dir}/#{name}.yml")
 
-      # Returns the optional YAML metadata basename.
-      # @return [String]
-      def yml! = ::File.basename(yml)
+        # Returns the optional YAML metadata basename.
+        # @return [String]
+        def yml! = ::File.basename(yml)
 
-      # @overload run_passive(*args)
-      #   Runs the script without writing Save output to files.
-      #   @param args [Array<String>] extra command arguments
-      #   @return [Sevgi::Test::Shell::Result]
-      def run_passive(*)
-        warn("...#{name}")
-        Shell.run("sevgi", "-r", "sevgi/showcase/passive", file, *)
-      end
+        # @overload run_passive(*args)
+        #   Runs the script without writing Save output to files.
+        #   @param args [Array<String>] extra command arguments
+        #   @return [Sevgi::Function::Shell::Result]
+        def run_passive(*)
+          warn("...#{name}")
+          F.sh("sevgi", "-r", "sevgi/showcase/passive", file, *)
+        end
 
-      private
+        private
 
-      def sanitize(file)
-        file.tap do
-          ArgumentError.("No such file: #{file}") unless ::File.exist?(file)
-          ArgumentError.("Not an executable: #{file}") unless ::File.executable?(file)
+        def sanitize(file)
+          file.tap do
+            ArgumentError.("No such file: #{file}") unless ::File.exist?(file)
+            ArgumentError.("Not an executable: #{file}") unless ::File.executable?(file)
+          end
         end
       end
     end

data/lib/sevgi/showcase/minitest/suite.rb

@@ -1,53 +1,55 @@
 # frozen_string_literal: true
 
 module Sevgi
-  # Minitest helpers used by the showcase component.
-  # @api private
-  module Test
-    # Showcase script suite collection.
+  module Showcase
+    # Minitest helpers used by the showcase component.
     # @api private
-    class Suite
-      # Creates a suite from a showcase root directory.
-      # @param rootdir [String] showcase root directory
-      # @return [void]
-      def initialize(rootdir)
-        @scripts = load(rootdir)
-      end
-
-      # Returns scripts belonging to a suite.
-      # @param suite [String, Symbol] suite name
-      # @return [Array<Sevgi::Test::Script>]
-      def [](suite)
-        (@cache ||= {})[suite] ||= @scripts.select { |script| script.suite == suite.to_s }
-      end
-
-      # Returns all suite names.
-      # @return [Array<String>]
-      def suites
-        @suites ||= @scripts.map(&:suite).uniq
-      end
-
-      # Suite names that are expected to be invalid examples.
-      NON_VALIDS = ["gotcha"].freeze
-
-      # Returns scripts expected to be invalid.
-      # @return [Array<Sevgi::Test::Script>]
-      def non_valids
-        NON_VALIDS.map { self[it] }.flatten
-      end
-
-      # Returns scripts expected to render successfully.
-      # @return [Array<Sevgi::Test::Script>]
-      def valids
-        suites.reject { NON_VALIDS.include?(it) }.map { self[it] }.flatten
-      end
-
-      alias to_a valids
-
-      private
-
-      def load(rootdir)
-        ::Dir["#{rootdir}/**/*.sevgi"].grep_v(%r{(/_|/lib/|/library/)}).map { Script.new(it) }
+    module Test
+      # Showcase script suite collection.
+      # @api private
+      class Suite
+        # Creates a suite from a showcase root directory.
+        # @param rootdir [String] showcase root directory
+        # @return [void]
+        def initialize(rootdir)
+          @scripts = load(rootdir)
+        end
+
+        # Returns scripts belonging to a suite.
+        # @param suite [String, Symbol] suite name
+        # @return [Array<Sevgi::Showcase::Test::Script>]
+        def [](suite)
+          (@cache ||= {})[suite] ||= @scripts.select { |script| script.suite == suite.to_s }
+        end
+
+        # Returns all suite names.
+        # @return [Array<String>]
+        def suites
+          @suites ||= @scripts.map(&:suite).uniq
+        end
+
+        # Suite names that are expected to be invalid examples.
+        NON_VALIDS = ["gotcha"].freeze
+
+        # Returns scripts expected to be invalid.
+        # @return [Array<Sevgi::Showcase::Test::Script>]
+        def non_valids
+          NON_VALIDS.map { self[it] }.flatten
+        end
+
+        # Returns scripts expected to render successfully.
+        # @return [Array<Sevgi::Showcase::Test::Script>]
+        def valids
+          suites.reject { NON_VALIDS.include?(it) }.map { self[it] }.flatten
+        end
+
+        alias to_a valids
+
+        private
+
+        def load(rootdir)
+          ::Dir["#{rootdir}/**/*.sevgi"].grep_v(%r{(/_|/lib/|/library/)}).map { Script.new(it) }
+        end
       end
     end
   end

data/lib/sevgi/showcase/minitest.rb

@@ -1,5 +1,12 @@
 # frozen_string_literal: true
 
+require "sevgi/function"
+
 require_relative "minitest/script"
-require_relative "minitest/shell"
 require_relative "minitest/suite"
+
+module Sevgi
+  module Showcase
+    private_constant :Test
+  end
+end

data/lib/sevgi/showcase/version.rb

@@ -4,6 +4,6 @@ module Sevgi
   # Showcase component namespace.
   module Showcase
     # Current showcase component version.
-    VERSION = "0.95.0"
+    VERSION = "1.0.0"
   end
 end

data/lib/sevgi/showcase.rb

@@ -2,7 +2,4 @@
 
 require "sevgi"
 
-require_relative "showcase/dark"
-require_relative "showcase/minitest"
-
 require_relative "showcase/version"

data/srv/arc.sevgi

@@ -0,0 +1,29 @@
+#!/usr/bin/env -S ruby -S sevgi
+# frozen_string_literal: true
+
+SVG :inkscape, width: "150mm", height: "100mm", viewBox: "0 0 150 100" do
+  ellipse = Geometry::Ellipse[70, 40, position: [75, 50], rotation: -15]
+  arc = ellipse.arc starting_angle: 180, extent: 210
+  remainder = ellipse.arc starting_angle: arc.starting_angle, extent: arc.extent - 360
+
+  g fill: "none", stroke: "slategray", "stroke-width": 0.3, "stroke-dasharray": "2 2" do
+    Draw remainder, id: "arc-remainder"
+    Draw arc.box
+  end
+
+  Draw arc, id: "arc-route", fill: "none", stroke: "purple", "stroke-width": 1
+
+  text dy: 7, fill: "black", "font-family": "monospace", "font-size": 5 do
+    textPath arc.length.round(1).to_s, href: "#arc-route", startOffset: "50%", "text-anchor": "middle"
+  end
+
+  text dy: -4, fill: "slategray", "font-family": "monospace", "font-size": 5 do
+    textPath remainder.length.round(1).to_s, href: "#arc-remainder", startOffset: "50%", "text-anchor": "middle"
+  end
+
+  [arc.starting, arc.reverse.starting].each do |point|
+    circle cx: point.x, cy: point.y, r: 1.5, fill: "purple"
+  end
+
+  circle cx: arc.center.x, cy: arc.center.y, r: 1, fill: "black"
+end.Save

data/srv/arc.svg

@@ -0,0 +1,32 @@
+<?xml version="1.0" standalone="no"?>
+<svg
+  xmlns="http://www.w3.org/2000/svg"
+  xmlns:_="http://sevgi.roktas.dev"
+  xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+  xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+  shape-rendering="crispEdges"
+  width="150mm"
+  height="100mm"
+  viewBox="0 0 150 100"
+>
+  <g fill="none" stroke="slategray" stroke-width="0.3" stroke-dasharray="2 2">
+    <path id="arc-remainder" d="M 7.385192159765225 68.11733315717646 A 70 40 -15 0 0 138.73252216369696 53.62844576284043"/>
+    <rect x="6.597208" y="7.326143" width="136.805584" height="60.79119"/>
+  </g>
+  <path
+    id="arc-route"
+    d="M 7.385192159765225 68.11733315717646 A 70 40 -15 1 1 138.73252216369696 53.62844576284043"
+    fill="none"
+    stroke="purple"
+    stroke-width="1"
+  />
+  <text dy="7" fill="black" font-family="monospace" font-size="5">
+    <textPath href="#arc-route" startOffset="50%" text-anchor="middle">198.7</textPath>
+  </text>
+  <text dy="-4" fill="slategray" font-family="monospace" font-size="5">
+    <textPath href="#arc-remainder" startOffset="50%" text-anchor="middle">153.3</textPath>
+  </text>
+  <circle cx="7.385192159765225" cy="68.11733315717646" r="1.5" fill="purple"/>
+  <circle cx="138.73252216369696" cy="53.62844576284043" r="1.5" fill="purple"/>
+  <circle cx="75.0" cy="50.0" r="1" fill="black"/>
+</svg>