bridgetown-sasso 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: b68b631ae279627da6312ca719e9748b5715bef5ef7e6ddb67919f85a90dd8cd
+  data.tar.gz: 4d63762884c2fe576e18ed29203cfc3062f7d2457b8fabb3806320e1461f4335
+SHA512:
+  metadata.gz: 1c3a1e478fe0f6d5f43e0bebf684508b15e97995c9b947b659e6fccffc6bc1846b85e2da6ebed46f6d11852bea77b8c2e03c5f2d107d2bd7ddb65df4c9e67c01
+  data.tar.gz: e7954ee3a5db6241ee6ac8d9628a1c50d619b7d66a3b85c10dcb20099cdb9ae223b1131500bf06b2db5a598919dbe83afc948e3b6cbbceef63a678c6a41054ae

data/CHANGELOG.md

@@ -0,0 +1,19 @@
+# Changelog
+
+All notable changes to **bridgetown-sasso** are documented here.
+The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
+
+## [Unreleased]
+
+## [0.1.0] - 2026-06-14
+
+Initial release. Requires the `sasso` gem **>= 0.2.0** and Bridgetown **>= 2.0**.
+
+### Added
+
+- Bridgetown plugin that compiles configured Sass/SCSS entrypoints with the
+  pure-Rust `sasso` compiler in-process (no Node, no Dart, no subprocess) and
+  writes the CSS into the site output.
+- Enable with `init :"bridgetown-sasso"`; configure `entrypoints`, `styles_dir`,
+  `style`, and `load_paths`.
+- `bridgetown.automation.rb` for `bin/bridgetown apply`.

data/Gemfile

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+gemspec

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 momiji-rs
+
+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,115 @@
+# bridgetown-sasso
+
+Compile **Sass/SCSS in [Bridgetown](https://www.bridgetownrb.com)** with
+[**sasso**](https://github.com/momiji-rs/sasso-ruby) — a pure-Rust,
+zero-dependency, byte-for-byte [dart-sass](https://sass-lang.com) alternative.
+
+Compilation runs **in-process during the build** — no Node toolchain, no Dart
+VM, no subprocess. Bridgetown's default frontend has no native Sass step; this
+plugin gives you one without pulling in `node` + esbuild + the `sass` npm.
+
+- **No Node.** Compile Sass with zero JavaScript tooling.
+- **In-process.** No process spawn per build — sasso is a native Ruby gem.
+- **Byte-for-byte dart-sass.** Same CSS as `dart-sass`, just faster.
+
+## Installation
+
+```ruby
+# Gemfile
+gem "bridgetown-sasso"
+```
+
+```sh
+bundle install
+```
+
+Then enable it in `config/initializers.rb`:
+
+```ruby
+Bridgetown.configure do |config|
+  init :"bridgetown-sasso"
+end
+```
+
+Put your entrypoint (and its partials) under `src/_css/` — the leading
+underscore keeps Bridgetown from publishing the raw `.scss`. The default
+entrypoint is `src/_css/index.scss`, compiled to `output/css/main.css`. Link it
+from your layout:
+
+```html
+<link rel="stylesheet" href="/css/main.css">
+```
+
+Or scaffold everything in one step:
+
+```sh
+bin/bridgetown apply https://github.com/momiji-rs/bridgetown-sasso
+```
+
+## Configuration
+
+All optional (defaults shown):
+
+```ruby
+init :"bridgetown-sasso" do
+  # <source under src/<styles_dir>> => <output under the site output dir>
+  entrypoints({ "index.scss" => "css/main.css" })
+
+  # Dir under src/ holding the entrypoints + their partials. Underscore-prefixed
+  # so Bridgetown does not publish the raw .scss.
+  styles_dir "_css"
+
+  # nil = :compressed in production (BRIDGETOWN_ENV=production), :expanded else.
+  # Or force :expanded / :compressed.
+  style nil
+
+  # Extra @use/@import dirs. The entrypoint's own directory is always searched
+  # first, so sibling partials (e.g. _buttons.scss) need no configuration.
+  load_paths []
+end
+```
+
+Multiple entrypoints are supported — list each one:
+
+```ruby
+entrypoints({ "index.scss" => "css/main.css", "admin.scss" => "css/admin.css" })
+```
+
+## Performance
+
+`sasso` compiles the same CSS as dart-sass, byte-for-byte, but much faster — and
+without any Node runtime. Benchmarked on an Apple M2 Max, all engines dart-sass
+1.101, against the Node frontend's default Sass engine (`sass`, dart2js):
+
+**In-process** (how this plugin compiles — inside the Ruby build process):
+
+| workload | bridgetown-sasso | Node `sass` (dart2js) |
+|----------|------------------|-----------------------|
+| ~360 rules  | **1.2 ms** | 8.0 ms (**6.4× slower**) |
+| ~3000 rules | **9.9 ms** | 71.5 ms (**7.2× slower**) |
+
+**Cold per-build** (a one-shot `bridgetown build` / deploy, including runtime
+startup):
+
+| workload | bridgetown-sasso | dart-sass (native) | Node `sass` (dart2js) |
+|----------|------------------|--------------------|-----------------------|
+| ~360 rules  | **3.0 ms** | 27.5 ms (9×) | 185 ms (**63× slower**) |
+| ~3000 rules | **10.9 ms** | 64.2 ms (6×) | 348 ms (**32× slower**) |
+
+Output is byte-identical to dart-sass, so this is pure speedup with no behavior
+change. (Synthetic workloads exercising variables, nesting, `&`, unit math,
+color functions, and `@at-root`; ratios are the takeaway, absolute numbers are
+machine-specific.)
+
+## How it fits the build
+
+The plugin registers a Bridgetown builder that, after each build, compiles every
+configured entrypoint with `Sasso.compile` and writes the CSS into the site
+output directory. `bin/bridgetown build` and `bridgetown serve` (watch) both
+regenerate it. Because the CSS is produced in-process, there is no Node
+dependency for Sass at all.
+
+## License
+
+MIT, matching the Sass ecosystem. (The core `sasso` compiler crate is dual
+MIT OR Apache-2.0.)

data/Rakefile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test" << "lib"
+  t.test_files = FileList["test/**/test_*.rb"]
+  t.warning = false
+end
+
+task default: :test

data/bridgetown-sasso.gemspec

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+require_relative "lib/bridgetown-sasso/version"
+
+Gem::Specification.new do |spec|
+  spec.name     = "bridgetown-sasso"
+  spec.version  = BridgetownSasso::VERSION
+  spec.author   = "momiji-rs"
+  spec.summary  = "Compile Sass/SCSS in Bridgetown with the pure-Rust sasso compiler — no Node, no Dart"
+  spec.description = "A Bridgetown plugin that compiles your Sass/SCSS entrypoints with sasso, a " \
+                     "pure-Rust, zero-dependency, byte-for-byte dart-sass alternative. Compilation " \
+                     "runs in-process during the build (no Node toolchain, no Dart VM, no subprocess)."
+  spec.homepage = "https://github.com/momiji-rs/bridgetown-sasso"
+  spec.license  = "MIT"
+
+  spec.metadata = {
+    "homepage_uri"    => spec.homepage,
+    "source_code_uri" => spec.homepage,
+    "changelog_uri"   => "#{spec.homepage}/blob/main/CHANGELOG.md",
+    "rubygems_mfa_required" => "true",
+  }
+
+  spec.files = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|script|spec|features)/}) || f.match(%r{^\.})
+  end
+  spec.require_paths = ["lib"]
+
+  spec.required_ruby_version = ">= 3.1.0"
+
+  spec.add_dependency "bridgetown", ">= 2.0"
+  spec.add_dependency "sasso", ">= 0.2.0", "< 1"
+
+  spec.add_development_dependency "bundler"
+  spec.add_development_dependency "minitest", "~> 5.0"
+  spec.add_development_dependency "minitest-reporters", "~> 1.0"
+  spec.add_development_dependency "rake", ">= 13.0"
+end

