Skip to content

Update/Add new type classes and CJK Fonts#271

Merged
jordanjones243 merged 11 commits into
masterfrom
jjones/wcssChangeRequest/#269
May 1, 2026
Merged

Update/Add new type classes and CJK Fonts#271
jordanjones243 merged 11 commits into
masterfrom
jjones/wcssChangeRequest/#269

Conversation

@jordanjones243
Copy link
Copy Markdown
Contributor

@jordanjones243 jordanjones243 commented Oct 28, 2025

Alaska Airlines Pull Request

Please include a summary of the change and which issue is fixed. Please also include relevant motivation and context. List any dependencies that are required for this change.

Resolves: #269, #272
https://dev.azure.com/itsals/E_Retain_Content/_workitems/edit/1524213

Summary:

Please summarize the scope of the changes you have submitted, what the intent of the work is and anything that describes the before/after state of the project.

Type of change:

Please delete options that are not relevant.

  • New capability
  • Revision of an existing capability
  • Infrastructure change (automation, etc.)
  • Other (please elaborate)

Checklist:

  • My update follows the CONTRIBUTING guidelines of this project
  • I have performed a self-review of my own update

By submitting this Pull Request, I confirm that my contribution is made under the terms of the Apache 2.0 license.

Pull Requests will be evaluated by their quality of update and whether it is consistent with the goals and values of this project. Any submission is to be considered a conversation between the submitter and the maintainers of this project and may require changes to your submission.

Thank you for your submission!

-- Auro Design System Team

Summary by Sourcery

Add emphasized body text variations with heavier weights across all themes, update CSS variable generation for per-size font weight, adjust heading weights for Alaska and Hawaiian themes, remove redundant letter-spacing in Hawaiian accent config, bump design-tokens dependency and docs version.

New Features:

  • Introduce default-emphasized, lg-emphasized, sm-emphasized, xs-emphasized, and 2xs-emphasized body text classes across all themes

Enhancements:

  • Refactor body mixin to generate CSS variables for font weight per size instead of a single weight variable
  • Adjust heading weight values in Alaska and Hawaiian theme configurations
  • Remove letter-spacing settings from Hawaiian accent type configuration

Build:

  • Upgrade @aurodesignsystem/design-tokens dependency to ^8.6.0

Documentation:

  • Bump documentation site version from 10.1.3 to 10.1.4

@jordanjones243 jordanjones243 self-assigned this Oct 28, 2025
@jordanjones243 jordanjones243 requested a review from a team as a code owner October 28, 2025 20:28
@sourcery-ai
Copy link
Copy Markdown

sourcery-ai Bot commented Oct 28, 2025

Reviewer's Guide

This PR augments the body typography scale with emphasized weight variants, updates the body CSS-vars mixin to generate size-specific weight properties, cleans up redundant letter-spacing in Hawaiian accent settings, adjusts heading weight assignments for Alaska and Hawaiian themes, and bumps dependency and documentation versions.

Class diagram for updated body typography config structure

classDiagram
class type_body_config {
  family
  familyFallback
  letter-spacing
  sizes
}
class Size {
  font-size
  line-height
  weight
}
type_body_config "1" -- "*" Size : sizes
class default {
  font-size
  line-height
  weight
}
class default_emphasized {
  font-size
  line-height
  weight
}
class lg {
  font-size
  line-height
  weight
}
class lg_emphasized {
  font-size
  line-height
  weight
}
class sm {
  font-size
  line-height
  weight
}
class sm_emphasized {
  font-size
  line-height
  weight
}
class xs {
  font-size
  line-height
  weight
}
class xs_emphasized {
  font-size
  line-height
  weight
}
class _2xs {
  font-size
  line-height
  weight
}
class _2xs_emphasized {
  font-size
  line-height
  weight
}
Size <|-- default
Size <|-- default_emphasized
Size <|-- lg
Size <|-- lg_emphasized
Size <|-- sm
Size <|-- sm_emphasized
Size <|-- xs
Size <|-- xs_emphasized
Size <|-- _2xs
Size <|-- _2xs_emphasized
Loading

Class diagram for updated body CSS-vars mixin logic

classDiagram
class generate_body_css_vars {
  +family
  +familyFallback
  +letter-spacing
  +body_size_weight
  +body_size_font_size
  +body_size_line_height
}
generate_body_css_vars --> body_sizes
class body_sizes {
  default
  default_emphasized
  lg
  lg_emphasized
  sm
  sm_emphasized
  xs
  xs_emphasized
  2xs
  2xs_emphasized
}
Loading

Class diagram for updated heading config weight assignments

classDiagram
class AlaskaHeadingSize {
  font-size
  weight
}
class HawaiianHeadingSize {
  font-size
  weight
}
AlaskaHeadingSize : weight = basic-type-weight-heading (was heading2)
HawaiianHeadingSize : weight = basic-type-weight-heading2 (was heading)
Loading

Class diagram for updated Hawaiian accent config (letter-spacing cleanup)

