Aurum Changelog

All notable changes to the Aurum design system are documented here.

Format follows Keep a Changelog.

[Unreleased]

Added

• AurumGlobalHeader — persistent top bar for top-level destinations (component/navigation/). Mapped to Figma Global Header (5252:2274). Sealed AurumGlobalHeaderRightContent with two variants: Default (optional Support pill + optional Rewards/Notifications pill) and LivePrice (live gold-buy-price pill on a dark surface + optional Rewards/Notifications pill). Each pill is 44 dp tall, 22 dp corner radius, 1 dp interactive/border/neutral/muted border, with a subtle aurumRadialBrush sheen overlay matching Figma's SVG-encoded radial fill. Profile pill accepts either an ImageVector glyph (default AurumIcons.User.User) or a caller-supplied profileContent slot — the slot pattern lets consumers render URL-loaded avatars (Glide / Coil) without dragging an image-loading dep into Aurum. Ships Code Connect mapping (AurumGlobalHeader.figma.kt), MCP-readiness KDoc tags (@AurumIntendedUse + 3 × @AurumDo + 3 × @AurumDont), and 6 @AurumPreview previews covering all variant combinations. Catalog NavigationDemo extended with three live examples.
• AurumTab + AurumTabRow — tab navigation family (component/navigation/). Mapped to Figma _Tabs (5430:3115) and GroupRoot (5531:795). AurumTab is a scratch composable (Foundation Box + Row + selectable, role = Role.Tab) with an optional leading ImageVector icon at Aurum.iconSize.xl (24 dp) and a label rendered at Title/XS-Bold (14/20 sp, Bold 700) with TextOverflow.Clip. Selected uses interactive/text/primary/normal + interactive/icon/primary/normal; unselected uses interactive/text/neutral/subtle + interactive/icon/neutral/subtle. No disabled variant — Figma's _Tabs set has none; callers omit unavailable destinations. AurumTabRow uses a SubcomposeLayout probe pass to measure each tab's natural width, then auto-fits or scrolls: when tabCount × max(widestNatural, 100.dp) ≤ viewport it wraps material3.PrimaryTabRow and tabs flex to share the row equally (matching Figma's two/three-tab flex-[1_0_0] variants); otherwise it wraps material3.PrimaryScrollableTabRow and pins each tab to the computed width via LocalAurumTabWidth (matching Figma's four-tab fixed-100px+scroll variant and gracefully extending to 5 + tabs). Indicator is borderWidth/lg (2 dp) interactive/border/primary/default; bottom divider is borderWidth/sm (1 dp) interactive/border/neutral/highlighted. Both ship Code Connect mappings (AurumTab.figma.kt, AurumTabRow.figma.kt) and 10 @AurumPreview previews including a 640 dp tablet tile and a 5-tab scroll demo. Catalog TabGallery added under Navigation with two/three/four/with-icons sections.

[0.3.0] - 2026-05-04

Added

