Skip to content

Releases: formtrieb/cdf-core

@formtrieb/cdf-core v1.0.2 — first OIDC release

26 Apr 16:11

Choose a tag to compare

First Trusted Publishing (OIDC) release. Release-mechanism only — no code changes. Validates that:

  • GitHub Actions environment npm is configured on the repo
  • npm trusted publisher is registered for @formtrieb/cdf-coreformtrieb/cdf-core / publish.yml / npm
  • Workflow publishes via id-token: write with npm publish --provenance --access public, no NPM_TOKEN secret

The bootstrap token used for v1.0.1 has been revoked. From this version onward every git push origin vX.Y.Z auto-publishes via OIDC with SLSA provenance.

See CHANGELOG.md.

@formtrieb/cdf-core v1.0.1 — Initial public release

26 Apr 15:45

Choose a tag to compare

Changelog

All notable changes to @formtrieb/cdf-core are documented here.

The format is based on Keep a Changelog,
and this project adheres to Semantic Versioning.

[1.0.1] — 2026-04-26

First usable public release. v1.0.0 was published earlier the same day
without compiled output (a stale incremental-build cache shipped an empty
tarball); it has been unpublished from the registry. v1.0.1 ships the
intended initial-release contents and is byte-equivalent to what v1.0.0
should have been; future releases will use Trusted Publishing (OIDC) via
GitHub Actions.

The library shipped under workspace:* inside the Formtrieb monorepo for
~6 weeks; this version strips the monorepo-internal coupling and re-
publishes it as a standalone npm package, paired with the v1.0.0 release
of the formtrieb/cdf spec repository.

Surface

Area Symbols
Parsing parseCDF, parseCDFFile, parseConfig, parseConfigFile, parseProfile, parseProfileFile
Validation validate, validateFile, validateAll, validateProfile, validateProfileFile
Resolution resolveInheritance, resolveExtension, expandTokenPath
Analysis analyzeCoverage, analyzeComponentCoverage, suggestImprovements, detectVocabDivergences
Profile scaffolding scaffoldProfile, parseScaffoldInput, aggregateRawMaterial, enrichRawMaterial, applyStructuralDeltas
Token tree TokenTree, RawToken, TokenExtensions, ColorModifier
Vocab divergence apply applyComponentRename

See src/index.ts for the full export list.

Spec coverage

  • CDF v1.0.0 frozen (Component / Profile / Target / Architecture)
  • ≥30 validation rules across L0–L8
  • Validated against five foreign design systems: Radix, shadcn, Primer,
    Material 3, USWDS

Engineering

  • Node ≥ 20
  • ESM only ("type": "module")
  • TypeScript strict mode, ES2022 target
  • 423 tests, 0 failures
  • Apache-2.0 licensed