classDiagram
class HawaiianAccentSize {
  font-size
  weight
  line-height
}
HawaiianAccentSize : letter-spacing property removed
Loading

File-Level Changes

Change Details Files
Extend body type configurations to include emphasized weight variants
  • Removed root weight from body configs
  • Added weight entry to each size group
  • Introduced emphasized size keys (default-emphasized, lg-emphasized, sm-emphasized, xs-emphasized, 2xs-emphasized)
src/config/alaska-classic/type/body.scss
src/config/alaska/type/body.scss
src/config/auro-1/type/body.scss
src/config/auro-2/type/body.scss
src/config/hawaiian/type/body.scss
Update body CSS-vars mixin to support size-specific weights
  • Expanded $body-sizes list with emphasized entries
  • Replaced single --body-weight var with --body-#{$size}-weight
  • Updated font-weight references in fallback and non-fallback branches to use size-specific vars
src/type/partials/_body.scss
Clean up redundant letter-spacing in Hawaiian accent config
  • Removed letter-spacing property from all accent size definitions
src/config/hawaiian/type/accent.scss
Adjust heading weight values for Alaska and Hawaiian themes
  • Switched heading2 weight to primary heading weight in Alaska theme
  • Swapped heading weight to secondary weight in Hawaiian theme
src/config/alaska/type/heading.scss
src/config/hawaiian/type/heading.scss
Bump dependency and documentation versions
  • Updated @aurodesignsystem/design-tokens dependency to ^8.6.0
  • Updated docs index version from 10.1.3 to 10.1.4
package.json
docs/index.html

Tips and commands

Interacting with Sourcery

  • Trigger a new review: Comment @sourcery-ai review on the pull request.
  • Continue discussions: Reply directly to Sourcery's review comments.
  • Generate a GitHub issue from a review comment: Ask Sourcery to create an
    issue from a review comment by replying to it. You can also reply to a
    review comment with @sourcery-ai issue to create an issue from it.
  • Generate a pull request title: Write @sourcery-ai anywhere in the pull
    request title to generate a title at any time. You can also comment
    @sourcery-ai title on the pull request to (re-)generate the title at any time.
  • Generate a pull request summary: Write @sourcery-ai summary anywhere in
    the pull request body to generate a PR summary at any time exactly where you
    want it. You can also comment @sourcery-ai summary on the pull request to
    (re-)generate the summary at any time.
  • Generate reviewer's guide: Comment @sourcery-ai guide on the pull
    request to (re-)generate the reviewer's guide at any time.
  • Resolve all Sourcery comments: Comment @sourcery-ai resolve on the
    pull request to resolve all Sourcery comments. Useful if you've already
    addressed all the comments and don't want to see them anymore.
  • Dismiss all Sourcery reviews: Comment @sourcery-ai dismiss on the pull
    request to dismiss all existing Sourcery reviews. Especially useful if you
    want to start fresh with a new review - don't forget to comment
    @sourcery-ai review to trigger a new review!

Customizing Your Experience

Access your dashboard to:

  • Enable or disable review features such as the Sourcery-generated pull request
    summary, the reviewer's guide, and others.
  • Change the review language.
  • Add, remove or edit custom review instructions.
  • Adjust other review settings.

Getting Help

Copy link
Copy Markdown

@sourcery-ai sourcery-ai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hey there - I've reviewed your changes - here's some feedback:

  • There’s a lot of near-identical duplication across the various theme configs for the new “-emphasized” variants—consider abstracting that pattern into a shared map or mixin (or looping through a list of variant names) to keep it DRY and easier to update.
  • It looks like docs/index.html got entirely regen’ed in this PR—consider leaving the generated HTML out of your feature branch and letting your CI/build pipeline handle doc updates so review remains focused on the source changes.
  • Removing all the letter-spacing entries in the accent configs is a breaking style change—please double-check that this aligns with your design token updates and won’t inadvertently alter existing typography spacing.
Prompt for AI Agents
Please address the comments from this code review:

## Overall Comments
- There’s a lot of near-identical duplication across the various theme configs for the new “-emphasized” variants—consider abstracting that pattern into a shared map or mixin (or looping through a list of variant names) to keep it DRY and easier to update.
- It looks like docs/index.html got entirely regen’ed in this PR—consider leaving the generated HTML out of your feature branch and letting your CI/build pipeline handle doc updates so review remains focused on the source changes.
- Removing all the letter-spacing entries in the accent configs is a breaking style change—please double-check that this aligns with your design token updates and won’t inadvertently alter existing typography spacing.

## Individual Comments

### Comment 1
<location> `src/config/hawaiian/type/accent.scss:13` </location>
<code_context>
         'preferred': v.$ds-type-size-38
       ),
       'weight': v.$ds-basic-type-weight-accent,
-      'letter-spacing': v.$ds-basic-type-letter-spacing-accent,
       'line-height': v.$ds-basic-type-line-height-accent2
     ),
</code_context>

<issue_to_address>
**question:** Removing letter-spacing may affect visual consistency for accent text.