• AurumCheckbox + AurumCheckboxGroup — multi-select selection family (component/selection/). AurumCheckbox is a tri-state control (AurumCheckState.Unchecked / Checked / Indeterminate) mapped to Figma 5169:1314. Closed enum chosen over Boolean? to avoid null-as-indeterminate ambiguity. Mirrors AurumRadioButton's API: selected, onCheckStateChange, label, subtext, enabled, error, labelPosition (End/Start). The 24 dp box is rendered via Canvas — checked state fills with Aurum.colors.interactive.bgPrimaryDefault and overlays a stroked checkmark; indeterminate fills the box and overlays a centred horizontal bar; error tints both outline and glyph with feedback-negative. AurumCheckboxGroup<T> mirrors AurumRadioGroup<T> but with selected: ImmutableSet<T> and onSelectionChange: (T, Boolean) -> Unit; uses triStateToggleable per row so Indeterminate → Checked advancement is a single tap. Both ship Code Connect mappings (AurumCheckbox.figma.kt at 5169:1314, AurumCheckboxGroup.figma.kt at 5169:1796) plus 8 + 5 @AurumPreview previews. Catalog SelectionDemo extended with single-checkbox and group examples.
• AurumAmountInput — currency-prefixed numeric input mapped to Figma 5080:261 (component/field/AurumAmountInput.kt). Delegates to AurumTextField for state, validation, helper/error/success text, label plumbing — currency symbol (default ₹) is rendered in the leading slot using Aurum.type.headingLarge; optional suffixText (e.g. "0.0097 g") sits in the trailing slot. loading = true swaps the trailing slot for an inline AurumLoader(size = Aurum.iconSize.lg) and forces read-only. Caller is responsible for formatting both value and suffixText (locale + currency conventions are app-level concerns) — flagged in KDoc. Numeric keyboard via KeyboardOptions(keyboardType = KeyboardType.Number). 8 @AurumPreview previews + Code Connect.
• AurumNavBar + AurumNavBarItem — bottom navigation family (component/navigation/). Mapped to the layout component_set at Figma 5575:14226. AurumNavBar is a slot-based composable taking an ImmutableList<AurumNavBarItem> (label + line/fill icon pair) plus selectedIndex, onSelect, and a layout: AurumNavBarLayout. AurumNavBarLayout is a sealed interface exposing four data variants — Standard3, Standard4, Standard5, CenterQr5(onQrClick) — each carrying an itemCount enforced via require() at composition time. CenterQr5 takes 4 items (the QR action is rendered by the layout, not surfaced as an item) and inserts the raised QR FAB between items 1 and 2 using AurumIcons.Action.QrCode. The per-cell renderer AurumNavBarCell is private — exposing it would only invite cells without a parent bar. 6 @AurumPreview previews (one per layout + selected-state variants) + Code Connect. Catalog NavigationDemo extended with all 4 layouts running interactive selectedIndex state.
• AurumTransactionListCard — opens the Cards family (component/card/, new package). Mapped to Figma 5576:19749. Status-tinted card (AurumTransactionStatus.{Success, Error, Pending}) composing AurumSurface + AurumText + AurumIcon. Outer wash uses Aurum.colors.feedback.{positive, negative, notice}/subtle; status badge icons map to the new AurumIcons.Status.{Success, Warning, Pending} glyphs landed in v0.2.1; amount and helper-text colours match the wash family. Caller hands in pre-formatted strings for dateText and amount — no locale or currency handling inside (consistent with AurumAmountInput). helperText and leadingIcon are optional. 7 @AurumPreview previews + Code Connect. Standalone CardDemo composable wired into the catalog showcase as a new "Cards" section between Navigation and Chips.

Changed

• tooling/gallery/generate.py — registered the card family in FAMILY_LABELS so the gallery site renders the new component/card/ family with a proper "Cards" heading rather than falling back to the raw directory name.
• AurumLinkButton Code Connect mapping validated against Figma 4784:1286 ("Component 1") — the existing AurumLinkButton.figma.kt already targets the right node, no changes needed. The Figma component name is misleading ("Component 1") but the underlying variant=link button axis maps cleanly.

Manifest

• Manifest jumps from 24 → 28 components: AurumAmountInput, AurumCheckbox, AurumCheckboxGroup, AurumNavBar, AurumTransactionListCard (5 new) — AurumNavBarItem is a public data class but not a composable, so it doesn't count. Code Connect mappings 150 → ~158. Schema version unchanged ("2"); changes are additive.

Known gaps

• Icons/NEK (Figma 5566:781) is referenced by Jar's nav bar item set but not yet imported into AurumIcons. Catalog NavBar previews use placeholder icons (Home, Gift, Document, etc.) so compile + render succeed. Action: design to confirm the canonical NEK glyph node, then add an IconEntry to tooling/icons/import_from_figma.py:ICON_MANIFEST and re-run make icons-import.
• Icons/Check still resolves to a single-weight glyph (5308:800); Icons/Check at 5480:5047 remains an empty/orphaned component in Figma (see v0.2.1 ghost-component note in add-an-icon.md). No action.

[0.2.1] - 2026-05-04

Added

