unmagic-icon 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 66fe0a90a06ca3989154088d6e1d8cda87f6f1055d9b0ddf368ee2e9a054fd2f
-  data.tar.gz: fb7ad24d2a2c4d56a9dc4246751ff12542424ebc392bddba9be78f8f3420bc47
+  metadata.gz: c5b83398a6488aca7718c59177ca2775d52f303a841c343eef276bb5ff839d6f
+  data.tar.gz: e1e6008c9a19de5d9a13a242995fbde2d3424fdde199715f103f31990466ad46
 SHA512:
-  metadata.gz: c5e2c6186cb26a61779090c520930a9941725db13d2807df6a61ecad308debecaf86c928ca9e4b5bc6ca3dd3768b16fa1456ae42802a34bd6a90ab8963db3b71
-  data.tar.gz: 65e389aa2b586335518e70919aa560601a8157cc8ef21bab78ed8ab52fdce9dc0ba35add14410a737d4fbc9690fafe673cc7d5a1ec9ec14aa31dd64e2649a694
+  metadata.gz: 3f83522a7112bb64594de36d766cefdf7ea8498494a9e18e49355b13d0702a91165beed958c2740924f7387f0a9acdb8fb2dc4fc79750a39785c920e7ccb5cd0
+  data.tar.gz: 113ba5070733c634c923f646d2bf5f501f0af3060b783f26e596d6bad507257483f3eaf0f1f0cd2fc0581475d68c01013e0c83846a5a54ddfb456d9e18f113e9

data/CHANGELOG.md

@@ -7,6 +7,35 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.4.0] - 2026-09-30
+
+### Added
+- Four pinned downloadable icon libraries: `gilbarbara-logos` (Gil Barbara SVG
+  Logos), `homarr-icons` (Homarr Dashboard Icons), `carbon-pictograms` (IBM
+  Carbon Pictograms), and `aws-architecture-icons` (official AWS service icons).
+- Product-specific references for Microsoft Power BI, Dagster, IBM Cloud,
+  CloudFormation, AWS Cloud Development Kit, and distinct SageMaker products.
+  Preserve available Homarr light/dark variants and upstream filenames.
+- Retain upstream license/README files and source provenance for the new
+  open-source libraries; fail downloads when required attribution is missing.
+- Verify the pinned AWS archive with SHA-256 and retain AWS attribution and
+  usage terms. Install 64px service SVGs; AWS assets remain proprietary and
+  are downloaded directly rather than bundled in the gem.
+- Installation examples, source pins, and licensing guidance for the new sets.
+
+## [0.3.1] - 2026-09-30
+
+### Changed
+- Update Feather to 4.29.2, Tabler to 3.48.0, Lucide to 1.49.0,
+  Simple Icons to 16.33.0, Material File Icons to 5.38.1, Octicons to
+  19.38.0, Iconoir to 7.12.1, and Lobe Icons to 1.95.1.
+- Download Tabler and Octicons from their official npm SVG packages.
+
+### Fixed
+- Extract Tabler's nested SVG directories, with outline icons at `tabler/name`
+  and filled variants at `tabler/filled/name`, avoiding filename collisions.
+- Download Silk from its existing `master` branch.
+
 ## [0.3.0] - 2026-07-31
 
 ### Added
@@ -59,7 +88,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   hooks into `assets:precompile`) and `unmagic:icons:download[library]`
 - `Unmagic::Icon::Web`, a Rack app for browsing the configured icon libraries
 
-[Unreleased]: https://github.com/unreasonable-magic/unmagic-icon/compare/v0.3.0...HEAD
+[Unreleased]: https://github.com/unreasonable-magic/unmagic-icon/compare/v0.4.0...HEAD
+[0.4.0]: https://github.com/unreasonable-magic/unmagic-icon/compare/v0.3.1...v0.4.0
+[0.3.1]: https://github.com/unreasonable-magic/unmagic-icon/compare/v0.3.0...v0.3.1
 [0.3.0]: https://github.com/unreasonable-magic/unmagic-icon/compare/v0.2.1...v0.3.0
 [0.2.1]: https://github.com/unreasonable-magic/unmagic-icon/compare/v0.2.0...v0.2.1
 [0.2.0]: https://github.com/unreasonable-magic/unmagic-icon/compare/v0.1.0...v0.2.0