data/bridgetown.automation.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+# Run with:  bin/bridgetown apply https://github.com/momiji-rs/bridgetown-sasso
+#
+# Adds the gem, registers the initializer, and scaffolds a starter entrypoint.
+
+add_gem "bridgetown-sasso"
+
+add_initializer :"bridgetown-sasso" do
+  <<~RUBY
+    do
+      # entrypoints({ "index.scss" => "css/main.css" })
+      # style :compressed   # default: :compressed in production, :expanded else
+      # load_paths []
+    end
+  RUBY
+end
+
+create_file "src/_css/index.scss" do
+  <<~SCSS
+    @use "sass:color";
+
+    $brand: #3366cc;
+
+    body {
+      color: $brand;
+      a { color: color.adjust($brand, $lightness: -10%); }
+    }
+  SCSS
+end
+
+say_status :bridgetown_sasso,
+           %(Link the compiled CSS in your layout: <link rel="stylesheet" href="/css/main.css">, then `bin/bridgetown build`.),
+           :green

data/lib/bridgetown-sasso/builder.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+require "fileutils"
+require "sasso"
+
+module BridgetownSasso
+  # Compiles the configured SCSS entrypoints with the pure-Rust `sasso` compiler
+  # after each build and writes the resulting CSS into the site's output
+  # directory. Runs in-process — no Node, no Dart, no subprocess.
+  class Builder < Bridgetown::Builder
+    def build
+      # Compile after the site is written, so the CSS lands in the output dir
+      # (and survives that build's cleanup); a watch rebuild regenerates it.
+      hook :site, :post_write do
+        compile_all
+      end
+    end
+
+    def compile_all
+      style = resolved_style
+      Array(entrypoints).each do |source, output|
+        src = site.in_source_dir(styles_dir, source.to_s)
+        unless File.file?(src)
+          Bridgetown.logger.warn("bridgetown-sasso:", "entrypoint not found: #{src}")
+          next
+        end
+        # `Sasso.compile` already searches the entry file's own directory for
+        # relative `@use`/`@import`; `load_paths` adds any extra dirs.
+        css = ::Sasso.compile(src, style: style, load_paths: extra_load_paths)
+        dest = site.in_dest_dir(output.to_s)
+        FileUtils.mkdir_p(File.dirname(dest))
+        File.write(dest, css)
+        Bridgetown.logger.info("bridgetown-sasso:", "#{source} -> #{output} (#{style})")
+      end
+    end
+
+    private
+
+    # Bridgetown's resolved config exposes nested values as a plain Hash; read
+    # defensively (symbol or string keys) so we don't depend on method access.
+    def config
+      site.config[:bridgetown_sasso] || site.config["bridgetown_sasso"] || {}
+    end
+
+    def cfg(key, default)
+      value = config[key]
+      value = config[key.to_s] if value.nil?
+      value.nil? ? default : value
+    end
+
+    def entrypoints
+      cfg(:entrypoints, { "index.scss" => "css/main.css" })
+    end
+
+    def styles_dir
+      cfg(:styles_dir, "_css").to_s
+    end
+
+    def extra_load_paths
+      Array(cfg(:load_paths, [])).map(&:to_s)
+    end
+
+    # nil -> :compressed in production, :expanded otherwise; a forced value wins.
+    def resolved_style
+      forced = cfg(:style, nil)
+      return forced.to_sym if forced
+
+      production? ? :compressed : :expanded
+    end
+
+    def production?
+      (ENV["BRIDGETOWN_ENV"] || ENV["RACK_ENV"] || "development").to_s == "production"
+    end
+  end
+end