• 11 new Figma-derived icons imported via tooling/icons/import_from_figma.py. Sourced authoritatively from the Jar Light Design System file (YvIxqu2oTlM6UnkL0OloHc) by enumerating every Icons/* master component via the Figma REST /v1/files/{key}/components endpoint and diffing against ICON_MANIFEST. Each ships a 24×24 vector drawable + AurumIcons accessor (line + filled) + per-weight Code Connect mapping. Breakdown: AurumIcons.Action.{Minus, MoreHorizontal}, AurumIcons.Content.Image, AurumIcons.Status.{Pending, Warning, Success, Loader}, AurumIcons.Commerce.Withdraw. Single-weight icons (Success, Loader, Selection.Check) reuse the same Figma node id for both weights, producing identical line/fill XMLs while keeping the <Name> + <Name>Filled API contract intact.

Changed

• AurumIcons.Action.Add and AurumIcons.Action.Overflow now Figma-derived. Previously hand-drawn aurum_ic_action_add.xml and aurum_ic_action_overflow.xml are replaced with imports from Figma's Icons/Plus (5322:1592/5322:1593) and Icons/DotsThreeVertical (5431:2848/5431:2850). Public Kotlin API names unchanged — call sites in AurumButton, AurumIconButton, AurumTextField, and AurumTopAppBar need no edits. Their Filled accessors (AddFilled, OverflowFilled) are now also available.
• AurumIcons.Selection.Check now Figma-derived. Hand-drawn aurum_ic_selection_check.xml replaced with import from Figma's Icons/Check (5308:800). Used by AurumSwitch for the on-state tick. Initial discovery missed this node because the file's components index points at a stale duplicate (5480:5047) that's an empty/orphaned component; 5308:800 lives near the Warning glyphs and renders fine. Aurum now has zero hand-drawn icons — every icon flows from Figma through make icons-import.
• Icons/X (Close) fill node updated from 5162:954 → 5311:823. Design moved the X fill variant; the old node returns null from /v1/images. Visual unchanged.
• tooling/icons/import_from_figma.py cleanup. Removed the special-case blocks at the end of generate_aurum_icons_kt that hand-wired Action.Add, Action.Overflow, and Selection.Check from legacy XMLs — all three are now regular IconEntry rows. Added selection to CATEGORY_ORDER + CATEGORY_DOCSTRINGS. Removed aurum_ic_selection_check.xml from the obsolete-detection exception set.
• aurum-catalog/.../IconGallery.kt extended with the 11 new icons (Action, Content, Status, Commerce sections) plus a new Selection section showing Check.

Tooling

• Documented icon ghosts in aurum/docs/workflows/add-an-icon.md. Five Icons/* names appear in the file's /components index but are deleted/orphaned components in Figma — opening their URLs prompts a "Restore component" dialog and /v1/images returns null. They are NOT placeholders awaiting drawings: Icons/InstantSave (5343:1795/1796), Icons/DailySavings (5343:1779/1780), Icons/WeeklySavings (5343:1781/1782), Icons/MonthlySavings (5343:1783/1784), older Icons/Withdraw on 5343:* (superseded by the live pair at 5358:456/5358:465 which is imported as Commerce.Withdraw). The doc explicitly tells future contributors to skip them rather than chase a "fix it in Figma" thread.

Manifest

• Manifest jumps from 60 → 68 icons. Code Connect mappings 130 → 150. Components count unchanged (24).
• Schema version unchanged ("2"); changes are additive on the existing icon list.

[0.2.0] - 2026-05-04

Tooling

• MCP manifest schema v2 — enrichment fields for aurum-mcp v0.3. Bumped tooling/manifest/schema.json schemaVersion enum from ["1"] to ["1","2"] and added four optional, additive fields:
• component.intendedUse: string — when-to-reach-for prose authored in a new @AurumIntendedUse KDoc tag.
• component.usage: { do: string[]; dont: string[] } — guardrails authored in @AurumDo / @AurumDont KDoc tags (one bullet per tag instance).
• component.relatedTokens: string[] — qualified Aurum token names (surface.bgPageBase, spacing.s12, typography.bodyMedium) the component references in its source. Static-analyzed by analyze_token_refs(source) against Aurum.{colors,space,type,radius,borderWidth,elevation,iconSize}.<leaf> accessors.
• icon.tags: string[] — hand-curated synonyms (Delete → [trash, remove, bin, garbage, discard]) sourced from a new aurum/icons/tags.toml file. Powers the synonym-aware aurum_search_icons tool.

All four are absent from v1 manifests and ignored gracefully by older readers. The generator emits schemaVersion: "2" whenever any of them are populated, otherwise stays on "1".

• @AurumIntendedUse / @AurumDo / @AurumDont KDoc tags authored on all 24 components. Every component in the manifest now carries intended-use prose + Do/Don't guardrails. Counts: 24 × intendedUse, 70 total do entries, 70 total dont entries. The 6 priority components (Chip, Button, RadioButton, RadioGroup, TopAppBar, OtpInput) landed first; this extends coverage to AurumIconButton, AurumLinkButton, AurumTextField, AurumPhoneNumberInput, AurumSearchField, AurumSwitch, AurumBadge, AurumLoader, AurumSkeleton, AurumSectionHeader, AurumSurface, AurumScreen, AurumSnackbar, AurumStepper, AurumDivider, AurumIcon, AurumText, AurumLabel. Tags are stripped from the rendered KDoc body and re-emitted as structured manifest fields.
• Cross-repo dispatch wired up. Committed .github/workflows/notify-mcp.yml, which fires a repository_dispatch: aurum-content-changed event at Changejarapp/aurum-mcp on every push to main and every release. Drops the manifest-sync latency in aurum-mcp from ≤24 h (cron) to ~1 min. Requires the MCP_DISPATCH_PAT org secret (a fine-grained PAT scoped to aurum-mcp with Actions: read+write).
• README — manifest pipeline section. Documents how component changes propagate to aurum-mcp end-to-end: pages.yml → manifest URL → notify-mcp dispatch → sync-manifest auto-PR → human merge + release dispatch. Includes the @AurumIntendedUse / @AurumDo / @AurumDont authoring convention and the aurum/icons/tags.toml synonym format with quality-bar guidance.
• aurum/icons/tags.toml — curated synonyms for all 60 icons across 9 categories (Action / Commerce / Content / Media / Navigation / Selection / Status / System / User). 222 tags total. Format is TOML keyed by category → icon name → tag list.
• Pages workflow now publishes the manifest. .github/workflows/pages.yml invokes generate.py --emit-manifest build/gallery/data/manifest.json --also-build-gallery --validate on every deploy, exposing https://changejarapp.github.io/aurum-android/data/manifest.json (previously 404). Closes the cross-repo sync gap that left aurum-mcp's drift-check soft-failing on every PR.
• MCP manifest pipeline. Added tooling/manifest/schema.json defining a JSON Schema for an LLM-consumable Aurum manifest, and extended tooling/gallery/generate.py with --emit-manifest <path> and --validate flags. The same parsers that drive the static gallery now also emit a structured JSON describing every component (KDoc + signature + params + Figma deeplink + Code Connect path + gallery URL), every token (semantic colour / visual palette / spacing / radius / border-width / icon-size / elevation / typography), every icon (with paired line/fill Figma node IDs), every Code Connect mapping, and the full Keep-a-Changelog history. Single source of truth, two render targets — HTML for humans, JSON for agents. Consumed by the new atri-jar/aurum-mcp (and later Changejarapp/aurum-mcp) MCP server. Manifest carries a platforms[] field on each component for forward-compatible cross-platform support (aurum-ios plugs in as a sibling manifest source without restructuring).

[0.1.5] - 2026-04-28

Fixed

• All 114 icons re-rendered to match Figma. The previous import pipeline used Figma MCP asset URLs that returned only the inner SVG path with viewBox set to the path's tight bounding box (e.g. 7.5 × 13.5 for ChevronRight). Combined with width/height = 24dp, this caused non-uniform stretch and stripped the surrounding 24×24 frame padding — the chevron rendered fat and squashed, every other non-square icon was distorted, and even square-bbox icons lost their intended 2-3 dp inset.
• Stroke-only icons no longer get a fill. Phosphor regular-weight SVGs carry fill="none" at the <svg> root, cascading to children. The previous import didn't honour the cascade and emitted both fillColor and strokeColor — so e.g. Home rendered as a solid black house instead of the intended outline.

Changed

• Icon import pipeline rewritten to fetch via the Figma REST API (/v1/images?…&format=svg) using $FIGMA_ACCESS_TOKEN. REST exports include the 24×24 frame and proper SVG-level fill cascade, so the conversion is a clean 1:1 to Vector Drawable. The per-icon COMPOUND_TRANSLATES workaround (previously hand-coded for SpeakerSimpleX) is no longer needed and was removed. The stale figma-icon-urls.json URL manifest was deleted.

Added

• /icons.html page on the gallery website — every icon's line + fill weights side by side, grouped by category, with live search and click-to-copy on AurumIcons.<Category>.<Symbol>. Reads AurumIcons.kt and inlines each Vector Drawable as currentColor SVG so icons follow the page theme. No longer need to install the catalog APK to scan the icon set.

[0.1.4] - 2026-04-28

Changed

• AurumChip realigned with the Figma "Action" chip component (YvIxqu2oTlM6UnkL0OloHc, node 4446-701). Adds size (AurumChipSize.Large / Small) and leadingIcon parameters; height tightened to 38 dp Large / 30 dp Small (from 40 dp); padding now asymmetric (12 dp text-side, 8 dp icon-side); inter-element gap reduced 8 → 4 dp; text style varies by size (titleT2 / bodySmall). Existing call sites are unaffected — new parameters default to the prior behaviour. Previews regrouped into Large-trailing / Large-leading / Large-both / Large-text-only / Small / Disabled.
• Code Connect for AurumChip picks up the new Size axis (large ↔ Large, small ↔ Small).

[0.1.3] - 2026-04-27

Added

• Compose perf guardrails. Detekt + mrmans0n/compose-rules wired in, with the perf/stability rules active (UnstableCollections, MutableStateAutoboxing, MutableParams, MutableStateParam, LambdaParameterInRestartableEffect, Material2). Compose Compiler Metrics enabled on :aurum and :aurum-catalog (build/compose_compiler/).
• Compose stability CI gate. New verifyComposeStability Gradle task in :aurum fails the build when aurum_release-classes.txt reports more inferred-unstable classes than composeStabilityThreshold (currently 0). Wired into check.yml after detekt.
• Compose metrics dashboard deployed alongside the gallery at changejarapp.github.io/aurum-android/metrics/, rendered from build/compose_compiler/ via PatilShreyas/compose-report-to-html. Per-PR compose-metrics artifact uploaded by check.yml.
• Aurum icon set — 57 icons × 2 weights = 114 vector drawables imported from the Figma "Component Icons" frame, exposed under AurumIcons.<Category>.<Name> (and <Name>Filled for the fill variant). 8 categories: Navigation, Action, Content, Media, Commerce, System, Status, User. Ingested by the new tooling/icons/import_from_figma.py script (make icons-import); idempotent re-runs.
• IconGallery screen in the catalog showing every icon × weight, grouped by category.
• 114 Code Connect mappings for the new icons under aurum/src/main/kotlin/com/jar/app/aurum/component/icon/figma_connect/AurumIcon*.figma.kt. Auto-published to Figma via the figma-code-connect.yml workflow.

Changed

• 6 overlapping icons replaced from the Figma source-of-truth: Navigation.Back→ArrowLeft, Navigation.ChevronForward→ChevronRight, Media.Like→Content.Heart (renames; 12 call-site migrations across AurumTopAppBar, AurumChip, AurumSectionHeader, AurumLinkButton, and the catalog gallery). Navigation.Close, Action.Edit, Action.Search kept their names — only their underlying XML content was replaced.
• 5 components marked codebase-only: AurumSearchField, AurumIconButton, AurumDivider, AurumLoader, AurumSkeleton — verified absent from the Figma library via MCP search. File-level marker added so future Code-Connect audits don't keep flagging them.
• AurumIcons.kt regenerated from the import script. The 3 legacy entries that lack a Figma counterpart (Action.Add, Action.Overflow, Selection.Check) remain hand-authored under res/drawable/ and are flagged in-file pending design escalation.
• record.yml now also dispatches pages.yml after committing fresh baselines on main, so the gallery's snapshot embeds redeploy without a manual trigger.

Fixed

• AurumOtpInput: keyed LaunchedEffect on the completion-boundary transition (value.length == maxLength) instead of value itself, so the coroutine no longer relaunches on every keystroke.
• AurumSkeleton: moved the shimmerProgress state read out of the drawWithCache cache block and into onDrawBehind, so the cache is no longer invalidated on every animation frame. The gradient colors list is now remember-ed.
• AurumText: inlineContent parameter typed as ImmutableMap<…> instead of Map<…>, restoring skippability (caught by the new compose-rules UnstableCollections rule).
• CI Java mismatch: compose-report-to-html v1.5.0 JAR is built against Java 21; check.yml and pages.yml now install JDK 21 alongside JDK 17 and invoke the JAR via $JAVA_HOME_21_X64/bin/java.

Tooling

• New Makefile targets: make lint-compose, make compose-metrics, make compose-metrics-html, make icons-import, make icons-brand (rename of the prior make icons for clarity vs the new icon-set sync).
• New tooling scripts: tooling/icons/import_from_figma.py (Figma SVG → Vector Drawable + AurumIcons.kt + Code Connect codegen) and tooling/gallery/render_metrics_index.py (gallery /metrics/ landing page).

[0.1.2] - 2026-04-23

Added

• Screenshot testing via Roborazzi + ComposablePreviewScanner. 334 baseline

PNGs committed under aurum/src/test/snapshots/ (Git LFS-tracked) covering

every @Preview and every tile of the @AurumPreview 6-device fan-out.

Any visual regression fails CI before merge. Tasks: recordRoborazziDebug

(refresh baselines), verifyRoborazziDebug (CI check), compareRoborazziDebug

(diff without failing).

• .github/workflows/check.yml — PR + main-push workflow running library +

catalog build, lint, and snapshot verification. Diff PNGs uploaded as a

workflow artifact on any screenshot drift so design reviewers can eyeball

the exact delta.

• Git LFS (.gitattributes) tracking aurum/src/test/snapshots/**/*.png