data/README.md

@@ -122,7 +122,7 @@ Available libraries:
 | `heroicons`           | Heroicons           | Beautiful hand-crafted SVG icons by the makers of Tailwind CSS               |
 | `devicons`            | Devicons            | Icons representing programming languages, designing & development tools      |
 | `feather`             | Feather Icons       | Simply beautiful open source icons                                           |
-| `tabler`              | Tabler Icons        | Over 5400 free SVG icons                                                     |
+| `tabler`              | Tabler Icons        | Outline icons at `tabler/name`, filled icons at `tabler/filled/name`           |
 | `lucide`              | Lucide Icons        | Beautiful & consistent icons                                                 |
 | `simple-icons`        | Simple Icons        | SVG icons for popular brands                                                 |
 | `material-file-icons` | Material File Icons | Material Design file icons with filename/extension aliases                   |
@@ -134,6 +134,133 @@ Available libraries:
 | `material-design-icons` | Material Design Icons | 7400+ Material Design icons (Pictogrammers @mdi)                        |
 | `phosphor`            | Phosphor Icons      | Flexible icon family with six weights (thin to fill, plus duotone)           |
 | `lobe-icons`          | Lobe Icons          | Popular AI / LLM model brand logos and icons                                 |
+| `gilbarbara-logos` | Gil Barbara SVG Logos | Full-colour technology logos |
+| `homarr-icons` | Homarr Dashboard Icons | Service logos with available light/dark variants |
+| `carbon-pictograms` | IBM Carbon Pictograms | IBM pictograms including IBM Cloud |
+| `aws-architecture-icons` | AWS Architecture Icons | Official 64px service SVGs; AWS usage terms apply |
+
+### Brand and cloud libraries
+
+| Key | Pinned source | Example references |
+| --- | --- | --- |
+| `gilbarbara-logos` | [gilbarbara/logos](https://github.com/gilbarbara/logos/tree/37a6b807fd71c622efea27a9309b5d4edc792969), commit `37a6b807fd71c622efea27a9309b5d4edc792969` | `gilbarbara-logos/microsoft-power-bi`, `gilbarbara-logos/aws-cloudformation` |
+| `homarr-icons` | [homarr-labs/dashboard-icons](https://github.com/homarr-labs/dashboard-icons/tree/c716eb6798576923fa08e9b3e4125173148994ed), commit `c716eb6798576923fa08e9b3e4125173148994ed` | `homarr-icons/powerbi`, `homarr-icons/dagster-light`, `homarr-icons/dagster-dark` |
+| `carbon-pictograms` | [`@carbon/pictograms` 12.85.0](https://www.npmjs.com/package/@carbon/pictograms/v/12.85.0) | `carbon-pictograms/ibm--cloud` |
+| `aws-architecture-icons` | Official July 31, 2026 ZIP, SHA-256 verified | `aws-architecture-icons/Arch_AWS-CloudFormation_64` |
+
+Install these through the same initializer and task as other libraries:
+
+```ruby
+Unmagic::Icon.configure do |config|
+  config.libraries = [:"gilbarbara-logos", :"homarr-icons", :"carbon-pictograms", :"aws-architecture-icons"]
+end
+```
+
+```bash
+bin/rails unmagic:icons:install
+# Or individually:
+bin/rails 'unmagic:icons:download[gilbarbara-logos]'
+bin/rails 'unmagic:icons:download[homarr-icons]'
+bin/rails 'unmagic:icons:download[carbon-pictograms]'
+bin/rails 'unmagic:icons:download[aws-architecture-icons]'
+```
+
+```erb
+<%= unmagic_icon "gilbarbara-logos/microsoft-power-bi", class: "size-6" %>
+<%= unmagic_icon "gilbarbara-logos/aws-cloudformation" %>
+<%= unmagic_icon "homarr-icons/powerbi" %>
+<%= unmagic_icon "homarr-icons/dagster-light" %>
+<%= unmagic_icon "homarr-icons/dagster-dark" %>
+<%= unmagic_icon "carbon-pictograms/ibm--cloud" %>
+<%= unmagic_icon "aws-architecture-icons/Arch_AWS-CloudFormation_64" %>
+<%= unmagic_icon "aws-architecture-icons/Arch_AWS-Cloud-Development-Kit_64" %>
+<%= unmagic_icon "aws-architecture-icons/Arch_Amazon-SageMaker_64" %>
+<%= unmagic_icon "aws-architecture-icons/Arch_Amazon-SageMaker-AI_64" %>
+```
+
+Names retain upstream spelling, case, punctuation, and variant suffixes. Select
+light/dark assets explicitly; no automatic theme or product aliases are added.
+SVG Logos' `slim` identifies the [Slim PHP framework](https://www.slimframework.com/),
+**not** the Ruby template language. Unknown products raise instead of falling
+back to a parent-company logo.
+
+Downloads copy `logos/*.svg`, `svg/*.svg`, and `package/svg/*.svg`, respectively,
+into their library directories. Dashboard's archive also contains PNG/WebP and
+website assets (a large download); only its top-level SVG assets are installed.
+Carbon's `@carbon/icons` 11.89.0 and `@carbon/pictograms` 12.85.0 packages were
+both inspected: the former has a UI-sized `svg/32/ibm-cloud.svg`; the latter has
+the IBM Cloud pictogram `svg/ibm--cloud.svg`. This integration selects the
+pictograms family, excludes `src/svg` duplicates and JavaScript, and preserves
+the double hyphen in its canonical name. The UI icons package is not installed.
+
+SVG Logos, Homarr Dashboard Icons, and Carbon retain the upstream license and README alongside the SVGs,
+plus a `manifest.json` recording its source, exact revision/version and license.
+SVG Logos also retains `logos.json` with the original product identities and
+links. The downloader does not execute npm scripts or upstream code. Existing
+libraries and saved references are unchanged; rendering uses the same inline
+SVG pipeline. As with existing libraries, downloaded SVGs are trusted assets,
+not sanitized untrusted uploads.
+
+#### Attribution and redistribution
+
+These assets are not covered by this gem's MIT license. Keep the downloaded
+legal files when redistributing them:
+
+- **SVG Logos:** [CC0-1.0](https://github.com/gilbarbara/logos/blob/37a6b807fd71c622efea27a9309b5d4edc792969/LICENSE.txt).
+  The upstream README identifies logos as their respective owners' property;
+  CC0 does not waive trademark rights or third-party rights.
+- **Homarr Dashboard Icons:** [Apache-2.0](https://github.com/homarr-labs/dashboard-icons/blob/c716eb6798576923fa08e9b3e4125173148994ed/LICENSE),
+  with copyright attribution to Bjorn Lammers, Meier Lukas, Thomas Camlong and
+  Homarr Labs. Preserve the license and applicable notices; identify changes
+  when distributing modified files. The README limits brand representations
+  to identification and disclaims endorsement.
+- **IBM Carbon Pictograms:** Apache-2.0, as shipped in the pinned package's
+  `LICENSE` and `README.md`. Preserve these and applicable copyright notices;
+  identify modifications. Apache-2.0 does not grant general trademark rights.
+
+Neither pinned Apache archive contains a separate `NOTICE` file. SVG bytes are
+copied unchanged; rendering adds the gem's normal wrapper attributes. If you
+redistribute rendered or otherwise modified assets, retain the license and
+applicable notices and identify your modifications.
+
+#### AWS Architecture Icons
+
+The `aws-architecture-icons` downloader fetches the official July 31, 2026 ZIP
+directly from AWS. It verifies SHA-256
+`d2d166c453526471749d520e0db022c459abef759d2946cf2dd1d1c992dc6526`
+before extraction and installs only `Architecture-Service-Icons_07312026/Arch_*/64/*.svg`.
+Upstream filenames and SVG bytes remain unchanged. Other sizes, resource icons,
+category icons, raster files, and macOS metadata are excluded.
+
+AWS assets are proprietary. The [AWS Architecture Icons](https://aws.amazon.com/architecture/icons/)
+page permits customers and partners to use them in architecture diagrams and
+related materials. The [AWS Site Terms](https://aws.amazon.com/terms/) and
+[AWS Intellectual Property License](https://aws.amazon.com/legal/aws-ip-license-terms/)
+apply; downloading through this gem does not grant general redistribution or
+trademark rights. No separate license file is included in the archive. The
+installer writes `ATTRIBUTION.txt` with AWS ownership, source and terms links,
+usage constraints and the extraction/rendering changes, plus provenance in
+`manifest.json`. No AWS assets are bundled in the gem. Check AWS's terms for
+your intended use, especially before redistributing an icon pack.
+
+The inspected [official archive](https://d1.awsstatic.com/onedam/marketing-channels/website/public/shared/architecture-icon-release/Icon-package_07312026.5846e92413caa21490223536cc97f1269e44fa92.zip)
+contains the following distinct service SVGs under
+`Architecture-Service-Icons_07312026/`:
+
+| Product | Category / exact filename |
+| --- | --- |
+| CloudFormation | `Arch_Management-Tools/64/Arch_AWS-CloudFormation_64.svg` |
+| AWS Cloud Development Kit | `Arch_Developer-Tools/64/Arch_AWS-Cloud-Development-Kit_64.svg` |
+| Amazon SageMaker | `Arch_Analytics/64/Arch_Amazon-SageMaker_64.svg` |
+| Amazon SageMaker AI | `Arch_Artificial-Intelligence/64/Arch_Amazon-SageMaker-AI_64.svg` |
+| Amazon SageMaker Studio Lab | `Arch_Artificial-Intelligence/64/Arch_Amazon-SageMaker-Studio-Lab_64.svg` |
+| Amazon SageMaker Ground Truth | `Arch_Artificial-Intelligence/64/Arch_Amazon-SageMaker-Ground-Truth_64.svg` |
+
+Each filename above is installed at `aws-architecture-icons/<filename-without-.svg>`.
+For example, Studio Lab is `aws-architecture-icons/Arch_Amazon-SageMaker-Studio-Lab_64`
+and Ground Truth is `aws-architecture-icons/Arch_Amazon-SageMaker-Ground-Truth_64`.
+SageMaker and SageMaker AI remain distinct, with no ambiguous `sagemaker` alias
+or fallback to AWS's company logo. Source and licensing review: 2026-09-30.
 
 ### Browsing icons
 

data/lib/unmagic/icon/library/source/aws_architecture_icons.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+require "digest"
+
+module Unmagic
+  class Icon
+    class Library
+      class Source
+        class AwsArchitectureIcons < Source
+          SHA256 = "d2d166c453526471749d520e0db022c459abef759d2946cf2dd1d1c992dc6526"
+          ATTRIBUTION = <<~TEXT
+            AWS Architecture Icons — July 31, 2026
+            Icons are the property of Amazon Web Services, Inc. and/or its affiliates.
+            Source: https://aws.amazon.com/architecture/icons/
+            Terms: https://aws.amazon.com/terms/
+            IP license: https://aws.amazon.com/legal/aws-ip-license-terms/
+
+            AWS permits customers and partners to use these assets in architecture
+            diagrams and related materials. These are proprietary assets, not assets
+            licensed under this gem's MIT license. Downloading does not grant general
+            redistribution or trademark rights; check AWS's terms for your use.
+            No separate license file is included in this upstream archive.
+
+            This download copies the 64px architecture service SVGs unchanged,
+            preserving their upstream filenames. The gem's renderer adds its normal
+            SVG wrapper attributes. Other sizes, resource icons and category icons
+            are not installed.
+          TEXT
+
+          key :"aws-architecture-icons"
+          title "AWS Architecture Icons"
+          description "Official AWS service icons for architecture diagrams (AWS usage terms apply)"
+          url "https://d1.awsstatic.com/onedam/marketing-channels/website/public/shared/architecture-icon-release/Icon-package_07312026.5846e92413caa21490223536cc97f1269e44fa92.zip"
+          archive :zip
+          extract "Architecture-Service-Icons_07312026/Arch_*/64/*.svg"
+          provenance "provider" => "Amazon Web Services", "version" => "2026-07-31",
+            "license" => "Proprietary — AWS usage terms", "sha256" => SHA256,
+            "homepage" => "https://aws.amazon.com/architecture/icons/",
+            "terms" => "https://aws.amazon.com/terms/"
+
+          private
+
+          def download_file(url, destination)
+            super
+            unless Digest::SHA256.file(destination).hexdigest == SHA256
+              raise DownloadError, "AWS Architecture Icons archive checksum mismatch"
+            end
+          end
+
+          def write_manifest(tmpdir, target_dir)
+            super
+            File.write(Pathname(target_dir).join("ATTRIBUTION.txt"), ATTRIBUTION)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/unmagic/icon/library/source/carbon_pictograms.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Unmagic
+  class Icon
+    class Library
+      class Source
+        class CarbonPictograms < Source
+          key :"carbon-pictograms"
+          title "IBM Carbon Pictograms"
+          description "IBM Carbon pictograms, including the IBM Cloud mark"
+          url "https://registry.npmjs.org/@carbon/pictograms/-/pictograms-12.85.0.tgz"
+          archive :tgz
+          # Use the published SVGs, not src/svg duplicates or JS components.
+          extract "package/svg/*.svg"
+          notices "package/LICENSE", "package/README.md"
+          provenance "provider" => "@carbon/pictograms", "version" => "12.85.0", "license" => "Apache-2.0",
+            "homepage" => "https://github.com/carbon-design-system/carbon"
+        end
+      end
+    end
+  end
+end

data/lib/unmagic/icon/library/source/feather.rb

@@ -8,9 +8,9 @@ module Unmagic
           key :feather
           title "Feather Icons"
           description "Simply beautiful open source icons"
-          url "https://github.com/feathericons/feather/archive/refs/tags/v4.29.1.zip"
+          url "https://github.com/feathericons/feather/archive/refs/tags/v4.29.2.zip"
           archive :zip
-          extract "feather-4.29.1/icons/*.svg"
+          extract "feather-4.29.2/icons/*.svg"
         end
       end
     end

data/lib/unmagic/icon/library/source/gilbarbara_logos.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Unmagic
+  class Icon
+    class Library
+      class Source
+        class GilbarbaraLogos < Source
+          REVISION = "37a6b807fd71c622efea27a9309b5d4edc792969"
+          ROOT = "logos-#{REVISION}"
+
+          key :"gilbarbara-logos"
+          title "Gil Barbara SVG Logos"
+          description "Full-colour technology logos curated by Gil Barbara"
+          url "https://codeload.github.com/gilbarbara/logos/tar.gz/#{REVISION}"
+          archive :tgz
+          extract "#{ROOT}/logos/*.svg"
+          notices "#{ROOT}/LICENSE.txt", "#{ROOT}/README.md", "#{ROOT}/logos.json"
+          provenance "provider" => "gilbarbara/logos", "revision" => REVISION, "license" => "CC0-1.0",
+            "homepage" => "https://github.com/gilbarbara/logos"
+          # Keep upstream names, including slim (the PHP framework). No language
+          # aliases or parent-company fallbacks are inferred from the catalogue.
+        end
+      end
+    end
+  end
+end

data/lib/unmagic/icon/library/source/homarr_icons.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Unmagic
+  class Icon
+    class Library
+      class Source
+        class HomarrIcons < Source
+          REVISION = "c716eb6798576923fa08e9b3e4125173148994ed"
+          ROOT = "dashboard-icons-#{REVISION}"
+
+          key :"homarr-icons"
+          title "Homarr Dashboard Icons"
+          description "Dashboard service logos from Homarr Labs, including light/dark variants"
+          url "https://codeload.github.com/homarr-labs/dashboard-icons/tar.gz/#{REVISION}"
+          archive :tgz
+          # Suffixes such as dagster-light and dagster-dark are part of the name.
+          extract "#{ROOT}/svg/*.svg"
+          notices "#{ROOT}/LICENSE", "#{ROOT}/README.md"
+          provenance "provider" => "homarr-labs/dashboard-icons", "revision" => REVISION, "license" => "Apache-2.0",
+            "homepage" => "https://github.com/homarr-labs/dashboard-icons"
+        end
+      end
+    end
+  end
+end

data/lib/unmagic/icon/library/source/iconoir.rb

@@ -9,12 +9,12 @@ module Unmagic
           key :iconoir
           title "Iconoir"
           description "Free open source icons designed on a 24x24 grid"
-          url "https://github.com/iconoir-icons/iconoir/archive/refs/tags/v7.11.1.zip"
+          url "https://github.com/iconoir-icons/iconoir/archive/refs/tags/v7.12.1.zip"
           archive :zip
           dir "iconoir"
           extract_into(
-            "iconoir-7.11.1/icons/regular" => "regular",
-            "iconoir-7.11.1/icons/solid" => "solid"
+            "iconoir-7.12.1/icons/regular" => "regular",
+            "iconoir-7.12.1/icons/solid" => "solid"
           )
         end
       end

data/lib/unmagic/icon/library/source/lobe_icons.rb

@@ -13,7 +13,7 @@ module Unmagic
           key :"lobe-icons"
           title "Lobe Icons"
           description "Popular AI / LLM model brand logos and icons"
-          url "https://registry.npmjs.org/@lobehub/icons-static-svg/-/icons-static-svg-1.94.0.tgz"
+          url "https://registry.npmjs.org/@lobehub/icons-static-svg/-/icons-static-svg-1.95.1.tgz"
           archive :tgz
           dir "lobe-icons"
           extract "package/icons/*.svg"

data/lib/unmagic/icon/library/source/lucide.rb

@@ -8,7 +8,7 @@ module Unmagic
           key :lucide
           title "Lucide Icons"
           description "Beautiful & consistent icons"
-          url "https://github.com/lucide-icons/lucide/releases/download/1.21.0/lucide-icons-1.21.0.zip"
+          url "https://github.com/lucide-icons/lucide/releases/download/1.49.0/lucide-icons-1.49.0.zip"
           archive :zip
           extract "icons/*.svg"
         end

data/lib/unmagic/icon/library/source/material_file_icons.rb

@@ -11,7 +11,7 @@ module Unmagic
           key :"material-file-icons"
           title "Material File Icons"
           description "Material Design file icons with filename/extension aliases (PKief material-icon-theme)"
-          url "https://registry.npmjs.org/material-icon-theme/-/material-icon-theme-5.35.0.tgz"
+          url "https://registry.npmjs.org/material-icon-theme/-/material-icon-theme-5.38.1.tgz"
           archive :tgz
           dir "material"
           extract "package/icons/*.svg"

data/lib/unmagic/icon/library/source/octicons.rb

@@ -7,10 +7,10 @@ module Unmagic
           key :octicons
           title "Octicons"
           description "Icons and icon font from GitHub"
-          url "https://github.com/primer/octicons/archive/refs/tags/v19.28.1.zip"
-          archive :zip
+          url "https://registry.npmjs.org/@primer/octicons/-/octicons-19.38.0.tgz"
+          archive :tgz
           dir "octicons"
-          extract "octicons-19.28.1/icons/*.svg"
+          extract "package/build/svg/*.svg"
         end
       end
     end

data/lib/unmagic/icon/library/source/silk.rb

@@ -12,7 +12,7 @@ module Unmagic
           description "The classic silk icon set recreated as SVG"
 
           REPO = "frhun/silk-icon-scalable"
-          BRANCH = "main"
+          BRANCH = "master"
           PATHS = [ "baseicons", "extra" ].freeze
 
           private

data/lib/unmagic/icon/library/source/simple_icons.rb

@@ -8,7 +8,7 @@ module Unmagic
           key :"simple-icons"
           title "Simple Icons"
           description "SVG icons for popular brands"
-          url "https://registry.npmjs.org/simple-icons/-/simple-icons-14.2.0.tgz"
+          url "https://registry.npmjs.org/simple-icons/-/simple-icons-16.33.0.tgz"
           archive :tgz
           extract "package/icons/*.svg"
         end

data/lib/unmagic/icon/library/source/tabler.rb

@@ -7,10 +7,15 @@ module Unmagic
         class Tabler < Source
           key :tabler
           title "Tabler Icons"
-          description "Over 5400 free SVG icons"
-          url "https://github.com/tabler/tabler-icons/releases/download/v3.24.0/tabler-icons-3.24.0.zip"
-          archive :zip
-          extract "svg/*.svg"
+          description "Free SVG icons in outline and filled styles"
+          url "https://registry.npmjs.org/@tabler/icons/-/icons-3.48.0.tgz"
+          archive :tgz
+          # Keep outline names at tabler/<name>; filled icons live separately
+          # because both styles share filenames.
+          extract_into(
+            "package/icons/outline" => ".",
+            "package/icons/filled" => "filled"
+          )
         end
       end
     end

data/lib/unmagic/icon/library/source.rb

@@ -85,6 +85,15 @@ module Unmagic
           def extract_into(mapping = nil)
             mapping ? @extract_into = mapping : @extract_into
           end
+
+          # Required upstream legal files, copied alongside the icons unchanged.
+          def notices(*patterns)
+            patterns.empty? ? (@notices || []) : @notices = patterns
+          end
+
+          def provenance(value = nil)
+            value ? @provenance = value : @provenance
+          end
         end
 
         def download(target_dir: default_target_dir, force: false)
@@ -120,15 +129,26 @@ module Unmagic
             download_file(self.class.url, archive_path)
             extract_archive(archive_path, tmpdir, self.class.archive)
 
+            notice_files = self.class.notices.map do |pattern|
+              matches = Dir.glob(File.join(tmpdir, pattern)).select { |file| File.file?(file) }
+              raise ExtractionError, "Missing required attribution: #{pattern}" if matches.empty?
+
+              matches
+            end.flatten
             FileUtils.mkdir_p(target_dir)
+            notice_files.each { |file| FileUtils.cp(file, target_dir) }
             copy_assets(tmpdir, target_dir)
             write_manifest(tmpdir, target_dir)
           end
         end
 
-        # Libraries that ship a file→icon mapping override this to write a
-        # manifest.json into target_dir. Default: nothing.
-        def write_manifest(_tmpdir, _target_dir)
+        # Record opt-in provenance; libraries with file→icon mappings can
+        # override this to write their own manifest.json.
+        def write_manifest(_tmpdir, target_dir)
+          return unless self.class.provenance
+
+          manifest = self.class.provenance.merge("name" => self.class.dir, "archive" => self.class.url)
+          File.write(Pathname(target_dir).join("manifest.json"), JSON.pretty_generate(manifest))
         end
 
         def copy_assets(tmpdir, target_dir)
@@ -305,3 +325,7 @@ require_relative "source/iconoir"
 require_relative "source/material_design_icons"
 require_relative "source/phosphor"
 require_relative "source/lobe_icons"
+require_relative "source/gilbarbara_logos"
+require_relative "source/homarr_icons"
+require_relative "source/carbon_pictograms"
+require_relative "source/aws_architecture_icons"

data/lib/unmagic/icon/version.rb

@@ -2,6 +2,6 @@
 
 module Unmagic
   class Icon
-    VERSION = "0.3.0"
+    VERSION = "0.4.0"
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: unmagic-icon
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Keith Pitt
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-07-31 00:00:00.000000000 Z
+date: 2026-09-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -115,11 +115,15 @@ files:
 - lib/unmagic/icon/library.rb
 - lib/unmagic/icon/library/registry.rb
 - lib/unmagic/icon/library/source.rb
+- lib/unmagic/icon/library/source/aws_architecture_icons.rb
 - lib/unmagic/icon/library/source/bootstrap_icons.rb
+- lib/unmagic/icon/library/source/carbon_pictograms.rb
 - lib/unmagic/icon/library/source/coloured_icons.rb
 - lib/unmagic/icon/library/source/devicons.rb
 - lib/unmagic/icon/library/source/feather.rb
+- lib/unmagic/icon/library/source/gilbarbara_logos.rb
 - lib/unmagic/icon/library/source/heroicons.rb
+- lib/unmagic/icon/library/source/homarr_icons.rb
 - lib/unmagic/icon/library/source/iconoir.rb
 - lib/unmagic/icon/library/source/lobe_icons.rb
 - lib/unmagic/icon/library/source/lucide.rb