Skip to content

chore: final pre-publish audit — no-theme hardening, SKILLS.md, drift fixes (1.0.3)#43

Merged
SiphoChris merged 1 commit into
mainfrom
chore/final-audit-and-skills
Jun 10, 2026
Merged

chore: final pre-publish audit — no-theme hardening, SKILLS.md, drift fixes (1.0.3)#43
SiphoChris merged 1 commit into
mainfrom
chore/final-audit-and-skills

Conversation

@SiphoChris

Copy link
Copy Markdown
Owner

Final pre-publish audit (4 auditors). No-theme hardening: theme-role sugars fall back to FwTokens.light instead of throwing; new context.fwOrNull. +4 tests (466). SKILLS.md agentic guide. Spec/docs drift fixes; example demos fit(alignment:) + FwScroll(trackColor:). 1.0.3, unpublished; all green; auto-deploys on merge.

… fixes

Comprehensive final pass before publishing 1.0.3 (4 parallel auditors: engine
correctness/guards, drift, docs+example, publish-readiness). Engine was already
correct + value-type-complete + guarded; this closes the remaining gaps.

You're not forced into a theme (the headline fix):
- Theme-role sugars (`fontSans`/`roundedMd`/`shadowMd`) now fall back to the stock
  FwTokens.light defaults when no theme is present instead of throwing — so the
  raw palette + your own fonts work with NO FwTheme at all. New `context.fwOrNull`
  reads tokens without throwing when a theme is optional (FwStyled uses it). Raw
  styling + `font('Family')` already needed no theme; this removes the one sharp
  edge (the role sugars crashing). +4 no-theme tests (466 total).

SKILLS.md:
- A compact agentic-engineering guide (mental model, setup, the .tw API, layout,
  states, fonts, the no-theme path, do/don't rules, recipes, gotchas) shipped with
  the package and linked from the README.

Audit fixes:
- Drift: core-engine spec §5.1/§5.3/§6.4/§12 updated for the FwTheme refactor,
  fwOrNull, theme-resolved fonts, and fit(alignment); barrel + resolve() guard
  message/doc now name fontFamilyStep; CHANGELOG 1.0.3 notes the no-theme fallback.
- Docs: a "You're not forced into a theme" section (theming.mdx) + a no-theme note
  (fonts.mdx) — the maintainer's explicit concern.
- Example: demo `fit(alignment:)` (object-position) and `FwScroll(trackColor:)`.

Still 1.0.3 (unpublished). analyze/format/test clean (engine + example); docs build
+ vitest clean; dry-run = 1.0.3.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@vercel

vercel Bot commented Jun 10, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
flutterbits Ready Ready Preview, Comment Jun 10, 2026 3:43pm

@SiphoChris SiphoChris merged commit 59ed544 into main Jun 10, 2026
7 checks passed
@SiphoChris SiphoChris deleted the chore/final-audit-and-skills branch June 10, 2026 15:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant