icongen 0.6.0

Subsets icon fonts and generates Flutter bindings for them.

0.6.0

• Bumped minimum SDK version to Dart 3.13.

  • Refactored classes and extension types to use Dart 3.13 primary constructors and concise constructor syntax.
  • Reformatted the library with Dart 3.13 formatter changes.

• Bumped dependency constraints.

  • dart_style to ^3.1.12.
  • freezed_annotation to ^3.1.0.
  • harfbuzz_ffi to ^0.5.0.
  • meta to ^1.19.0.
  • woff2_ffi to ^0.2.0.
  • dev:freezed to ^4.0.0-dev.3.

0.5.2

• Fixed mistakenly calculating WOFF2 uncompressed size for some non-WOFF2 fonts.
  • The issue was causing absurdly large allocations before the decompression would fail.
  • Adds a check for the WOFF2 Header signature.
  • Now, non-WOFF2 fonts fill never get passed to the WOFF2 native library.

0.5.1

• Reduced unnecessary memory copies by utilizing Dart native finalizers.

  • Currently, this experimental change only applies to two use cases: decompressing a WOFF2 font before any processing, and compressing subset results to WOFF2.

• Migrated from package:ffi allocators to package:ffi_leak_tracker adaptive allocators.

  • This integration will help track potential native memory leaks.

• Added fromJson() and toJson() to VariableAxisConstraint.

  • Preparing for future file config support.

• Renamed type parameter from ValueType to IdType in writeSubsets() and writeBindings().

  • This does not affect dependents in any way, but improves API clarity.

• Minor internal changes.

• Bumped the harfbuzz_ffi dependency to 0.4.2.

  • Minimum version which supporst HarfBuzz experimental APIs for future use.

• Changed package path in monorepo (from packages/icongen to packages/icons/icongen).

0.5.0

• Renamed bytes parameter to inputBytes in SubsetBuilder and buildSubsets().

• Replaced positional subsetResult parameter with named inputBytes parameter in BindingsBuilder and BindingsEntry.

  • They now accept raw font bytes directly instead of requiring a SubsetResult instance.

• Removed fontFamily and iconGlyphs properties from SubsetResult.

  • SubsetResult and SubsetResultWithId now only store the generated font subset bytes.
  • Removed fontFamily and iconGlyphs parameters from SubsetBuilderResultFactory.

• Migrated entry models (SubsetEntry, BindingsEntry and WriteEntry) away from Freezed data classes to standard immutable Dart classes.

• Added library-level documentation comment to package:icongen.

• Refactored internal low-level HarfBuzz and WOFF2 font parsing and extraction utilities into a shared internal library.

• Updated usage examples.

0.4.1

• Added WOFF2 support via the woff2_ffi package.

  • WOFF2 fonts are automatically decompressed before subsetting.
  • Font format (TTF / WOFF2) is preserved after subsetting.
  • You can use the SubsetBuilder.forceSubset property to override the output format.

• Added SubsetBuilder.forceSubset flag.

  • Defaults to false. Setting to true will enforce a subset even if it would be unnecessary.

• Updated SubsetEntry to support new SubsetBuilder parameters: forceSubset and subsetFormat.

• Added extension methods SubsetBuilder.buildWithId() and BindingsBuilder.buildWithId().

  • They simplify creating SubsetResultWithId or BindingsResultWithId directly, without unnecessary intermediate SubsetResult or BindingsResult.

• Added utility SubsetIdToResultMap<IdType> and BindingsIdToResultMap<IdType> type aliases.

  • They can help when building from multiple font sources with different ID classes.

• Improved internal source file structure.

• Updated .gitignore to use the standard template.

• Clarified uniXXXX icon names filtration in the 0.4.0 changelog.

0.4.0+1

• Fixed grammar mistakes in the 0.4.0 changelog.

0.4.0

• Moved the main APIs away from being ID-aware.

  • Removed generateFontSubsets and generateIconBindings utility functions.
  • Removed automatic font loading functionality for maximum flexibility.
  • The low-level APIs are now fully synchronous, because they don't perform I/O operations anymore.
  • Renamed FontSubsetBuilder to SubsetBuilder, IconBindingsBuilder to BindingsBuilder and marked them as @immutable.
  • Renamed SubsetAxisConstraint to VariableAxisConstraint.
  • Removed type parameters from all low-level classes (SubsetBuilder and SubsetResult no longer accept an ID type parameter).

• Added mid-level utility functions to serve as replacements for the removed ID-based generator APIs.

  • buildSubsets and buildIcons build ID-mapped subsets and icons respectively, fully synchronously.
  • SubsetEntry (replacement for SubsetOutput) and BindingsEntry provide configuration for the build methods.
  • SubsetResultWithId<IdType> and BindingsResultWithId<IdType> represent the results of the build methods.
  • writeSubsets and writeBindings are small utility functions that help write the generated font subset bytes and icon bindings code to the file system. WriteEntry<T> serves as the main primitive for these functions.

• Added a new type to store predefined tags: VariableAxisTag.

  • This extension type is erased at runtime, meaning casts from String are safe for custom axis tags.
  • This class contains extensive metadata about each axis tag defined in the Google Fonts Axis Registry.
  • Added a Python script to generate the data automatically from the latest Google Fonts Axis Registry data.

• Removed the tag property from VariableAxisConstraint.

  • Constraints are now defined by a new type: VariableAxisConstraints, which is a Map<VariableAxisTag, VariableAxisConstraint> - prevents duplicate constraint issues.

• Migrated result models (i.e. SubsetResult, BindingsResult, etc.) away from Freezed data classes because they may store large amounts of data now (Uint8List, etc.).

• Icon names matching the following regular expression are now filtered out: ^u(ni)?[0-9a-fA-F]{4,}$.

• Reviewed and fixed icon identifier sanitization logic.

  • Aligned the reserved keyword list with the Dart language specification.
  • The surrounding class name is now considered a reserved identifier.

• Enabled JSON serialization functionality for VariableAxisConstraint (deserialized based on the type field) and IconGlyph.

• Fixed build_runner builds failing if the example directory had generated icon bindings files which didn't belong to the package.

• Heavily improved internal file structure.

• Updated examples and README.

0.3.0

• Migrated away from discontinued harfbuzz dependency to harfbuzz_ffi, which has fully replaced the former package.
  • Removed discontinued harfbuzz dependency.
  • Bumped harfbuzz_ffi dependency to ^0.4.0.

0.2.0

• The generator will now add fontFamily and fontPackage static constants to generated classes.

  • This information can be used when creating dynamic IconData instances at runtime.

• The generator will now add documentation comments to most of the generated declarations.

• The generator will now sanitize generated icon identifiers which match identifiers of other generated declarations (e.g. fontFamily, fontPackage, forceCompileTimeTreeShaking).

  • This should not affect most icon fonts.

• Disabled formatting in generated source code files.

  • This should reduce line count and improve clarity.

• Updated usage examples.

• Updated package README.

• Removed code_builder dependency due to unnecessary complexity.

  • Icon bindings generator now uses raw strings.

• Bumped meta dependency to ^0.18.0.

  • Aligned with latest stable SDK pinned dependency constraint.

0.1.0

• Initial version.

• Added basic usage example.

• Cleaned up dependencies.