Skip to content

v0.1.0

Choose a tag to compare

View all tags
@lair001 lair001 released this 22 Aug 11:42
· 41 commits to main since this release
v0.1.0
40fac6e

Theme Forge Stellar Burst v0.1.0

Theme Forge Stellar Burst (TFSB) is a deterministic declarative SVG compiler, transactional installer, and drift checker. It brings software-engineering discipline to vector asset pipelines by turning human-editable TOML into the canonical single source of truth for SVGs.

Highlights

  • Declarative SVG TOML Schema (schema_version = 1): Define SVGs in clean, human-editable TOML (.tfsb/project.toml and .tfsb/assets/*.toml) with full support for canvases (with optional width/height), accessibility (<title>, <desc>, focusable), linear gradients, groups, stroked/filled paths, presentation attributes (opacity, aria_hidden), and transformed <use> references.
  • Safe In-Memory Archive Import (tfsb import): Import local SVG ZIP archives with fail-closed security: rejects path traversal (..), symlinks, and invalid constructs before writing TOML. Ignores ordinary safe non-SVG entries by default and supports explicit --companion <path> selection.
  • Deterministic Rebuild (tfsb build): Rebuild exact, standards-compliant SVG files from TOML source with deterministic attribute order and byte-for-byte reproducibility, emitting cryptographic .tfsb-build.json receipts.
  • Transactional Installation (tfsb install): Distribute compiled SVGs and companion documents across repository target destinations with atomic writes, backup, and rollback.
  • Cryptographic Drift Detection (tfsb check): Verify that source TOML, build output, and installed target SVGs and companion documents remain perfectly synchronized (exit 0 clean, 1 invalid schema, 2 drift detected).
  • CLI Inspection & Ergonomics (tfsb list, --help, --version): Inspect managed assets, companion documents, target paths, and project structure with ancestor root discovery.
  • Browser Visual Parity Qualified: Tested across Chromium, Firefox, and WebKit to guarantee pixel-equivalent rendering between original imports and rebuilt artifacts.

Scope and Boundaries

  • Bounded Declarative Language: TFSB compiles a bounded SVG declarative language and can carry explicitly selected opaque text companion documents with an SVG bundle. Companion documents are copied byte-for-byte; they are never parsed as SVG, transformed, executed, or generalized into arbitrary package installation.
  • Runtime: Requires Node.js >=22.0.0.
  • Format: SVG-only and opaque text companion documents. Does not process raster images or font packages.
  • Bounded Subset: Bounded declarative SVG profile. Scripts, CSS stylesheets, animations, filter effects, and foreign XML elements fail closed rather than guessing or silently degrading.
  • Local Confinement: Operates strictly on local file archives and strictly confines all write operations to the project directory boundary.

Installation

npm install --global @knowledge-forge-ai/theme-forge-stellar-burst

Quick Start

# 1. Import local SVG zip (optionally selecting companion documents)
tfsb import path/to/assets.zip --root . --companion README.md

# 2. Build canonical SVGs
tfsb build

# 3. Install to configured project locations
tfsb install

# 4. Check for any source/build/install drift
tfsb check

License

GNU Affero General Public License v3.0 or later (AGPL-3.0-or-later). Commercial licensing options are available for proprietary terms (COMMERCIAL-LICENSE.md).

Assets 2
Loading