data/lib/bridgetown-sasso/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module BridgetownSasso
+  # The plugin version floats independently of the `sasso` compiler gem; the
+  # gemspec pins the compiler with a range.
+  VERSION = "0.1.0"
+end

data/lib/bridgetown-sasso.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+require "bridgetown"
+require "bridgetown-sasso/version"
+require "bridgetown-sasso/builder"
+
+# Bridgetown plugin: compile Sass/SCSS with the pure-Rust, zero-dependency
+# `sasso` compiler (a byte-for-byte dart-sass alternative) — no Node, no Dart,
+# no subprocess; compilation happens in-process during the Bridgetown build.
+#
+# Enable it from a site's `config/initializers.rb`:
+#
+#   Bridgetown.configure do |config|
+#     init :"bridgetown-sasso"
+#   end
+#
+# and configure (all optional; defaults shown):
+#
+#   init :"bridgetown-sasso" do
+#     # entrypoints: <source under source_dir/styles_dir> => <output under dest>
+#     entrypoints({ "index.scss" => "css/main.css" })
+#     styles_dir "_css"   # holds the entrypoints + their partials (underscore =
+#                         # not published by Bridgetown as raw files)
+#     style nil           # nil = :compressed in production, :expanded otherwise;
+#                         # or force :expanded / :compressed
+#     load_paths []       # extra @use/@import dirs (the entrypoint's own dir is
+#                         # always searched first)
+#   end
+Bridgetown.initializer :"bridgetown-sasso" do |config|
+  config.bridgetown_sasso ||= {}
+  config.bridgetown_sasso.entrypoints ||= { "index.scss" => "css/main.css" }
+  config.bridgetown_sasso.styles_dir  ||= "_css"
+  config.bridgetown_sasso.style       ||= nil
+  config.bridgetown_sasso.load_paths  ||= []
+
+  config.builder BridgetownSasso::Builder
+end

metadata

@@ -0,0 +1,149 @@
+--- !ruby/object:Gem::Specification
+name: bridgetown-sasso
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- momiji-rs
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-06-14 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bridgetown
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: sasso
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '1'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: minitest-reporters
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '13.0'
+description: A Bridgetown plugin that compiles your Sass/SCSS entrypoints with sasso,
+  a pure-Rust, zero-dependency, byte-for-byte dart-sass alternative. Compilation runs
+  in-process during the build (no Node toolchain, no Dart VM, no subprocess).
+email:
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- bridgetown-sasso.gemspec
+- bridgetown.automation.rb
+- lib/bridgetown-sasso.rb
+- lib/bridgetown-sasso/builder.rb
+- lib/bridgetown-sasso/version.rb
+homepage: https://github.com/momiji-rs/bridgetown-sasso
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/momiji-rs/bridgetown-sasso
+  source_code_uri: https://github.com/momiji-rs/bridgetown-sasso
+  changelog_uri: https://github.com/momiji-rs/bridgetown-sasso/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: Compile Sass/SCSS in Bridgetown with the pure-Rust sasso compiler — no Node,
+  no Dart
+test_files: []