Please confirm this change is intentional and visually tested for all accent sizes to maintain typographic consistency.
</issue_to_address>

Sourcery is free for open source - if you like our reviews please consider sharing them ✨
Help me be more useful! Please click 👍 or 👎 on each comment and I'll use the feedback to improve your reviews.

@github-actions
Copy link
Copy Markdown

github-actions Bot commented Oct 28, 2025

🚀 PR Release Published! v0.0.0-pr271.1

To install:

npm install @aurodesignsystem-dev/webcorestylesheets@0.0.0-pr271.1

Install via alias:

npm install @aurodesignsystem@npm:@aurodesignsystem-dev/webcorestylesheets@0.0.0-pr271.1

View on npmjs.com

BREAKING CHANGE: The letter-spacing rule is now omitted from the Hawaiian theme `accent` classes.
@jordanjones243 jordanjones243 force-pushed the jjones/wcssChangeRequest/#269 branch from 7108624 to 0e4c4d7 Compare October 28, 2025 21:55
@jordanjones243 jordanjones243 linked an issue Oct 28, 2025 that may be closed by this pull request
@chrisfalaska
Copy link
Copy Markdown
Contributor

I did some diffs based on the current Prod version.

Is this what is expected @jordanjones243 & @forrest-for-real ?

@chrisfalaska
Copy link
Copy Markdown
Contributor

I did some diffs based on the current Prod version.

Is this what is expected @jordanjones243 & @forrest-for-real ?

After reviewing the diff links with @forrest-for-real , we realized there is a font dependency and created #272

@jordanjones243 jordanjones243 force-pushed the jjones/wcssChangeRequest/#269 branch from fc195ca to 348c8a1 Compare April 29, 2026 21:39
@jordanjones243 jordanjones243 force-pushed the jjones/wcssChangeRequest/#269 branch from 348c8a1 to 49543c5 Compare April 29, 2026 22:48
Copy link
Copy Markdown

@forrest-for-real forrest-for-real left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I reviewed changes live with @jordanjones243 and it looks good from my end.

@chrisfalaska
Copy link
Copy Markdown
Contributor

chrisfalaska commented Apr 29, 2026

I ran a diff against master:

alaska.global.css

Are these indicative of the changes you are expecting?

cc: @forrest-for-real

@forrest-for-real
Copy link
Copy Markdown

I ran a diff against master:

alaska.global.css

Are these indicative of the changes you are expecting?

cc: @forrest-for-real

Is this for the latest build that @jordanjones243 did today @chrisfalaska? Your diff is showing the body-emphasized font weight as 700, and it should be 500 after the updates made today.

@jordanjones243
Copy link
Copy Markdown
Contributor Author

jordanjones243 commented Apr 30, 2026

@forrest-for-real @chrisfalaska
Diff check for Alaska, Hawaiian & Atmos themes with latest commit for CJK fonts:

Alaska: https://www.diffchecker.com/oNIbjSLT/
Hawaiian: https://www.diffchecker.com/vdKO43ko/
Atmos/Auro-1: https://www.diffchecker.com/aF4kXudM/

@jordanjones243 jordanjones243 changed the title Update existing type classes and add new body-#{size}-emphasized classes Update/Add new type classes and CJK Fonts Apr 30, 2026
Comment thread packageScripts/postinstall.mjs
Comment thread src/type/mixins/_fluid-type.scss Outdated
Comment thread src/type/partials/_body.scss Outdated
…rameter

Surface accent letter-spacing intent at the theme call site instead of
inferring it from the accent-config 2xl entry. The inference was brittle:
a future theme defining letter-spacing on some sizes but not 2xl would
have been miscategorized for the entire accent group.
The per-size guard on var emission and the theme-level $use-letter-spacing
flag on class emission were two independent gates that could disagree. A
mixed config could produce a class referencing an undefined var, causing
letter-spacing to resolve to unset rather than inherit. Make the theme
flag the single source of truth.
…cope

The mixin name suggests it covers all four type categories, but the
$use-letter-spacing parameter only ever flowed to generate-accent-classes.
Rename to $accent-use-letter-spacing so the scope is visible at the call
site without stepping into the mixin body.
@jordanjones243
Copy link
Copy Markdown
Contributor Author

Comment thread src/type/mixins/_theme-generator.scss Outdated
Comment thread src/type/mixins/_fluid-type.scss Outdated
Comment thread src/type/partials/_body.scss Outdated
Copy link
Copy Markdown
Contributor

@chrisfalaska chrisfalaska left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks great! 🚀

@jordanjones243 jordanjones243 merged commit aad9973 into master May 1, 2026
5 of 6 checks passed
@jordanjones243 jordanjones243 deleted the jjones/wcssChangeRequest/#269 branch May 1, 2026 18:53
@rmenner rmenner restored the jjones/wcssChangeRequest/#269 branch May 1, 2026 19:22
@rmenner rmenner deleted the jjones/wcssChangeRequest/#269 branch May 1, 2026 19:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add CJK Noto Fonts for 500 Weight Typography theme updates

4 participants