Skip to content

v0.3.0

Choose a tag to compare

View all tags
@lair001 lair001 released this 24 Aug 13:37
v0.3.0
ebb6039

Theme Forge Stellar Burst v0.3.0

Theme Forge Stellar Burst (TFSB) v0.3.0 advances the vector asset compiler and lifecycle system with productized archive analysis, Schema 2 TOML/SVG representation, typed primitive shapes and transformations, granular accessibility modes, explicit exact-common normalization, paired provenance schema 2, deterministic schema 1 to schema 2 migration, schema-2 reconciliation, raw versus normalized archive diffing, deterministic bundle/manifest compatibility, offline scriptless preview galleries, and frozen backward compatibility for schema 1 projects.

Highlights

  • Productized Pre-Import Analysis (tfsb analyze):
    Inspects upstream SVG archives and directory trees prior to import, classifying each entry into directly_importable, importable_with_normalization, unsupported, or unsafe. Provides per-asset and aggregate scan evidence, omission reporting, and deterministic single-envelope machine JSON (--json).

  • Schema 2 Vector Model & Typed Primitives:
    Introduces Schema 2 project and asset formats (schema_version = 2) supporting typed geometric primitives (circle, ellipse, rect, line, polyline, polygon), root and element-level presentation attributes, currentColor tokens, typed transforms (translate, scale, rotate), mixed and nested groups (up to depth 8), and typed local definitions and <use> references.

  • Granular Accessibility Modes:
    Provides structured accessibility modeling with three distinct modes:

    • labelled: Authored <title> and <desc> metadata.
    • decorative: Pure visual elements with explicit aria-hidden="true".
    • consumer_labelled: Reusable glyphs where accessibility is deferred to consumer context.

  • Direct Canonical Schema-2 Import & Exact-Common Normalization:
    Supports direct transactional import of canonical Schema 2 SVG archives (--schema 2), as well as explicit, deterministic normalization of common web SVGs (--normalize exact-common) backed by normalization map schema 1 (--normalization-map <file.toml>) and cryptographic tfsb-normalization-policy-v1 policy digests.

  • Provenance Schema 2 & Deterministic Migration (tfsb migrate):
    Maintains complete cryptographic paired-checkpoint provenance for both Schema 1 and Schema 2 assets (.tfsb/provenance.json schema 2). Provides safe, deterministic, whole-project migration from Schema 1 to Schema 2 (tfsb migrate) with non-destructive dry-run planning (--check), rollback safety, and verified byte-for-byte SVG and companion equivalence.

  • Schema-2 Reconciliation & Multi-Baseline Archive Diffing:
    Reconciles upstream archive revisions against Schema 2 canonical models and provenance records. Supports granular diffing (tfsb diff) against raw archive sources (--archive) and normalized canonical baselines.

  • Deterministic Bundling, Manifest Compatibility & Offline Previews:
    Exports and imports store-only deterministic ZIP bundles (tfsb bundle) with tfsb-manifest.json metadata. Generates offline, scriptless, fully escaped static HTML/CSS visual preview galleries (tfsb preview) across multi-size responsive grids.

  • Schema-1 Frozen Compatibility:
    Maintains complete backward compatibility for existing Schema 1 projects, preserving exact historical SVG compilation, build, install, check, list, format, and diff semantics.

Limits and Operational Boundaries

  • Archive Entries: Maximum 1,024 entries per archive.
  • Selected SVG Assets: Maximum 128 selected/mutating SVGs per project.
  • Per-Entry Size: Maximum 8 MiB per selected archive entry.
  • Selected Aggregate Size: Maximum 32 MiB aggregate selected uncompressed bytes.
  • Raw Archive Size: Maximum 128 MiB raw ZIP archive size.
  • Modeled Elements: Maximum 1,024 modeled element nodes per asset.
  • Group Nesting Depth: Maximum group nesting depth of 8.

Explicit Exclusions

  • No arbitrary XML or non-SVG namespaces.
  • No arbitrary CSS styling, inline <style> tags, or style attributes.
  • No embedded scripts (<script>), event handlers, <image> raster references, <foreignObject>, animations, or external URL references (http://, https://, data:, //).
  • No full external warehouse lifecycle claim.
  • No path-derived collection or directory identity.
  • No directory import or directory reconciliation.
  • No mutation limits above the established boundaries.
  • No Studio / GUI application.

Upgrading from v0.2.0

  1. Schema 1 Projects: Existing Schema 1 projects continue to function without modification.
  2. Migrating to Schema 2: Run tfsb migrate --check to preview migration changes, then tfsb migrate to atomically upgrade .tfsb/project.toml, .tfsb/assets/*.toml, and .tfsb/provenance.json to Schema 2.
  3. Receipts: Run tfsb build to ensure build receipts are synchronized with the current toolchain.

Installation

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

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