— keeps pack files small, surfaces binary diffs in PR UIs.

[0.1.1] - 2026-04-23

Changed

• Maven coordinate realigned with Jar's library convention.
• Before: com.jarapp:aurum:<ver>
• After: com.jar.internal.library.aurum-android:core:<ver>
• Kotlin import package inside the AAR stays com.jar.app.aurum.* — no source rename.
• This lets consumers resolve Aurum via the existing Changejarapp/* wildcard

Maven repo in jar-android/settings.gradle.kts, identical to how

com.jar.internal.library.core-network:shared and siblings are resolved.

• The previous com.jarapp:aurum:0.1.0 artifact is stale and should not be

consumed — it's kept in GitHub Packages only to avoid the "published once,

cannot re-publish the same coord" rule.

Removed

• AurumElevation.toast + ElevationTintColors.toast + AurumLightElevation.toast entry + AurumLightColors.elevationTint.toast value — Figma ships only a tint for elevation/_toast (no dedicated dims) and the fallback shape matched lowRaised, so the Kotlin surface added API surface without semantic value. Snackbars/toasts now use Aurum.elevation.lowRaised directly. The plugin mapping (figma-plugin-aurum-sync) marks _toast as an explicitly skipped elevation token and bumps to 0.1.1.

Added

• AurumColors.visual — new decorative palette subgroup exposing 77 chromatic tokens (blue/green/orange/pink/purple/red/yellow × shades 50…1000). Mirrors Figma's visual_colors collection 1:1 and sources values from AurumPalette primitives. Feature code uses Aurum.colors.visual.<family><shade> for palette-keyed decorative colours that have no semantic meaning. Raw AurumPalette stays internal.
• AurumPhoneNumberInput — phone-number variant of AurumTextField with country-code prefix slot, optional flag composable, digit-only input filter, KeyboardType.Phone, and a default 10-digit max length. Mirrors the Figma "Phone Number Input" component set.
• AurumTextField.figma.kt — Code Connect stub against Figma 4623:373 mapping state, validationState, multi_line, label, showHelpText to AurumTextField API props.
• AurumPhoneNumberInput.figma.kt — Code Connect stub against Figma 4904:2455 mapping state, validationState, hasValue, label, showHelpText.
• AurumOtpValidationState.Timer — fourth validation state for resend-countdown UX. Renders identically to None but provides a semantic channel matching the Figma validationState=timer variant.
• Modifier.aurumHardShadow(color, offsetY, shape) — solid-colour offset drop shadow for skeuomorphic "stacked card" effects (matches Figma's shadow(0, Ypx, 0, 0, color) spec). Encapsulates the double-box idiom into a single modifier that expands layout by offsetY and paints the shape outline behind content.

Fixed

• AurumOtpInput disabled digits now use surface.textDefaultDisabled (matching Figma text/default/disabled) instead of textDefaultNormal at 10% alpha.
• AurumTopAppBar synced to Figma 4826:1057 Page Header: title uses SemiBold (was Medium); subtitle uses labelL2 Medium 12/16 in textDefaultNormal (was bodyB3 Normal in textDefaultSubtle); primary button uses SemiBold label and natural 36 dp height from 8 dp padding (was fixed 32 dp, Medium); back + action icons tint via interactive.iconNeutralNormal (was surface.textDefaultNormal — same hex, correct token). Docstring fix: icon wrapper is 32 × 40 dp (w × h), not 40 × 32.
• AurumBadge synced to Figma 4240:10843: both emphases now render at Label/L-Medium (12/16 Inter Medium) — previously had a 18 sp line-height and Intense emphasis rendered Normal weight. Emphasis-specific text styles collapsed to a single shared style.
• AurumSectionHeader synced to Figma 3702:162168: title, link label, and text-action label render SemiBold (Title/S-SemiBold / Title/XS-SemiBold); icon-action tint uses interactive.iconNeutralNormal (was surface.iconDefaultNormal — same hex, correct semantic).
• AurumSwitch synced to Figma 4018:557: thumb now uses interactive.bgNeutralInverse (was surface.bgPageBase — same hex, correct semantic); checked icon uses interactive.iconPrimaryNormal (was bgPrimaryDefault); disabled-checked icon uses interactive.iconNeutralDisabled (was bgNeutralDisabled — real hex drift fixed).
• AurumStepper synced to Figma 3834:139631: numeric value and ± symbols render Bold (Num/XS); Neutral and Brand state colours moved to the interactive.* token family; disabled-state bg/border/icon hexes corrected (#6C849D17 / #C3C7D1 were previously rendering as #ECEEF3 / #848A99).
• AurumLabel synced to Figma 3774:137816: all variants render Medium weight (was SemiBold); Strong variant now uses labelL2 size (was labelL1) and feedback.textPrimaryIntense colour (was surface.textDefaultNormal).
• AurumButton synced to Figma 4692:1074: primary-disabled text token changed to textPrimaryDisabled (was textOnPrimaryDisabled); secondary variant border uses borderPrimaryDefault when enabled and borderNeutralMuted when disabled (was borderNeutralDefault / borderNeutralDisabled).

[0.2.0] - 2026-04-16

Added

• Figma Code Connect infrastructure: Gradle plugin, CLI, *.figma.kt pattern
• AurumIcons namespace with 8 XML Vector Drawables from Figma exports
• AurumLinkButton — new component from Figma Button page
• AurumBadge — 6 colors × 2 emphases × 2 sizes from Figma
• AurumOtpInput — digit-by-digit OTP from Figma spec
• AurumStepper — numeric +/− from Figma spec
• AurumLabel — styled text label from Figma spec
• AurumSectionHeader — section divider from Figma spec
• AurumSwitch — toggle from Figma spec
• version.properties for semver tracking

Changed

• AurumButton rebuilt from Figma spec: 3 variants (removed Ghost/Destructive), corrected heights (40/48/56dp), added isFullWidth + isLoading, 12dp corner radius
• AurumTypography restructured to match Figma type scale: 14 scale composites (Display/Heading/Body/Caption) + 6 component-level styles
• AurumTextField audited: added success state, readonly treatment, character counter, fixed error token layer
• All Material Icons replaced with AurumIcons.* (XML Vector Drawables loaded via ImageVector.vectorResource())
• Button size enum renamed Sm/Md/Lg → Small/Medium/Large
• Button style enum renamed AurumButtonStyle → AurumButtonVariant

Fixed

• Secondary button was filled grey — now transparent bg + outline border per Figma
• Typography composites were engineering assumptions — now 14 match actual Figma scale
• Hand-drawn ImageVector.Builder paths replaced with proper XML drawables

[0.1.0] - 2026-04-16

Added

• Initial Aurum module scaffold (:core-designsystem + :core-designsystem-catalog)
• 196 semantic colour tokens from Figma export (6 sub-structs)
• Spacing, radius, border-width, icon-size, elevation, motion, opacity tokens
• AurumTheme composable with MaterialBridge (hybrid M3 architecture)
• Foundation primitives: AurumText, AurumIcon, AurumSurface, AurumDivider
• Interactive primitives: AurumButton, AurumIconButton, AurumTextField, AurumSearchField
• Navigation: AurumTopAppBar (10 Figma variants)
• Feedback: AurumLoader, AurumSkeleton
• Preview infrastructure: @AurumPreview, AurumPreviewSurface
• Modifier.aurumShadow() for elevation rendering
• CLAUDE.md module guide + 30 documentation files
• Catalog app with 6 foundation gallery screens