Changelog

Changelog is rather internal in nature. See release notes for the public overview and guidelines. Releases are recorded as git tags in the Github releases page.

Upcoming version 5.x.x (`develop` branch)

#1216
- Description: Add GitHub Actions workflow for pull request events
- Products impact: none
- Addresses: Related to learningequality/.github#50
- Components: -
- Breaking: no
- Impacts a11y: no
- Guidance: -

#1203
- Description: Do not render <img> when src not provided
- Products impact: bugfix
- Addresses: -
- Components: KImg
- Breaking: no
- Impacts a11y: no
- Guidance: -

#1203
- Description: Do not enforce fixed height of a thumbnail area when a custom thumbnail is provided via the thumbnail slot
- Products impact: bugfix
- Addresses: -
- Components: KCard
- Breaking: no
- Impacts a11y: no
- Guidance: -

#1203
- Description: Optimize skeleton loading times
- Products impact: optimization
- Addresses: -
- Components: KCard, KCardGrid
- Breaking: no
- Impacts a11y: no
- Guidance: -

#1203
- Description: Don't set fixed height on loading skeletons and change skeletonsConfig.height to skeletonsConfig.minHeight
- Products impact: bugfix
- Addresses: -
- Components: KCard, KCardGrid
- Breaking: no (skeletonsConfig is not yet used in production)
- Impacts a11y: no
- Guidance: Change skeletonsConfig.height to skeletonsConfig.minHeight

#1203
- Description: Add skeletonsConfig.thumbnailAspectRatio option for configuring aspect ratio of the thumbnail area in loading skeletons
- Products impact: new API
- Addresses: -
- Components: KCard, KCardGrid
- Breaking: no
- Impacts a11y: no
- Guidance: -

#1208
- Description: Fixes KSelect value prop validator forcing a value key to be defined.
- Products impact: bugfix.
- Addresses: -.
- Components: KSelect.
- Breaking: no
- Impacts a11y: no
- Guidance: .

#1196
- Description: Bump lodash from 4.17.21 to 4.17.23
- Products impact: Dev Dependency upgrade
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#1204
- Description: Bump qs from 6.14.0 to 6.14.2
- Products impact: Dev Dependency upgrade
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#1209
- Description: Update grey v_50 to #FAFAFA
- Products impact: bugfix
- Addresses: -
- Components: None
- Breaking: no
- Impacts a11y: no
- Guidance: Bug fix to make grey v_50 actually grey

#1207
- Description: Migrate GitHub Actions workflows from deprecated tibdex/github-app-token to official actions/create-github-app-token
- Products impact: none
- Addresses: learningequality#1206
- Components: -
- Breaking: no
- Impacts a11y: no
- Guidance: -

#1202
- Description: Update KIcon docs
- Products impact: -
- Addresses: -
- Components: KIcon (docs)
- Breaking: no
- Impacts a11y: no (this is already a requirement for icons, it just makes the dev guidance clearer)
- Guidance: -

#1199
- Description: Bumps KDS version to 5.5.2
- Products impact: -
- Addresses: -.
- Components: -.
- Breaking: no
- Impacts a11y: no
- Guidance: -.

#1197
- Description: Adds open/close Sidepanel icon for courses; adds courses icon
- Products impact: Choose from - none (for internal updates) / bugfix / new API / updated API / removed API. If it's 'none', use "-" for all items below to indicate they are not relevant.
- Addresses: 1195
- Components: Adds KIcon options openSidepanel, closeSidepanel, courses
- Breaking: No
- Impacts a11y: No
- Guidance: Feature-specific for now (courses in Kolibri); new icons may be extended to other features in the future

#1198
- Description: Prevent external link icon from becoming tiny
- Products impact: bugfix
- Addresses: -
- Components: KExternalLink
- Breaking: no
- Impacts a11y: no
- Guidance: -

#1194
- Description: Add the thumbnail slot to KCard
- Products impact: new API
- Addresses: learningequality#1162
- Components: KCard
- Breaking: no
- Impacts a11y: no
- Guidance: -

#1193
- Description: Bumps KDS version to 5.5.1
- Products impact: -
- Addresses: -.
- Components: -.
- Breaking: no
- Impacts a11y: no
- Guidance: -.

#1184
- Description: Adds bell icon
- Products impact: new API.
- Addresses: learningequality/studio#5174.
- Components: KIcon.
- Breaking: no
- Impacts a11y: no
- Guidance: -.

#1192
- Description: Fixes the UID reference and using global counter for uid
- Products impact: KDS (KDropdownMenu)
- Addresses: #1156
- Components: KDropdownMenu
- Breaking: no
- Impacts a11y: no
- Guidance:

#1191
- Description: Updates lodash import to use specific module path
- Products impact: bugfix
- Addresses: Bloated asset size due to import of entire lodash library
- Components: KTable
- Breaking: no
- Impacts a11y: no
- Guidance: N/A

#1190
- Description: Remove call-holiday-message GitHub workflow
- Products impact: none
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#1186
- Description: Update dependabot configuration
- Products impact: none
- Addresses: -
- Components: -
- Breaking: no
- Impacts a11y: no
- Guidance: -

#1181
- Description: Bump actions/cache from 4 to 5 in the github group
- Products impact: Dev Dependency upgrade
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#1182
- Description: Fix KToolbar documentation examples not loaded
- Products impact: none
- Addresses: -
- Components: KToolbar
- Breaking: no
- Impacts a11y: -
- Guidance: -

#1178
- Description: Upgrade workflows to .github#35
- Products impact: None
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#1175
- Description: Bumps KDS version to 5.5.0.
- Products impact: -.
- Addresses: -.
- Components: -.
- Breaking: -.
- Impacts a11y: -.
- Guidance: -.

#1140
- Description: Add v-model support to KCheckbox; update documentation page, unit tests, and visual tests.
- Products impact: none
- Addresses: learningequality#1135
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#1172
- Description: Bump puppeteer from 22.15.0 to 24.31.0
- Products impact: Dev Dependency upgrade
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#1170
- Description: Bump actions/checkout from 5 to 6 in the github group
- Products impact: Dev Dependency upgrade
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#1171
- Description: Bump babel-jest from 29.7.0 to 30.2.0
- Products impact: Dev Dependency upgrade
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#1169
- Description: Fixes internal visually hidden style not taking effect in KDS components, and exposes the .visuallyhidden class as public
- Products impact: bugfix
- Addresses: learningequality#1163
- Components: -
- Breaking: no
- Impacts a11y: no
- Guidance: Import KDS styles in the main application stylesheet with @import '~kolibri-design-system/lib/styles/common'; as described in https://design-system.learningequality.org/installation#register-global-styles. Cleanup custom .visuallyhidden class from application styles. See https://design-system.learningequality.org/#helper-styles.

#1169
- Description: Allows KTextbox label to be passed via slot
- Products impact: new API
- Addresses: learningequality#1166
- Components: KTextbox
- Breaking: no
- Impacts a11y: yes
- Guidance: -

#1167
- Description: Bump @testing-library/jest-dom from 6.6.3 to 6.9.1
- Products impact: Dev Dependency upgrade
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#1154
- Description: Bump @babel/core from 7.28.4 to 7.28.5 in the babel group
- Products impact: Dev Dependency upgrade
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#1165
- Description: Bumps KDS version to 5.4.2.
- Products impact: -.
- Addresses: -.
- Components: -.
- Breaking: -.
- Impacts a11y: -.
- Guidance: -.

#1155
- Description: Improve KDropdownMenu and KModal documentation, and adds new KDropdownMenu visual tests
- Products impact: none
- Addresses: -
- Components: KDropdownMenu, KModal
- Breaking: no
- Impacts a11y: no
- Guidance: -

#1155
- Description: Update dev docs to have the latest information on how to preview local KDS changes in Kolibri apps
- Products impact: none
- Addresses: -
- Components: -
- Breaking: no
- Impacts a11y: no
- Guidance: -

#1137
- Description: Bump pbkdf2 from 3.1.2 to 3.1.5
- Products impact: Dev Dependency upgrade
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#1150
- Description: Adds an allowance for an array to be passed as KSelect value prop
- Products impact: N/A
- Addresses: learningequality/kolibri#13696
- Components: N/A
- Breaking: N/A
- Impacts a11y: N/A
- Guidance: N/A

#1148
- Description: Move KButton visual tests into one file
- Products impact: none
- Addresses: learningequality#1095
- Components: -
- Breaking: no
- Impacts a11y: no
- Guidance: -

#1136
- Description: Updates KTable's loading state, reducing height inconsistencies and improving user experience.
- Products impact: -
- Addresses: learningequality/kolibri#13766
- Components: KTable
- Breaking: no
- Impacts a11y: no
- Guidance: -

#1139
- Description: KBreadcrumbs visual tests in one file
- *Products impact: none.
- Addresses: learningequality#1098.
- Components: -.
- Breaking: no
- Impacts a11y: no
- Guidance:

#1144
- Description: Bumps KDS version to 5.4.1.
- Products impact: .
- Addresses: .
- Components: .
- Breaking:
- Impacts a11y:
- Guidance: .

#1123
- Description: Add outerBefore, outerAfter, innerBefore, innerAfter slots to KTextbox to append elements before or after input
- Products impact: KTextbox
- Addresses: #1113
- Components: : KTextbox, UiTextbox
- Breaking: No
- Impacts a11y: No
- Guidance: -

#1141
- Description: Bump jest-environment-jsdom from 29.7.0 to 30.2.0
- Products impact: Dev Dependency upgrade
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#1142
- Description: Bump actions/setup-node from 5 to 6 in the github group
- Products impact: Dev Dependency upgrade
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#1125
- Description: Fix KExternalLink's unexpected margin
- Products impact: bugfix
- Addresses: #1055
- Components: KExternalLink
- Breaking: no
- Impacts a11y: no
- Guidance: -

#1132
- Description: Bump tar-fs from 3.0.9 to 3.1.1
- Products impact: Dev Dependency upgrade
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#1128
- Description: Bump ad-m/github-push-action from 0.8.0 to 1.0.0
- Products impact: Dev Dependency upgrade
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#1133
- Description: Migrates KDropdownMenu Visual tests to be in one file
- Products impact: none.
- Addresses: learningequality#1089.
- Components: -.
- Breaking: no
- Impacts a11y: no
- Guidance: -.

#1133
- Description: Adds a private hideOnClick prop to KDropdownMenu to prevent menus from closing due to external clicks.
- Products impact: none.
- Addresses: learningequality#1089.
- Components: -.
- Breaking: no
- Impacts a11y: no
- Guidance: -.

#1134
- Description: Bump jest from 30.0.0 to 30.2.0
- Products impact: Dev Dependency upgrade
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#1131
- Description: Bumps KDS version to 5.4.0.
- Products impact: .
- Addresses: .
- Components: .
- Breaking:
- Impacts a11y:
- Guidance: .

#1130
- Description: Fixes background color of sticky KTable headers, and sticky column shadows being stacked.
- Products impact: bugfix.
- Addresses: -.
- Components: KTable.
- Breaking: no
- Impacts a11y: no
- Guidance:

#1124
- Description: Updates assignCoaches icon
- Products impact: Kolibri.
- Addresses: #1084.
- Components: N/a.
- Breaking: No
- Impacts a11y: No
- Guidance:

#1056
- Description: This PR adds optional sticky columns for the first, firstTwo, and last columns. The default is 'first' only if nothing else is specified, and the stickiness is only apparent is the contents of the table is wider than the container
- Products impact: Choose from - none (for internal updates) / bugfix / new API / updated API / removed API. If it's 'none', use "-" for all items below to indicate they are not relevant.
- Addresses: Link(s) to GH issue(s) addressed. Include KDS links as well as links to related issues in a consumer product repository too.. Part of 0.19 Kolibri work
- Components: KTable
- Breaking: No
- Impacts a11y: No
- Guidance: The "default" behavior of the first column being sticky will be introduced when KDS is updated after this is merged. Use of the additional options depends on the content of the table, and may need to be customized for mobile responsiveness

#1126
- Description: Fixes KSelect focus outline not being shown.
- Products impact: bugfix.
- Addresses: learningequality/kolibri#13733.
- Components: KSelect.
- Breaking: no
- Impacts a11y: yes
- Guidance: -.

#1126
- Description: Fixes clear button click action not being triggered when using the keyboard.
- Products impact: bugfix.
- Addresses: learningequality/kolibri#13733.
- Components: KSelect.
- Breaking: no
- Impacts a11y: yes
- Guidance: -.

#1118
- Description: Refactor KLogo visual tests into one Vue file
- Products impact: none
- Addresses: learningequality#1090
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#1115
- Description: Bump @babel/core from 7.27.4 to 7.28.3 in the babel group
- Products impact: Dev Dependency upgrade
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#1116
- Description: Migrate visual testing for KCheckbox to single page test.
- Products impact: none
- Addresses: learningequality#1091
- Components: N/A
- Breaking: no
- Impacts a11y: no
- Guidance: N/A

#1120
- Description: Bump the github group with 2 updates
- Products impact: Dev Dependency upgrade
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#1117
- Description: Bumps KDS version to 5.3.0.
- Products impact: .
- Addresses: .
- Components: .
- Breaking:
- Impacts a11y:
- Guidance: .

#1112
- Description: Adds a new prop appearanceOverrides prop to the KTooltip component.
- Products impact: updated API
- Addresses: learningequality/studio#5350, learningequality/studio#5349.
- Components: KTooltip.
- Breaking: no
- Impacts a11y: no
- Guidance: welcomed for non-breaking changes when relevant.

#1106
- Description: Bump sha.js from 2.4.11 to 2.4.12
- Products impact: Dev Dependency upgrade
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#1097
- Description: Bump actions/checkout from 4 to 5 in the github group
- Products impact: Dev Dependency upgrade
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#1107
- Description: Adds new visual testing guidance and updates the codebase accordingly.
- Products impact: none
- Addresses: Prepares the codebase for learningequality#1094
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#1107
- Description: Adds visual tests for KCard, KCardGrid and KTable.
- Products impact: none
- Addresses: learningequality#889
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#1105
- Description: Added comprehensive documentation page for KToolbar component
- Products impact: none
- Addresses: #1085
- Components: KToolbar
- Breaking: no
- Impacts a11y: no
- Guidance: -

#1105
- Description: Added prop validators to KToolbar
- Products impact: none
- Addresses: -
- Components: KToolbar
- Breaking: no
- Impacts a11y: no
- Guidance: -

#1103
- Description: Refactors visual test layout
- Products impact: none.
- Addresses: -.
- Components: -.
- Breaking: no
- Impacts a11y: no
- Guidance: .

#1104
- Description: Adds containerAppearanceOverrides prop to KTextbox to override its container styles without using deep selectors.
- Products impact: new API.
- Addresses: Will help with learningequality/studio#5209.
- Components: KTextbox.
- Breaking: no
- Impacts a11y: no
- Guidance: .

#1099
- Description: Bumps KDS version to 5.2.2.
- Products impact: .
- Addresses: .
- Components: .
- Breaking:
- Impacts a11y:
- Guidance: .

#1096
- Description: Added visual tests for KBreadcrumbs and restructured component file organization from KBreadcrumbs.vue to KBreadcrumbs/index.vue.
- Products impact: None
- Addresses: Visual testing: Add visual tests for KBreadcrumbs #924
- Components: KBreadcrumbs
- Breaking: No
- Guidance: Visual tests implemented following KButton patterns, covering all 7 required scenarios including overflow dropdown behavior.

#1086
- Description: Adds new documentation examples to KCard, KImg, KIcon, and KTextbox . Adds anchors and sub-navigation to some documentation pages. Hides irrelevant parts of code samples from KCard examples.
- Products impact: None
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#1086
- Description: Refactors some documentation examples to use DocsExample, adds more visual tests, and moves some visual test suites to one .vue file.
- Products impact: None
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#1086
- Description: Changes 'UiToolbar' component (in-code, not file) name to 'KToolbar'
- Products impact: None
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#1063
- Description: Improves KTabsList documentation example styling
- Products impact: none
- Addresses: learningequality#993
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#1077
- Description: Bumps kds version to 5.2.1.
- Products impact: -.
- Addresses: -.
- Components: -.
- Breaking: -.
- Impacts a11y: -.
- Guidance: -.

#1076
- Description: Bump form-data from 4.0.1 to 4.0.4
- Products impact: Dev Dependency upgrade
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#1070
- Description: Fixes KSelect content being overflowed when there was a selected option with a long label.
- Products impact: bugfix.
- Addresses: learningequality#1066.
- Components: KSelect.
- Breaking: no
- Impacts a11y: no
- Guidance: .

#1070
- Description: Turns clear button to be small to avoid vertical overflow on button hover.
- Products impact: bugfix.
- Addresses: learningequality#1066.
- Components: KSelect.
- Breaking: no
- Impacts a11y: no
- Guidance: .

#1050
- Description: Added visual tests for KSelect.
- Products impact: None
- Addresses: #1007
- Components: No
- Breaking: No
- Impacts a11y: No
- Guidance: None

#1072
- Description: Update workflow that handles contributor comments to the latest version
- Products impact: none
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#1071
- Description: Fix KTransition in component-vertical-slide-out-in mode moving from/to too high
- Products impact: bugfix
- Addresses: studio conversation
- Components: KTransition
- Breaking: no
- Impacts a11y: no
- Guidance: -

#1068
- Description: Add expand icon
- Products impact: new icon
- Addresses: learningequality/kolibri#13504
- Components: KIcon
- Breaking: no
- Impacts a11y: no
- Guidance: -

#1051
- Description: Bump @babel/core from 7.26.10 to 7.27.4 in the babel group
- Products impact: Dev Dependency upgrade
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#1018
- Description: At Sizes less than 768px
- Set the content-wrapper width to 100%
- Made props table and other lower sections to overflow-scroll
- Products impact: KDS.
- Addresses: #940
- Components: DocsPageTemplate, DocsPageSection
- Breaking: No
- Impacts a11y: No
- Guidance: Investigate the responsiveness of component pages at screen sizes less than 768px

#1038
- Description: Adds visual tests for KImg.
- Products impact: None
- Addresses: #1009
- Components: No
- Breaking: No
- Impacts a11y: No
- Guidance: None

#1048
- Description: Bump jest from 29.7.0 to 30.0.0
- Products impact: Dev Dependency upgrade
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#1042
- Description: Bump tar-fs from 3.0.8 to 3.0.9
- Products impact: Dev Dependency upgrade
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#961
- Description: Enhanced the test coverage for KTable
- Products impact: none
- Addresses: -
- Components: -
- Breaking: no
- Impacts a11y: no
- Guidance: -

#1037
- Description: Removes custom issue templates and turn on issue header automation
- Products impact: none
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#1046
- Description: Bumps KDS version to 5.2.0
- Products impact: -
- Addresses: -.
- Components: -.
- Breaking: no
- Impacts a11y: no
- Guidance: -.

#1043
- Description: Added horizontal separator lines
- Products impact: None
- Addresses: learningequality#1036
- Components: KTable
- Breaking: No
- Impacts a11y: No
- Guidance: -

#1044
- Description: Adds presentational prop to KCheckbox, to make the checkbox unfocusable but not disabled.
- Products impact: new API.
- Addresses: learningequality/kolibri#13408.
- Components: KCheckbox.
- Breaking: no
- Impacts a11y: yes.
- Guidance:.

#985
- Description: Smaller improvements of KTable documentation page
- Products impact: none
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#1035
- Description: Adds visual tests for KIcon.
- Products impact: None
- Addresses: #1009
- Components: No
- Breaking: No
- Impacts a11y: No
- Guidance: None

#967
- Description: Removes font-weight: bold from KBreadcrumbs
- Products impact: All
- Addresses: Discussion in KDS tactical
- Components: KBreadcrumbs
- Breaking: No
- Impacts a11y: No
- Guidance: This is a minor style change.

#1039
- Description: Added new prop readonly to KTextbox
- Products impact: Yes, new feature added
- Addresses: #1030
- Components: No
- Breaking: No
- Impacts a11y: No
- Guidance: none

#1040
- Description: Bumps KDS version to 5.1.0
- Products impact: -
- Addresses: -.
- Components: -.
- Breaking: no
- Impacts a11y: no
- Guidance: -.

#1031
- Description: Adds icons needed for feature development in Kolibri
- Products impact: Kolibri
- Addresses: n/a
- Components: KIcon*
- Breaking: no
- Impacts a11y: no
- Guidance: Use the given added icon key(s) to use the icons in Kolibri

#1024
- Description: Added a Usage section to the KModal documentation.
- Products impact: None
- Addresses: #921
- Components: -
- Breaking: No
- Impacts a11y: No
- Guidance: None

#1025
- Description: Adds visual tests for KLogo.
- Products impact: None
- Addresses: #1010
- Components: No
- Breaking: No
- Impacts a11y: No
- Guidance: None

#1034
- Description: Updated disableBuiltInSorting method
- Products impact: None
- Addresses: learningequality/kolibri#12705
- Components: KTable
- Breaking: No
- Impacts a11y: No
- Guidance: -

#956
- Description: Migrated KTabsList documentation to use DocsExample.
- Products impact: Documentation update (no API impact).
- Addresses: learningequality#953
- Components: KTabsList documentation.
- Breaking: No
- Impacts a11y: No
- Guidance: No changes needed for consumers.

#1027
- Description: Adds truncateOptionsLabel prop to control wether to truncate or wrap KSelect options label when it overflows.
- Products impact: new API.
- Addresses: learningequality/kolibri#12166.
- Components: KSelect.
- Breaking: no
- Impacts a11y: no
- Guidance: .

#1021
- Description: This PR changes allows individual documentation tabs (template, script, and style) to be hidden using their respective boolean props.
- Products impact: None
- Addresses: learningequality#995
- Components: KCard, DocsExample
- Breaking: No
- Impacts a11y: No
- Guidance: None

#990
- Description: Adds KCardGrid management for reserving space for selection control width in KCard to align cards that already selection controls and the ones who doesnt.
- Products impact: bugfix.
- Addresses: learningequality#980.
- Components: KCard
- Breaking: no
- Impacts a11y: no
- Guidance: .

#1023
- Description: Adds a min-width: 0 to k card area to prevent text overflow issues within KCards with checkboxes.
- Products impact: bugfix.
- Addresses: learningequality#958.
- Components: KCard.
- Breaking: no
- Impacts a11y: no
- Guidance: -.

#1016
- Description: Adds clarifications regarding registering KDS components in visual.load-test-components.js to the visual testing development docs.
- Products impact: none.
- Addresses: -.
- Components: -.
- Breaking: no.
- Impacts a11y: no.
- Guidance: -.

#1026
- Description: Wraps ResizeObserver callback in useKResponsiveElement with requestAnimationFrame to avoid possible resize observer issues.
- Products impact: none.
- Addresses: learningequality#960.
- Components: -.
- Breaking: no
- Impacts a11y: no
- Guidance: .

#1017
- Description: added visual tests for the KCheckbox component and the KCheckbox component file has been renamed from KCheckbox.vue to KCheckbox/index.vue to better organize the component structure.
- Products impact: none
- Addresses: [Visual testing]: Add visual tests for KCheckbox
- Components: KCheckbox
- Breaking: no
- Impacts a11y: no
- Guidance: Visual test is implemented in separate test file

#999
- Description: Changed default grid gap to 24px instead of 30px of KCardGrid.
- Products impact: KDS, Studio, Kolibri
- Addresses: issue #996 and one related PR in kolibri #13344
- Components: KCardGrid
- Breaking: no
- Impacts a11y: no
- Guidance: none

#975
- Description: Updated KCard documentation to use the DocsExample component and migrated example code into separate Vue files in the KCard directory. Cleaned up unnecessary script in KCard.vue.
- Products impact: none
- Addresses: #950
- Components: KCard
- Breaking: no
- Impacts a11y: no
- Guidance: -

[#978]
- Description: Refactored KCardGrid docs and example files to use the new DocsExample component
- Products impact: none
- Components: KCardGrid
- Breaking: no
- Impacts a11y: no
- Guidance: -
#986
- Description: Bumps KDS version to 5.0.2
- Products impact: -
- Addresses: -.
- Components: -.
- Breaking: no
- Impacts a11y: no
- Guidance: -.

#981
- Description: Adds the automation to remove stale assignments from issues
- Products impact: none
- Addresses: learningequality/kolibri#12837
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#983
- Description: Ensures visual focus outline appears around the KCheckbox in its indeterminate state by adding the correct styling for active checkboxes.
- Products impact: bugfix
- Addresses: learningequality#974
- Components: KCheckbox
- Breaking: no
- Impacts a11y: yes
- Guidance: -

#979
- Description: Bump browserslist-config-kolibri from 0.16.0-dev.7 to 0.18.0
- Products impact: Dev Dependency upgrade
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#971
- Description: Added visual tests for KDropdownMenu (covering single, multiple, icons, and header slot scenarios) and renamed KDropdownMenu.vue to KDropdownMenu/index.vue.
- Products impact: None
- Addresses: #926
- Components: KDropdownMenu
- Breaking: No
- Impacts a11y: No
- Guidance: Visual tests are implemented in separate test files following the approach used for KButton visual tests. This ensures that different configurations of KDropdownMenu render correctly and consistently.

#900
- Description: Fixes the bug in keyboard navigation in KTable when Shift + Tab navigation was trapped
- Products impact: bugfix
- Addresses: learningequality#883
- Components: KTable
- Breaking: no
- Impacts a11y: yes
- Guidance: -

#900
- Description: Refactors internal methods for better maintenance
- Products impact: none
- Addresses: -
- Components: KTable
- Breaking: no
- Impacts a11y: no
- Guidance: -

#886
- Description: Removed SCSS variables in lib/keen/styles/variables.scss that relied on theming SCSS variables. Replaced their usage in KDS components and styles with direct references to the corresponding JS/Vue theme variables using inline style bindings or dynamic classes.
- Products impact: none
- Addresses: Issue #617
- Components: No public KDS components directly affected.
- Breaking: no
- Impacts a11y: no
- Guidance: Consumers of KDS should ensure they are not relying on the removed SCSS variables. If theming is applied, they must directly reference the appropriate KDS color variables in Vue templates for consistency and runtime theming support.

#973
- Description: Add validator for the extension for loadExample prop in DocsExample
- Products impact: -
- Addresses: -
- Components: -
- Breaking: Will this change break something in a consumer? Choose from: no
- Impacts a11y: no
- Guidance: -

#962
- Description: Migrate KImg documentation to use DocsExample component
- Products impact: -
- Addresses: learningequality#952
- Components: -
- Breaking: no
- Impacts a11y: no
- Guidance: -

#965
- Description: Bug-fix DocsExample to provide support for SCSS language and block attribute
- Products impact: none
- Addresses: -
- Components: -
- Breaking: no
- Impacts a11y: no
- Guidance: -

#897
- Description: MIgrated test from enzyme to Vue testing library
- Products impact: none
- Addresses: learningequality#510
- Components: none
- Breaking: no
- Impacts a11y: no
- Guidance: -

#937
- Description: Allow object component rendering and unmount previoius component on render
- Products impact: internal
- Addresses: .
- Components: .
- Breaking:
- Impacts a11y:
- Guidance:

#959
- Description: Bump axios from 1.7.9 to 1.8.2
- Products impact: Dev Dependency upgrade
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#912
- Description: Bump tibdex/github-app-token from 1 to 2
- Products impact: Dev Dependency upgrade
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#928
- Description: Bump @babel/core from 7.26.0 to 7.26.7 in the babel group
- Products impact: Dev Dependency upgrade
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#957
- Description: Bump prismjs from 1.29.0 to 1.30.0
- Products impact: Dev Dependency upgrade
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#954
- Description: Updates visual tests workflow skip paths just to run on chnges on the lib/ folder and the visual testing config files.
- Products impact: -.
- Addresses: -.
- Components: -.
- Breaking: -
- Impacts a11y: -
- Guidance: -

#945
- Description: Add automated workflow for managing community contribution labels when issues are assigned/unassigned to external contributors
- Products impact: none
- Addresses: learningequality/kolibri#12923
- Components: -
- Breaking: no
- Impacts a11y: no
- Guidance: -

#948
- Description: Updates contact information in the contributing guidelines
- Products impact: none
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#943
- Description: Bumps KDS version to 5.0.1
- Products impact: -
- Addresses: -.
- Components: -.
- Breaking: no
- Impacts a11y: no
- Guidance: -.

#942
- Description: Match the hover background color of flat-button KButton to that of KIconButton
- Products impact: bugfix
- Addresses: -
- Components: KButton.
- Breaking: no
- Impacts a11y: no
- Guidance:

#918
- Description: Adds dynamic loading of component examples in DocsExample
- Products impact: new API
- Addresses: learningequality#845
- Components: -
- Breaking: no
- Impacts a11y: no
- Guidance: -

#918
- Description: Adds new transition: component-vertical-slide-out-in in KTransition suitable when need to reduce vertical jarring effect during the entrance/exit of a component
- Products impact: new API
- Addresses: learningequality#845
- Components: KTransition
- Breaking: no
- Impacts a11y: no
- Guidance: -

#918
- Description: Adds new Icon: github
- Products impact: new icon
- Addresses: learningequality#845
- Components: KIcon
- Breaking: no
- Impacts a11y: no
- Guidance: -

#918
- Description: Adds new required prop for DocsExample component: exampleId
- Products impact: new API
- Addresses: learningequality#845
- Components: -
- Breaking: no
- Impacts a11y: no
- Guidance: -

#935
- Description: Add visual test for KIconButton component
- Products impact: None
- Addresses: learningequality#927
- Components: None
- Breaking: No
- Impacts a11y: No
- Guidance: Not required

#911
- Description: Bump the github group with 2 updates
- Products impact: Dev Dependency upgrade
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#939
- Description: Fixed KIcon alignment in KButton and KLabeledIcon to ensure vertical centering.
- Products impact: Kolibri
- Addresses: Issue #931
- Components: KButton and KLabeledIcon
- Breaking: Will this change break something in a consumer? Choose from: yes / no
- Impacts a11y: no
- Guidance: This update improves the visual alignment of KIcon within KButton and KLabeledIcon, ensuring a consistent and centered appearance.

#876
- Description: Bump color from 3.2.1 to 4.2.3
- Products impact: Dev Dependency upgrade
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#888
- Description: Updates KDateRange logic so that end date is cleared only if start date is after end date; users can now set start date via keyboard, then select end date using the calendar view.
- Products impact: none
- Addresses: learningequality#817
- Components: -
- Breaking: no
- Impacts a11y: -
- Guidance: -

#917
- Description: Added the missing usage section for the KTextTruncator component in the documentation
- Products impact: none
- Addresses: learningequality#899
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#856
- Description: Adds aria-haspopup and aria-expanded attributes to KButton when used with dropdown menus to improve screen reader feedback
- Products impact: Anhancement
- Addresses: learningequality#832
- Components: KButton
- Breaking: no
- Impacts a11y: yes
- Guidance: WNo changes required for existing implementations. The ARIA attributes are automatically added when KButton is used with dropdown menus through the menu slot.

#840
- Description: Corrected Shift+Tab navigation behavior to follow the expected reverse order of focusable elements within cells.
- Products impact: bugfix
- Addresses: #837 #804
- Components: KTable
- Breaking: no
- Impacts a11y: yes
- Guidance: No special guidance required for consumers.

#932
- Description: Fix the action not updating some data in the contributions tracking sheet
- Products impact: none
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#910
- Description: Pinned Node.js (18.20.6) and Yarn (1.22.22) versions using Volta.
- Products impact: none (internal updates).
- Addresses: Compatibility issues with Node.js and Yarn versions across contributors' environments.
- Components: Documentation updates for KDS setup.
- Breaking: no.
- Impacts a11y: no.
- Guidance: Developers need to install Volta if not already installed and ensure they follow the updated setup instructions in the documentation.

#929
- Description: Bumps KDS version to 5.0.0
- Products impact: -
- Addresses: -.
- Components: -.
- Breaking: no
- Impacts a11y: no
- Guidance: -.

#919
- Description: Additional category icons are now available
- Products impact: -
- Addresses: -
- Components: KIcon
- Breaking: No
- Impacts a11y: No
- Guidance: New icons can now be used

#923
- Description: Fixes glob query in extrac api script.
- Products impact: bugfix.
- Addresses: -.
- Components: Docs.
- Breaking: no
- Impacts a11y: no
- Guidance: .

#922
- Description: Fixes playground path in dev docs and gitignore
- Products impact: internal docs.
- Addresses: -.
- Components: -.
- Breaking: -
- Impacts a11y: -
- Guidance: -.

#873
- Description: Implemented DocsExample component with toggle functionality for switching between an example and its code snippet in the KDS documentation.
- Products impact: none
- Addresses: learningequality#826
- Components: -
- Breaking: no
- Impacts a11y: no
- Guidance: -

#916
- Description: Fixes the no usable sandbox error observed in visual test workflow after merging of visual testing PR.
- Products impact: bugfix
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#901
- Description: Integrates visual testing setup to KDS.
- Products impact: -
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#804
- Description: Refactored handleKeydown method into smaller, modular methods for handling different key events. Ensured that the Tab key mimics the functionality of the ArrowRight key, and the Shift+Tab key mimics the functionality of the ArrowLeft key. \
- Products impact: none
- Addresses: #795
- Components: KTable
- Breaking: no
- Impacts a11y: yes
- Guidance: No special guidance required for consumers.

#870
- Description: remove text truncation for the download button
- Products impact: Choose from - none
- Addresses: learningequality/kolibri#5557
- Components: KDropdownMenu,UiMenu
- Breaking: no
- Impacts a11y: yes
- Guidance: -

#907
- Description: Skip sync projects job if the owner is not LearningEquality
- Products impact: -.
- Addresses: learningequality#906.
- Components: -.
- Breaking: -
- Impacts a11y: -
- Guidance: -.

#903
- Description: Fixes infinite recursive error when KModal request the focus.
- Products impact: bugfix.
- Addresses: learningequality/studio#4772, learningequality#228.
- Components: KModal.
- Breaking: no
- Impacts a11y: no
- Guidance: .

#862
- Description: Improves docs mobile responsiveness by adding a menu hamburguer to open docs sidenav on mobile devices.
- Products impact: bugfix
- Addresses: N/A
- Components: KDS Docs: SideNav, Header
- Breaking: no
- Impacts a11y: no
- Guidance:

The new toggle functionality allows users to show and hide the side navigation bar, with a close button to close it manually.
The overlay provides a better user experience by dimming the content when the sidebar is open in mobile view.
No breaking changes were introduced, so this update can be safely merged into existing applications.
#904
- Description: Transform project numbers to int in the Sync KDS Roadmap Project Statuses workflow.
- Products impact: -.
- Addresses: -.
- Components: -.
- Breaking: no
- Impacts a11y: no
- Guidance: -

#882
- Description: Adds Adds two workflows to keep KDS Roadmap statuses updated
- Products impact: none.
- Addresses: -.
- Components: -.
- Breaking: no
- Impacts a11y: no
- Guidance: -.

#898
- Description: Fixes KModal backdrop entrance transition not being smooth.
- **Products impact : bugfix .
- Addresses: learningequality#848.
- Components: KModal
- Breaking: no
- Impacts a11y: no
- Guidance: -.

#823
- Description: Bump globby from 6.1.0 to 14.0.2
- Products impact: Dev Dependency upgrade
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#877
- Description: Teleport KSelect dropdown to the Overlay layer using Popper.
- Products impact: bugfix.
- **Addresses:**learningequality#324, learningequality#690.
- Components: KSelect.
- Breaking: no
- Impacts a11y: no
- Guidance: -.

#877
- Description: Removes internal KModal calculations to modify its content height if it had a KSelect inside.
- Products impact: bugfix.
- **Addresses:**learningequality#324.
- Components: KModal.
- Breaking: no
- Impacts a11y: no
- Guidance: -.

#879
- Description: Adds logic to mount overlay layer if it needed when we call getOverlayEl.
- Products impact: bugfix.
- Addresses: learningequality#878.
- Components: useKOverlay.
- Breaking: no
- Impacts a11y: no
- Guidance: -.

#893
- Description: Bump kds version to 5.0.0-rc12.
- Products impact: -.
- Addresses: -.
- Components: -.
- Breaking: -.
- Impacts a11y: -.
- Guidance: -.

#887
- Description: Added margin-top: 16px and margin-bottom: 16px to the empty table message to ensure consistent spacing with the table header and data rows.
- Products impact: bugfix
- Addresses: - #881
- Components: KTable
- Breaking: no
- Impacts a11y: no
- Guidance:

#847
- Description: Improvement of the Table of Contents filter to work properly with browsers' command.
- Products impact: Updated API
- Addresses: Issue#213
- Components: no
- Breaking: no
- Impacts a11y: no
- Guidance: Improves KDS.

#874
- Description: Removes pull_request_review event from the community contributions spreadsheet action. When triggered by this event, secrets are not available. This fixes the action failure when pull request reviewed.
- Products impact: none
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#854
- Description: Makes KTable sorting case-insensitive and internationalized
- Products impact: bugfix
- Addresses: learningequality#852
- Components: KTable
- Breaking: No
- Impacts a11y: No
- Guidance: NA

#859
- Description: Add documentation to the KTooltip page
- Products impact: none
- Addresses: learningequality#694
- Components: KTooltip
- Breaking: no
- Impacts a11y: no
- Guidance: -

#872
- Description: Adds the global title attribute to KBreadcrumbs so that the truncated text can be seen fully when a breadcrumb item is hovered.
- Products impact: UX/UI update
- Addresses: learningequality#208
- Components: KBreadcrumbs
- Breaking: no
- Impacts a11y: Yes. Improves experience for sighted users.
- Guidance: -

#868
- Description: Revert regression in KLogo display
- Products impact: bugfix
- Addresses: -
- Components: KLogo
- Breaking: no
- Impacts a11y: no
- Guidance: -

#849
- Description: A Reusable action is added to .github repo. This PR makes use of it.
- Products impact: none
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#866
- Description: Bump vue-docgen-api from 4.78.0 to 4.79.2
- Products impact: Dev Dependency upgrade
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#864
- Description: Bump nanoid from 3.3.7 to 3.3.8
- Products impact: Dev Dependency upgrade
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#863
- Description: Updates KDS version to 5.0.0-rc11
- Products impact: -.
- Addresses: -.
- Components: -.
- Breaking: -
- Impacts a11y: -
- Guidance: -

#504
- Description: Remove use of /deep/ in favour of ::v-deep
- Products impact: none
- Addresses: -
- Components: -
- Breaking: no
- Impacts a11y: -
- Guidance: -

#645
- Description: Upgrades Node.js to v18, along with Kolibri-Tools to v0.16, Jest to v29 and Nuxt to v2.15
- Products impact: none
- Addresses: #439
- Components: none
- Breaking: no
- Impacts a11y: no
- Guidance: Netlify configuration needs to be updated to use v18 as well

#645
- Description: Component error handling now use @error listener to avoid polluting test output, nor suppressing console.* in tests
- Products impact: any
- Addresses: n/a
- Components: KImg, KTabs, KTabsList
- Breaking: yes
- Impacts a11y: no
- Guidance: The KImg component may now emit an Error object in its @error listener when incorrectly configured, in addition to an UiEvent|Event when an image fails to load. Consumers should type check the value.

#851
- Description: Prepends all internal KCard class names with k
- Products impact: bugfix
- Addresses: Prevent from aggressive overrides from global Vuetify styles in Studio, for example when KCard's .title styles were changed unexpectedly by the Vuetify's .title styles, causing text being cut off and incorrectly styled overall. Reported in learningequality/studio#4803.
- Components: KCard
- Breaking: no
- Impacts a11y: no
- Guidance: -

#838
- Description: Re-organizes KCard styles to improve content tolerance and simplify styles, and fixes the thumbnail overflow problems in horizontal layout with small thumbnail
- Products impact: bugfix
- Addresses: Thumbnail overflow problems in horizontal layout with small thumbnail experienced in Kolibri and Studio
- Components: KCard
- Breaking: no
- Impacts a11y: no
- Guidance: -

#824
- Description: Adds default sorting functionality feature
- Products impact: new API
- Addresses: #794
- Components: KTable
- Breaking: no
- Impacts a11y: no
- Guidance: -

#824
- Description: Adds requirement for columnId attribute in all header objects
- Products impact: updated API
- Addresses: #794
- Components: KTable
- Breaking: yes
- Impacts a11y: no
- Guidance: Add a unique column identifier columnId to all header objects

#824
- Description: Renames disableDefaultSorting prop to disableBuiltinSorting
- Products impact: updated API
- Addresses: #794
- Components: KTable
- Breaking: yes
- Impacts a11y: no
- Guidance: Rename all occurrence of disableDefaultSorting

#835
- Description: Enables the action that updates the contributions spreadsheet
- Products impact: no
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#846
- Description: Added radiogroup role to the KRadioButtonGroup component as described in https://www.w3.org/WAI/ARIA/apg/patterns/radio/
- Products impact: none
- Addresses: addresses #828
- Components: KRadioButtonGroup component.
- Breaking: No
- Impacts a11y: yes
- Guidance: radiogroup role offers a better UX to screen reader users by providing context that they are navigating through (and selecting from) a group of related set of options, and how many they have available.

#819
- Description: This PR addresses the reorganization of content related to Material Design elevation. The Google Material Design elevation image was previously located under the dropdown menu section, which was not relevant to its intended focus on layering and hierarchy. It has been moved to the z-index section for better alignment with layering concepts.
- Products impact: updated API
- Addresses: learningequality#813
- Components: no
- Impacts a11y: no
- Guidance: Clearer guidance reduces the potential for confusion while referring to the drop-shadow docs.

#821
- Description: Documentation update for kselect
- Products impact: none
- Addresses: Link(s) to GH issue(s) addressed. Include KDS links as well as links to related issues in a consumer product repository too.
- Components: Kselect
- Breaking: no
- Impacts a11y: no
- Guidance: -

#844
- Description: Bump kds version to 5.0.0-rc10.
- Products impact: -.
- Addresses: -.
- Components: -.
- Breaking: -.
- Impacts a11y: -.
- Guidance: -.

#843
- Description: Restore value watcher to update selection in KSelect
- Products impact: bugfix
- Addresses: learningequality/kolibri#12821
- Components: KSelect
- Breaking: no
- Impacts a11y: no
- Guidance: Fixes a regression

#831
- Description: Creates the initial KToolbar component as a direct port of UiToolbar
- Products impact: new API, removed API - adds KToolbar, removes UiToolbar from the keen dir
- Addresses: N/A
- Components: UiToolbar, KToolbar
- Breaking: yes
- Impacts a11y: no
- Guidance: Creates initial KToolbar component as a port of UiToolbar. Further changes and iterations to API expected.

#825
- Description: Make the title prop required
- Products impact: updated API
- Addresses: A new use-case in Studio in learningequality/studio#4803 where a side panel needs to be toggled on card click without changing URL.
- Components: KCard
- Breaking: yes
- Impacts a11y: no
- Guidance: Even if you use the title slot, pass the title text via the title prop.

#825
- Description: Change the title slot into a scoped slot
- Products impact: updated API
- Addresses: A new use-case in Studio in learningequality/studio#4803 where a side panel needs to be toggled on card click without changing URL.
- Components: KCard
- Breaking: no
- Impacts a11y: no
- Guidance: Consider using the slot's textTitle attribute to achieve more intuitive code when customizing the title.

#825
- Description: Emit click event when card is clicked.
- Products impact: updated API
- Addresses: A new use-case in Studio in learningequality/studio#4803 where a side panel needs to be toggled on card click without changing URL.
- Components: KCard
- Breaking: no
- Impacts a11y: no
- Guidance: -

#825
- Description: Make to prop optional and when not provided, do not render the title text as router-link but rather as span.
- Products impact: updated API
- Addresses: A new use-case in Studio in learningequality/studio#4803 where a side panel needs to be toggled on card click without changing URL.
- Components: KCard
- Breaking: no
- Impacts a11y: no
- Guidance: -

#825
- Description: Ensure reliable screen readers announcements no matter whether card is link or no, and no matter whether the title is customized via the title slot
- Products impact: bugfix
- Addresses: A new use-case in Studio in learningequality/studio#4803 where a side panel needs to be toggled on card click without changing URL.
- Components: KCard
- Breaking: no
- Impacts a11y: yes
- Guidance: -

#818
- Description: keyboard navigation on KDropdownMenu
- Products impact: bugfix.
- **Addresses:**Issues with keyboard navigation on KDropdownMenu #588.
- Components: kDropdownMenu.vue
- Breaking: -
- Impacts a11y: -
- Guidance: -

#827
- Description: Ensure visibility of focus-ring on the KDS website in Firefox
- Products impact: -
- Addresses: learningequality#206
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#815
- Description: removed the deprecated dropshadows
- Products impact: none
- Addresses: #725
- Components: -
- Breaking: no
- Impacts a11y: no
- Guidance: -

#822
- Description: Bump KDS version to 5.0.0-rc9.
- Products impact: -.
- Addresses: -.
- Components: -.
- Breaking: -.
- Impacts a11y: -.
- Guidance: -.

#820
- Description: Fixes KCard area not taking available width
- Products impact: bugfix
- Addresses: A bug discovered in learningequality/studio#4803
- Components: KCard
- Breaking: no
- Impacts a11y: no
- Guidance: -

#769
- Description: Bump tippy.js from 4.2.1 to 4.3.5
- Products impact: Dev Dependency upgrade
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#811
- Description: Bump elliptic from 6.5.7 to 6.6.0
- Products impact: Dev Dependency upgrade
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#796
- Description: Adds an option to override KCardGrid base layouts partially or completely via the new prop layoutOverride
- Products impact: new API
- Addresses: Allows advanced grids customization
- Components: KCardGrid
- Breaking: no
- Impacts a11y: no
- Guidance: -

#796
- Description: Adds loading skeletons to KCardGrid and a way to configure them via the new prop skeletonsConfig
- Products impact: new API
- Addresses: Ensures smooth loading experience
- Components: KCardGrid
- Breaking: no
- Impacts a11y: no
- Guidance: -

#810
- Description: Bump KDS version to 5.0.0-rc8.
- Products impact: -.
- Addresses: -.
- Components: -.
- Breaking: -.
- Impacts a11y: -.
- Guidance: -.

#808
- Description: Adds ariaLabelledBy prop to KSwitch.
- Products impact: Improved accessibility.
- Addresses: -[KSwitch]: Add ariaLabelledBy prop #806
- Components: KSwitch
- Breaking: -
- Impacts a11y: -
- Guidance:-

#799
- Description: copy FocusTrap from kolibri into KFocusTrap in the KDS and use it in the KModal
- Products impact: -
- Addresses: #746
- Components: KModal , KFocuaTrap
- Breaking: no
- Impacts a11y: -
- Guidance: -

#807
- Description: Bump serve-static from 1.15.0 to 1.16.0
- Products impact: Dev Dependency upgrade
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#771
- Description: Bump slackapi/slack-github-action from 1.26.0 to 1.27.0
- Products impact: Dev Dependency upgrade
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#770
- Description: Bump tibdex/github-app-token from 1 to 2
- Products impact: Dev Dependency upgrade
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#777
- Description: Bump express from 4.19.2 to 4.20.0
- Products impact: Dev Dependency upgrade
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

[#803]
- Description: Adds the option to get back to the unsorted state after sorting a KTable column, making it flow to be unsorted->ascending -> descending -> unsorted.
- Products impact: updated API
- Addresses: learningequality#797
- Components: KTable
- Breaking: no
- Impacts : Adds flexibility in how users can interact with the table, especially when sorting is not desired or needs to be reset.
#800
- Description: Merges v4.6.0 into develop
- Products impact: -.
- Addresses: -.
- Components: -.
- Breaking: -
- Impacts a11y: -
- Guidance: -.

#798
- Description: Adds custom computed property computedAriaLabel that dynamically sets the ariaLabel for KIconButton based on the tooltip prop when ariaLabel is not provided.
- Products impact: none
- Addresses: #793
- Components: KIconButton
- Breaking: no
- Impacts a11y: Improves accessibility in places where we have tooltips but no aria- label attribute set for KIconbutton.
- Guidance: -

#792
- Description: Bump KDS version to 5.0.0-rc7.
- Products impact: -.
- Addresses: -.
- Components: -.
- Breaking: -.
- Impacts a11y: -.
- Guidance: -.

#785
- Description: Renames KCard's titleLines prop to titleMaxLines
- Products impact: updated API
- Addresses: -
- Components: KCard
- Breaking: yes
- Impacts a11y: no
- Guidance: Rename the prop

#785
- Description: Renames KCard's layout prop to orientation
- Products impact: updated API
- Addresses: -
- Components: KCard
- Breaking: yes
- Impacts a11y: no
- Guidance: Rename the prop

#785
- Description: Adds support to KCard for selection controls such as checkboxes
- Products impact: new API
- Addresses: -
- Components: KCard
- Breaking: no
- Impacts a11y: yes
- Guidance: -

#785
- Description: Improves spaces display in KCard
- Products impact: visual update
- Addresses: -
- Components: KCard
- Breaking: no
- Impacts a11y: no
- Guidance: -

#785
- Description: Hides KCard placeholder element after the thumbnail image is loaded
- Products impact: bugfix
- Addresses: Resolves issue when parts of the placeholder element was visible behind a small thumbnail image
- Components: KCard
- Breaking: no
- Impacts a11y: no
- Guidance: -

#785
- Description: Updates KCard to make screen readers announce only card titles when navigating the grid with TAB key
- Products impact: bugfix
- Addresses: Resolves unexpected behavior when overwhelming amounts of information was announced when navigating the card list with TAB
- Components: KCard
- Breaking: no
- Impacts a11y: no
- Guidance: -

#785
- Description: Introduces KCardGrid (with internal related KCard updates)
- Products impact: new API
- Addresses: learningequality#697, learningequality#703
- Components: KCardGrid
- Breaking: no
- Impacts a11y: no
- Guidance: -

#785
- Description: Adds detailed guidance to KCard and KCardGrid documentation pages
- Products impact: none
- Addresses: learningequality#264, learningequality#696
- Components: KCard, KCardGrid
- Breaking: no
- Impacts a11y: no
- Guidance: -

#785
- Description: Adds new documentation components: DocsSubNav, DocsToggleButton, DocsToggleContent, DocsTable
- Products impact: none
- Addresses: Helps with organizing larger amounts of guidance on documentation pages
- Components: -
- Breaking: no
- Impacts a11y: no
- Guidance: -

#785
- Description: Slightly increases the width of the main documentation area
- Products impact: none
- Addresses: Helps to better demonstrate components requiring more space on documentation pages, such as card grids
- Components: -
- Breaking: no
- Impacts a11y: no
- Guidance: -

#783
- Description: Removes KResponsiveElementMixin.
- Products impact: removed API.
- Addresses: learningequality#711.
- Components: KResponsiveElementMixin.
- Breaking: yes.
- Impacts a11y: no.
- Guidance: Replace any use of KResponsiveElementMixin with the new composable useKResponsiveElement.

#783
- Description: Adds new useKResponsiveElement composable.
- Products impact: new API.
- Addresses: learningequality#711.
- Components: -.
- Breaking: no.
- Impacts a11y: no.
- Guidance: -.

#783
- Description: Remove use of KResponsiveElementMixin internally
- Products impact: - none
- Addresses: learningequality#711.
- Components: KBreadcrumbs, KFixedGrid.
- Breaking: no
- Impacts a11y: no
- Guidance: -.

#780
- Description: Updated documentation for KTable
- Products impact: None
- Addresses:
- Components: KTable
- Breaking: No
- Impacts a11y: No
- Guidance:

#787
- Description: Bump KDS version to 5.0.0-rc6
- Products impact: -.
- Addresses: -.
- Components: -.
- Breaking: -.
- Impacts a11y: -.
- Guidance: -.

#781
- Description: Adds warning in KRadioButton if it is not nested inside a KradioButtonGroup.
- Products impact: none
- Addresses: #761
- Components: KRadioButton
- Breaking: no
- Impacts a11y: -
- Guidance: -

#774
- Description: Merges KCard and BaseCard
- Products impact: none
- Addresses: Unblocks several issues for the upcoming features regarding the addition of checkboxes and KCardGrid
- Components: KCard
- Breaking: no
- Impacts a11y: -
- Guidance: -

#774
- Description: Updates KCard internal structure and style
- Products impact: This introduces temporary regressions in KCard related to removing its control of its height that will instead be controlled by KCardGrid. However, KCard is required to be always used within KCardGrid anyways so ultimately this will be of no real impact. Will be completed by KCardGrid soon.
- Addresses: Prepares KCard for the upcoming features regarding the addition of checkboxes and KCardGrid
- Components: KCard
- Breaking: no
- Impacts a11y: -
- Guidance: -

#774
- Description: Fixes the thumbnail overflowing in the horizontal layout with small thumbnail and aligns this layout more closely to the designs.
- Products impact: bugfix
- Addresses: learningequality#773
- Components: KCard
- Breaking: no
- Impacts a11y: -
- Guidance: -

#774
- Description: Fix click.stop not working on interactive elements rendered within the card via its slots.
- Products impact: bugfix
- Addresses: -
- Components: KCard
- Breaking: no
- Impacts a11y: -
- Guidance: -

#774
- Description: Aligns padding to the designs
- Products impact: Visual update
- Addresses: -
- Components: KCard
- Breaking: no
- Impacts a11y: -
- Guidance: -

#752
- Description: UpdateKCard to complete vertical/horizontal layouts with no thumbnail
- Products impact: Card updates
- Addresses: learningequality#752
- Components: KCard
- Breaking: N0
- Impacts a11y: No
- Guidance:

#776
- Description: Bump KDS version to 5.0.0-rc5
- Products impact: -.
- Addresses: -.
- Components: -.
- Breaking: -.
- Impacts a11y: -.
- Guidance: -.

#727
- Description: Initial implementation of KTable component
- Products impact: New Component
- Addresses: #328
- Components: KTable
- Breaking: No
- Impacts a11y: Yes
- Guidance:

#766
- Description: Bump KDS version to 5.0.0-rc4
- Products impact: -.
- Addresses: -.
- Components: -.
- Breaking: -.
- Impacts a11y: -.
- Guidance: -.

#765
- Description: Fixes update changelog workflow to avoid expecting a comment after the invisible comment .
- Products impact: none.
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#762
- Description: Updates dropshadows to the latest design guidelines
- Products impact: Visual
- Addresses: learningequality#724
- Components: All components with dropshadows
- Breaking: no
- Impacts a11y: no
- Guidance: -

#722
- Description: Inserts the overlay container element #k-overlay to an application's document body during KDS initialization.
- Products impact: KDS initialization
- Addresses: -
- Components: -
- Breaking: no
- Impacts a11y: no
- Guidance: Remove any custom teleportation logic and use new KDS components and props instead.

#722
- Description: Adds new KOverlay component
- Products impact: New API
- Addresses: -
- Components: KOverlay
- Breaking: no
- Impacts a11y: no
- Guidance: -

#722
- Description: Renames KModal's appendToRoot prop to appendToOverlay
- Products impact: Updated API
- Addresses: -
- Components: KModal
- Breaking: yes
- Impacts a11y: no
- Guidance: Rename KModal's appendToRoot prop to appendToOverlay

#722
- Description: Adds new prop, appendToOverlay, to KTooltip
- Products impact: New API
- Addresses: -
- Components: KTooltip
- Breaking: no
- Impacts a11y: no
- Guidance: -

#722
- Description: Makes the sidebar icon flip in RTL languages
- Products impact: Bugfix
- Addresses: -
- Components: Icons
- Breaking: no
- Impacts a11y: yes
- Guidance: -

#626
- Description: Bump slackapi/slack-github-action from 1.25.0 to 1.26.0
- Products impact: Dev Dependency upgrade
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#739
- Description: Bump elliptic from 6.5.4 to 6.5.7
- Products impact: Dev Dependency upgrade
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#660
- Description: Bump pug from 3.0.2 to 3.0.3
- Products impact: Dev Dependency upgrade
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

547
- Description: Automates changelog update process in the pull requests by adding two GitHub actions: (1) to check for the presence of changelog items(s) in the pull request description, (2) to paste the item(s) to CHANGELOG.md after the PR merged.
- Products impact: none
- Addresses: learningequality#533
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#753
- Description: Bump KDS version to 5.0.0-rc3.
- Products impact: -.
- Addresses: -.
- Components: -.
- Breaking: -.
- Impacts a11y: -.
- Guidance: -.

[#754]
- Description: Removed the border-radius on align left.
- Products impact: bugfix.
- Addresses: learningequality#741
- Components: KCard
- Breaking: no -.
- Impacts a11y: no -.
- Guidance: -

#650
- Description: Add KRadioButtonGroup component to fix keyboard navigation in radio button groups in Firefox
- Products impact: New API
- Addresses: learningequality/kolibri#10491
- Components: KRadioButtonGroup
- Breaking: no
- Impacts a11y: yes
- Guidance: Make sure that all KRadioButtons are wrapped in KRadioButtonGroup

#723
- Description: Updates $core-time value from 0.25s to 0.15s
- Products impact: User experience - faster transitions
- Addresses: Updates KDS to the latest guidance from the design team
- Components: KButton, KExternalLink, KRouterLink, KModal, KCard, KIcon, KTabsList, KTabs, and places in consumers that imports $core-time
- Breaking: no
- Impacts a11y: no
- Guidance: -

#723
- Description: Updates drop shadows documentation to the latest guidance from the design team
- Products impact: -
- Addresses: Updates KDS to the latest guidance from the design team
- Components: -
- Breaking: no
- Impacts a11y: no
- Guidance: -

#728
- Description: Adds $darken_ utility functions for darkening palette colors and ensures compatibility with Node.js v10 by pinning the color package version to 3.2.1.
- Products impact: Kolibri Design System
- Addresses: learningequality#726
- Components: Styling utilities ($darken1(hexColorValue),$darken2(hexColorValue) and $darken3(hexColorValue) functions)
- Breaking: no
- Impacts a11y: no
- Guidance: Ensure to install the exact color version specified in package.json to maintain compatibility with Node.js v10.

#738
- Description: Bump KDS version to 5.0.0-rc2.
- Products impact: -.
- Addresses: -.
- Components: -.
- Breaking: -.
- Impacts a11y: -.
- Guidance: -.

705
- Description: UpdateKCard updates: Adds 'preserveAboveTitle, preserveBelowTitle, preserveFooter` prop for flexible slot management.
- Products impact: Card updates
- Addresses: learningequality#702
- Components: KCard
- Breaking: N0
- Impacts a11y: No
- Guidance:

719
- Description: Removes KResponsiveWindowMixin.
- Products impact: removed API.
- Addresses: learningequality#679.
- Components: KResponsiveWindowMixin.
- Breaking: yes.
- Impacts a11y: no.
- Guidance: Replace any use of KResponsiveWindowMixin with the new composable useKResponsiveWindow.

#718
- Description: This pull request resolves failing KDateCalendar component tests that occurred on the last day of the month in open pull requests by setting dates manually in the tests. Additionally, the KDateCalendar is updated to show the month of the lastAllowedDate property.
- Products impact: none
- Addresses: learningequality#713
- Components: -
- Breaking: no
- Impacts a11y: -
- Guidance: -

#687
- Description: Adds logic that inserts ARIA live assertive and polite regions to an application's document body during KDS initialization and documents this on the new "Installation" page. Relatedly adds useKLiveRegion composable with public methods for updating the live regions with assertive and polite messages.
- Products impact: new API
- Addresses: learningequality#668
- Components: useKLiveRegion
- Breaking: No
- Impacts a11y: Yes. It will fix several places utilizing live regions that don't work in our applications at all. Furthemore, it follows the recommended practices that will fix major a11y issues with live regions we're having.
- Guidance: Find all polite and live regions (or roles) in an application. Remove them and instead use useKLiveRegion.sendPoliteMessage and useKLiveRegion.sendAssertiveMessage to update the live regions that KDS inserted to document body during installation.

#688
- Description: UpdateKCard styling
- Products impact: Card updates
- Addresses:
- Components: KCard
- Breaking: N0
- Impacts a11y: No
- Guidance:

#707
- Description: Card Validations
- Products impact:
- Addresses: #695
- Components: KCard
- Breaking: No
- Impacts a11y: No
- Guidance:

#706
- Description: Add new alignment options to KCard
- Products impact: new alignment
- Addresses: #701
- Components: KCard
- Breaking: N0
- Impacts a11y: No
- Guidance:

#709
- Description: Update spaces to the latest designKCard
- Products impact: Card updates
- Addresses: #704
- Components: KCard
- Breaking: N0
- Impacts a11y: No
- Guidance:

#625
- Description: Initial implementation of KCard component
- Products impact: New Component
- Addresses: #530
- Components: KCard
- Breaking: No
- Impacts a11y: Yes
- Guidance:

#678
- Description: Add previewUnavailable icon
- Products impact: new icon
- Addresses: Support of migrating Studio icons from Vuetify to KDS
- Components: KIcon
- Breaking: no
- Impacts a11y: no
- Guidance: -

#666
- Description: Update KImg's placeholder and letterbox area background color to a lighter shade of grey, v_50.
- Products impact: UI appearance update
- Addresses: -
- Components: KImg, KCard
- Breaking: no
- Impacts a11y: no
- Guidance: -

#652
- Description: KTextTruncator drops support for Internet Explorer 11
- Products impact: browser support update
- Addresses: learningequality#643
- Components: KTextTruncator
- Breaking: yes
- Impacts a11y: -
- Guidance: To be used in newer versions of products that don't need to support IE11 (Kolibri 0.17 and higher)

#590
- Description: Modal now shrinks when the content has a smaller height.
- Products impact: bugfix.
- Addresses: learningequality#570
- Components: KModal.
- Breaking: no
- Impacts a11y: -
- Guidance: Consumers need to ensure the modal height is still working correctly.

#549
- Description: Internal refactor of KSelect as part of moving away from Keen UI where related files were renamed and some functionality that wasn't exposed for public use was removed.
- Products impact: none
- Addresses: -
- Components: -
- Breaking: no
- Impacts a11y: -
- Guidance: Thorough QA of places that use KSelect is recommended due to the large scope of refactor.

#615
- Description: Removes KImg props related to dimensions: height, width, maxHeight, minHeight, maxWidth, minWidth
- Products impact: updated API
- Addresses: -
- Components: KImg
- Breaking: yes
- Impacts a11y: no
- Guidance: Use native style, for example replace <KImg width="100%" maxWidth="500px" /> by <KImg :style="{ width: '100%', maxWidth: '500px' }" />.

#615
- Description: Renames KImg internal classes
- Products impact: none
- Addresses: -
- Components: KImg
- Breaking: -
- Impacts a11y: -
- Guidance: -

Version 4.x.x (`release-v4` branch)

#791
- Description: Bump KDS version to 4.6.0.
- Products impact: -.
- Addresses: -.
- Components: -.
- Breaking: -.
- Impacts a11y: -.
- Guidance: -.

#782
- Description: Update Theme Tokens to the latest specs to comply material design specifications.
- Products impact: Updated API.
- Addresses: learningequality#775.
- Components: -.
- Breaking: yes.
- Impacts a11y: no.
- Guidance: Please update all v_* theme tokens using the mapping posted in learningequality#775.

#786
- Description: Bump KDS version to 4.5.1.
- Products impact: -.
- Addresses: -.
- Components: -.
- Breaking: -.
- Impacts a11y: -.
- Guidance: -.

#784
- Description: Add labelDir prop to control rtl direction of label.
- Products impact: new API.
- Addresses: learningequality/studio#4728.
- Components: KCheckbox, KRadioButton.
- Breaking: no
- Impacts a11y: no.
- Guidance: -.

#767
- Description: Bump KDS version to 4.5.0.
- Products impact: -.
- Addresses: -.
- Components: -.
- Breaking: -.
- Impacts a11y: -.
- Guidance: -.

#744
- Description: Removes internal state management for checked & indeterminate in KCheckbox.
- Products impact: Updated API
- Addresses: learningequality/studio#4636
- Components: KCheckbox
- Breaking: No
- Impacts a11y: No
- Guidance: If you use KCheckbox, it is your responsibility to handle the change event and update whether or not the given checked and indeterminate props reflect the reality that you expect.

#737
- Description: Bump KDS version to 4.4.1.
- Products impact: -.
- Addresses: -.
- Components: -.
- Breaking: -.
- Impacts a11y: -.
- Guidance: -.

#717
- Description: Fix ResizeOserver errors when KListWithOverflow resize very quickly.
- Products impact: bugfix.
- Addresses: Sentry error.
- Components: KListWithOverflow.
- Breaking: no.
- Impacts a11y: no.
- Guidance: -.

#680
- Description: Adds boolean appendToRoot prop to teleport the modal to the body element if true.
- Products impact: new API.
- Addresses: learningequality/kolibri#12447.
- Components: KModal.
- Breaking: no
- Impacts a11y: no
- Guidance:
#680
- Description: Fixes the calculation of overflowed items when changes in the size of the list item slots occur.
- Products impact: bugfix.
- Addresses: learningequality/kolibri#12447.
- Components: KListWithOverflow.
- Breaking: no
- Impacts a11y: no
- Guidance:

#673
- Description: Remove white space below Ktabs
- Products impact: bugfix.
- Addresses: learningequality/kolibri#12297.
- Components: KTabsList, KTabs, KTabsPanel.
- Breaking: no
- **Impacts a11y:**no
- Guidance: .

#629
- Description: Improves the contrast for highlighted text, noted in KTextbox
- Products impact: None
- Addresses: learningequality#629
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#648
- Description: Updates KSelect to include guiding documentation for the events it emits
- Products impact: None
- Addresses: -
- Components: KSelect
- Breaking: no
- Impacts a11y: no
- Guidance: -

#653
- Description: Header "Changelog" text and link updated
- Products impact: -
- Addresses: Replace the "Changelog" link with the "Release notes" link on the KDS documentation website #644
- Components: -
- Breaking: No
- Impacts a11y: No
- Guidance: -

#630
- Description: Updates the svg for the pointsLeafActive, and removes the pointsLeafInactive (which is not used anywhere in Kolibri)
- Products impact: Kolibri (branding)
- Addresses: -
- Components: KIcon and documentation
- Breaking: No
- Impacts a11y: No
- Guidance: -

#627
- Description: Fix missing anchor tag and heading case in KTextbox documentation
- Products impact: None
- Addresses: -
- Components: KTextbox documentation
- Breaking: -
- Impacts a11y: -
- Guidance: -

#604
- Description: Add more examples to KTextbox documentation
- Products impact: None
- Addresses: learningequality#596
- Components: KTextbox documentation
- Breaking: -
- Impacts a11y: -
- Guidance: -

#572
- Description: Add aria-checked property to KCheckbox's <input> element
- Products impact: -
- Addresses: The aria-checked property being set properly improves a11y.
- Components: -
- Breaking: -
- Impacts a11y: yes
- Guidance: -

616
- Description: Fixes KModal not showing content after the initial load
- Products impact: bugfix
- Addresses: learningequality/kolibri#11911 (comment)
- Components: KModal
- Breaking: no
- Impacts a11y: no
- Guidance: -

616
- Description: Fixes KSelect's missing padding
- Products impact: bugfix
- Addresses: learningequality/kolibri#11911 (comment)
- Components: KSelect
- Breaking: no
- Impacts a11y: no
- Guidance: -

#591
- Description: Added a clearable prop to KTextbox
- Products impact: -
- Addresses: learningequality#584
- Components: KTextbox
- Breaking: no
- Impacts a11y: no
- Guidance: -

#582
- Description: Upgrade popper.js from 1.14.6 to 1.16.1
- Products impact: -
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#599
- Description: Upgrade express from 4.18.2 to 4.19.2
- Products impact: -
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#587
- Description: Rebrands icons in buttons and links
- Products impact: UI
- Addresses: -
- Components: KButton, KRouterLink, KExternalLink
- Breaking: no
- Impacts a11y: -
- Guidance: -

#561
- Description: Update KLogo for new branding guidelines
- Products impact: Enables general use of KLogo for all frontend logo usage. Changes props API for square logo presentation.
- Addresses: Updates logo to new logo, adds all permissible alternates, adds animated form.
- Components: KLogo
- Breaking: Yes
- Impacts a11y: No
- Guidance: Rendering the Kolibri logo can now be done using the KLogo component, as well as the loading animation.

#580
- Description: Remove use of KResponsiveWindowMixin internally
- Products impact: - none
- Addresses: -
- Components: KDateRange, KModal, KPageContainer, KGrid, KFixedGrid, KGridItem, KFixedGridItem
- Breaking: no
- Impacts a11y: no
- Guidance: Updates all components to use the useKResponsiveWindow composable

#415
- Description: Upgrade purecss from 0.6.2 to 2.2.0
- Products impact: Updates for base styling for all elements
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#569
- Description: Upgrade actions/setup-node from 3 to 4
- Products impact: Dependencies
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#576
- Description: Upgrade follow-redirects from 1.15.4 to 1.15.6
- Products impact: Dependencies
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#553
- Description: Upgrade ip from 1.1.5 to 1.1.9
- Products impact: Dependencies
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#559
- Description: Upgrade lodash from 4.17.15 to 4.17.21
- Products impact: Dependencies
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#555
- Description: Add action to notify us on Slack about GH issues comments from contributors community
- Products impact: none
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#565
- Description: Revert adding engines
- Products impact: Dependencies
- Addresses: KDS not being installable by consumers that don't use Node 10
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#560
- Description: Configure dependabot to run on Wednesday
- Products impact: -
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#558
- Description: Move useKResponsiveWindow from /lib to /lib/composables
- Products impact: Location update
- Addresses: -
- Components: useKResponsiveWindow
- Breaking: yes
- Impacts a11y: -
- Guidance: Update import useKResponsiveWindow from 'kolibri-design-system/lib/useKResponsiveWindow'; from import useKResponsiveWindow from 'kolibri-design-system/lib/composables/useKResponsiveWindow';

#558
- Description: Remove deprecated KResponsiveWindow's mixin documentation page in favor of a new useKResponsiveWindow page
- Products impact: none
- Addresses: -
- Components: KResponsiveWindow
- Breaking: -
- Impacts a11y: -
- Guidance: -

#558
- Description: Adds engines and browserlist to package.json. Pins dependencies to exact version.
- Products impact: Dependencies
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#558
- Description: Internal maintenance tasks: extract common logic to utils, move private composables to /lib/composables and indicate that they are private by _ prefix in their filename. dev docs updates.
- Products impact: none
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#551
- Description: Updates brand colors, palette colors, and tokens.
  - Breaking changes:
    - Removed palette colors: purple, deeppurple, indigo, brown, cyan, teal, lightgreen, lime, amber, deeporange, bluegrey
    - Removed palette.grey scales: v_300, v_500, v_700, v_900
    - Removed brand and palette scales (except palette.grey): v_50,v_100, v_300, v_500, v_700, v_900
    - Removed content-related tokens: exercise, video, audio, document, html5, slideshow
    - Removed other tokens: appBarFullscreen, appBarFullscreenDark, linkDark
- Other changes:
  - Some existing palette colors look differently
  - Adds new tokens and palette
  - Global styles: <body> background color changed from grey.v_100 to lighter grey.v_50
- Products impact: new API, updated API, deleted API
- Addresses: - learningequality#545
- Components: -
- Breaking: - yes
- Impacts a11y: - no
- Guidance: - Address all breaking changes by searching for removed palette colors, scales, and tokens. Study the updated "Colors" KDS documentation page and replace them by relevant colors/scales/tokens. Also search for any hardcoded hex,rgb(a),hsl(a), or named colors (such as 'white') and theme them instead. Visually check places that use existing palette and adjust scale (you may need to increase it as many colors are lighter). You may also see if there are any minor useful updates to in regards to new tokens (e.g. replacing a palette color with a new token that describes function of the color better). If you use generateGlobalStyles that generates background color for <body> and use grey.v_100 in some components to match the background color, you may need to update it to grey.v_50.

#531
- Description: Remove unused keen-ui dependency
- Products impact: none
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

Version 3.x.x (`release-v3` branch)

#583
- Description: KDropdownMenu menu support to show context menus with isContextMenu prop.
- Products impact: new API.
- Addresses: learningequality#571, learningequality/studio#4403.
- Components: KDropdownMenu.
- Breaking: no.
- Impacts a11y: no.
- Guidance: -.
#583
- Description: New useKContextMenu private composable
- Products impact: - .
- Addresses: - .
- Components: - .
- Breaking: - .
- Impacts a11y: - .
- Guidance: -.
#583
- Description: Expose the event object as second argument on KDropdownMenu's select event.
- Products impact: updated API.
- Addresses: - .
- Components: KDropdownMenu.
- Breaking: no.
- Impacts a11y: no.
- Guidance: -.
#583
- Description: KDropdownMenu menu support to show a header slot.
- Products impact: new API.
- Addresses: - .
- Components: KDropdownMenu.
- Breaking: no.
- Impacts a11y: no.
- Guidance: -.

#611
- Description: Adds a new maxWidth prop
- Products impact: new API
- Addresses: learningequality#595
- Components: KTooltip
- Breaking: no
- Impacts a11y: no
- Guidance: -

#612
- Description: Prevent KListWithOverflow hidden elements from taking up space on the screen.
- Products impact: bugfix.
- Addresses: - .
- Components: KListWithOverflow.
- Breaking: no.
- Impacts a11y: no.
- Guidance: - .
#612
- Description: Scope the styles of the KListWithOverflow component.
- Products impact: bugfix.
- Addresses: - .
- Components: KListWithOverflow.
- Breaking: no.
- Impacts a11y: no.
- Guidance: - .

[##603]
- Description: Adds thumps down icon that is needed in Studio for search recomendation work.
- Products impact: New Icon
- Addresses: #4450
- Components: N/A
- Breaking: No
- Impacts a11y: No
- Guidance: [#603]: learningequality#603
#605
- Description: Adds the dropup icon
- Products impact: New icon
- Addresses: learningequality#594
- Components: -
- Breaking: no
- Impacts a11y: -
- Guidance: -

#586
- Description: Adds a new prop constrainToScrollParent to KDropdownMenu to allow overriding of its popover flipping behavior.
- Products impact: Bugfix
- Addresses: #432
- Components: KDropdownMenu
- Breaking: no
- Impacts a11y: no
- Guidance: Use the constrainToScrollParent prop to override the default popover flipping behavior of the KDropdownMenu component prop where necessary.

#573
- Description: More precise calculation of list with in KListWithOverflow.
- Products impact: bugfix.
- Addresses: -.
- Components: KListWithOverflow.
- Breaking: no.
- Impacts a11y: no.
- Guidance: -.

#552
- Description: New KListWithOverflow component.
- Products impact: new API.
- Addresses: learningequality#556, learningequality/studio#3423, learningequality/kolibri#11923.
- Components: KListWithOverflow.
- Breaking: no.
- Impacts a11y: no.
- Guidance: -.

#552
- Description: New useKResponsiveElement private composable, KResponsiveElementMixin translated to this composable.
- Products impact: -.
- Addresses: -.
- Components: -.
- Breaking: no.
- Impacts a11y: no.
- Guidance: -.

#538
- Description: Complete KImg implementation
- Products impact: new API
- Addresses: learningequality#368
- Components: KImg
- Breaking: no
- Impacts a11y: yes
- Guidance: One of the benefits of using KImg is that it throws a11y related warnings

#557
- Description: Updates development documentation in regards to linking products development servers to local KDS
- Products impact: -
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#542
- Description: Adds a new sort icon
- Products impact: New icon
- Addresses: learningequality/studio#4426
- Components: -
- Breaking: no
- Impacts a11y: -
- Guidance: -

#542
- Description: Updates documentation for icons to the new process, adds clear guidelines
- Products impact: None
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#543
- Description: Added new Icons to support Studio Usability Enhancements
- Products impact: new API
- Addresses: learningequality/studio#3425
- Components: KIcon
- Breaking: no
- Impacts a11y: no
- Guidance: Consumers can now access these icons: activities, attribution, audience, categories, levels, rename

#541
- Description: Add a GitHub Actions workflow to publish a new release on npm
- Products impact: none
- Addresses: learningequality#532
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#535
- Description: Added text prop in the KToolTip component as an alternative to the slot
- Products impact: Choose from - bugfix
- Addresses: #221
- Components: KToolTip
- Breaking: no
- Impacts a11y: no
- Guidance: -

#522
- Description: Upgrades github-actions/cache dependency
- Products impact: Dev dependency upgrade
- Addresses: -
- Components: -
- Breaking: no
- Impacts a11y: no
- Guidance: -

#518
- Description: Add testing for KImg component
- Products impact: none
- Addresses: learningequality#512
- Components: -
- Breaking: no
- Impacts a11y: no -
- Guidance: -

#521
- Description: Move date-fns dependency to depencies rather than dev-dependencies.
- Products impact: bugfix
- Addresses: N/A
- Components: KDateRange/KDateInput
- Breaking: no
- Impacts a11y: no
- Guidance: ~

#509
- Description: Introduces appearanceOverrides prop for the KImg component
- Products impact: new API
- Addresses: learningequality#371
- Components: KImg
- Breaking: No
- Impacts a11y: No
- Guidance: -

#516
- Description: Upgrades follow-redirects dependency
- Products impact: Dependency upgrade
- Addresses: -
- Components: -
- Breaking: no
- Impacts a11y: no
- Guidance: -

#508
- Description: Update Github maintained github actions to latest versions
- Products impact: -
- Addresses: -
- Components: -
- Breaking: no
- Impacts a11y: no
- Guidance: -

#502
- Description: Add dispatching of 'error' event when failed to load image for 'KImg'
- Products impact: new API
- Addresses: learningequality#372
- Components: KImg
- Breaking: no
- Impacts a11y: yes
- Guidance: Allows the consumer to hook into the lifecycle of 'KImg' and handle the cases when the image fails to load

#505
- Description: Added custom implementation of GH action that checks that changelog is updated in each pull request
- Products impact: none
- Addresses: learningequality#481
- Components: -
- Breaking:
- Impacts a11y:
- Guidance: -

#493
- Description: Changed the value of z-index of KDropdownMenu to 99.
- Products impact: Bugfix
- Addresses: learningequality#486
- Components: KDropdownMenu
- Breaking: No
- Impacts a11y: No
- Guidance: -

#500
- Description: Upgrades vue-router dependency
- Products impact: Dependency upgrade
- Addresses: -
- Components: -
- Breaking: no
- Impacts a11y: no
- Guidance: -

#421
- Description: Upgrades kolibri-tools dependency and removes KDS' circular dependency on itself
- Products impact: Dependency upgrade
- Addresses: -
- Components: -
- Breaking: no
- Impacts a11y: no
- Guidance: -

#499
- Description: Upgrades @babel/traverse dependency to address security vulnerability
- Products impact: Dependency upgrade
- Addresses: -
- Components: -
- Breaking: no
- Impacts a11y: no
- Guidance: -

#467
- Description: Upgrades word-wrap dependency to address security vulnerability
- Products impact: Dependency upgrade
- Addresses: -
- Components: -
- Breaking: no
- Impacts a11y: no
- Guidance: -

#483
- Description: Upgrades browserify-sign dependency to address security vulnerability
- Products impact: Dependency upgrade
- Addresses: -
- Components: -
- Breaking: no
- Impacts a11y: no
- Guidance: -

#494
- Description: Update contributing guidelines
- Products impact: none
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#492
- Description: Add autofocus directive on KRadioButton to fix autofocus behavior on dynamic rendering.
- Products impact: bugfix
- Addresses: https://github.com/learningequality/kolibri-design-system/issues/489
- Components: KRadioButton
- Breaking: no
- Impacts a11y: yes
- Guidance: Add "autofocus" prop on KRadioButton. This change improves keyboard navigation on forms where a KRadioButton jumps into the DOM.

#497
- Description: KDropdownMenu now emits a @tab event when the user hits the [Tab] key and a @close event when the menu is closed programmatically. Additionally, a new icon for Expand All was added and can be used just like any other icon with the "expandAll" name.
- Products impact: updated API
- Addresses: -
- Components: KDropdownMenu
- Breaking: No
- Impacts a11y: yes
- Guidance: The @tab event can be used for more precise focus management as the popover by default could end up sending focus to the root HTML element by default. Note that the browser event is passed to the handler function, so you may need/want to call preventDefault() on that event depending on your use case.
#491
- Description: Replaced setTimeout with requestAnimationFrames in tests for useKWindowDimensions and useKResponsiveWindow
- Products impact: -
- Addresses: https://github.com/learningequality/kolibri-design-system/issues/480
- Components: none
- Breaking: no
- Impacts a11y: no
- Guidance: -
#478
- Description: Changed _dev-only to dev-only
- Products impact: -
- Addresses: https://github.com/learningequality/kolibri-design-system/issues/474
- Components: none
- Breaking: no
- Impacts a11y: no
- Guidance: -
#482
- Description: Changed develop branch to main branch in Readme
- Products impact: -
- Addresses: https://github.com/learningequality/kolibri-design-system/issues/479
- Components: none
- Breaking: no
- Impacts a11y: no
- Guidance: -
#485
- Description: Updated KRadioButton 'value' prop to 'buttonValue'
- Products impact: Updated API
- Addresses: https://github.com/learningequality/kolibri-design-system/issues/379
- Components: KRadioButton
- Breaking: Yes
- Impacts a11y:
- Guidance: KRadioButton 'value' prop is deprecated. Please use the 'buttonValue' prop instead.

Version 2.0.0

#464
- Description: Add KTextTruncator
- Products impact: new API
- Addresses: https://github.com/learningequality/kolibri-design-system/issues/450
- Components: KTextTruncator
- Breaking: no
- Impacts a11y: no
- Guidance: -

#460
- Description: Add KLogo
- Products impact: new API
- Addresses: https://github.com/learningequality/kolibri-design-system/issues/373
- Components: KLogo
- Breaking: no
- Impacts a11y: no
- Guidance: -

#470
- Description: Fix bug and add test guard in MediaQuery implementation
- Products impact: none
- Addresses: -
- Components: none
- Breaking: no
- Impacts a11y: no
- Guidance: -

#469
- Description: Throttle the resize listener handler
- Products impact: updated API
- Addresses: https://github.com/learningequality/kolibri-design-system/issues/461
- Components: useKResponsiveWindow
- Breaking: no
- Impacts a11y: no
- Guidance: -

#472
- Description: Fix useKShow bug and add tests
- Products impact: bugfix
- Addresses: -
- Components: useKShow
- Breaking: no
- Impacts a11y: no
- Guidance: -

#463
- Description: Add deprecation warning for KResponsiveWindowMixin
- Products impact: updated API
- Addresses: https://github.com/learningequality/kolibri-design-system/issues/459
- Components: KResponsiveWindowMixin
- Breaking: no
- Impacts a11y: no
- Guidance: useKResponsiveWindow composable should be used instead

#462
- Description: Fix internal links in design system documentation
- Products impact: none
- Addresses: https://github.com/learningequality/kolibri-design-system/pull/423
- Components: none
- Breaking: no
- Impacts a11y: no
- Guidance: -

#453
- Description: Fix sidepanel opening in Kolibri Library page after resizing window
- Products impact: bugfix
- Addresses: https://github.com/learningequality/kolibri/issues/11212
- Components: useKResponsiveWindow (composable)
- Breaking: no
- Impacts a11y: no
- Guidance: -

#449
- Description: Fix textbox being unexpectedly focused after the first page load
- Products impact: bugfix
- Addresses: https://github.com/learningequality/kolibri/issues/9077
- Components: KTextbox
- Breaking: no
- Impacts a11y: yes
- Guidance: -

#450
- Description: Add new changelog and GH action to check that the changelog is updated in each pull request
- Products impact: -
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#448
- Description: Adds KTransition
- Products impact: new API
- Addresses: -
- Components: KTransition
- Breaking: no
- Impacts a11y: no
- Guidance: Exposes predefined set of transitions built on top of Vue's <transition>

#448
- Description: Add a new prop, disableDefaultTransition, to KCircularLoader
- Products impact: new API
- Addresses: -
- Components: KCircularLoader
- Breaking: no
- Impacts a11y: no
- Guidance: You can use the new prop to prevent from glitches when using the loader in tandem with another component, both of them wrapped in a transition

#448
- Description: Rename KCircularLoader's show prop to shouldShow
- Products impact: updated API
- Addresses: -
- Components: KCircularLoader
- Breaking: yes
- Impacts a11y: no
- Guidance: If you use show prop on KCircularLoader, rename it to shouldShow

#448
- Description: Add useKShow composable. Related refactoring of KCircularLoader.
- Products impact: new API
- Addresses: -
- Components: useKShow, KCircularLoader
- Breaking: no
- Impacts a11y: no
- Guidance: -

#447
- Description: Improve contributing guidelines and add a playground page for developers
- Products impact: none
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#446
- Description: Fixes icon components' color property not being applied for some custom icons by removing hardcoded fill color from svg files. Affected icons: computerScienceResource, currentEventsResource, diversityResource, entrepreneurshipResource, environmentResource, financialLiteracyResource, historyResource, learningSkillsResource, literacyResource, logicCriticalThinkingResource, mathematicsResource, mentalHealthResource, readingAndWritingResource, sciencesResource, skillsResource
- Products impact: bugfix
- Addresses: https://github.com/learningequality/kolibri-design-system/issues/395
- Components: KIcon, KIconButton, KLabeledIcon
- Breaking: no
- Impacts a11y: no
- Guidance: -

#446
- Description: KIcon throws a warning about color prop not being applied for icons that are supposed to have fixed colors
- Products impact: new API
- Addresses: https://github.com/learningequality/kolibri-design-system/issues/395
- Components: KIcon, KIconButton, KLabeledIcon
- Breaking: no
- Impacts a11y: no
- Guidance: -

#443
- Description: Update inputs within KDateRange to type date and add support for RTL languages
- Products impact: bugfix
- Addresses: https://github.com/learningequality/kolibri-design-system/issues/442
- Components: KDateRange
- Breaking: no
- Impacts a11y: no
- Guidance: -

#436
- Description: Remove KContentRenderer component
- Products impact: removed API
- Addresses: -
- Components: KContentRenderer
- Breaking: yes
- Impacts a11y: no
- Guidance: Import KContentRendered from Kolibri repository

#437
- Description: Update README with our approach to vendored Keen UI files + add installation step to yarn link guidelines
- Products impact: none
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#433
- Description: Add new props, minVisibleTime and show, to KCircularLoader to allow it being displayed for a desired minimum amount of time
- Products impact: new API
- Addresses: -
- Components: KCircularLoader
- Breaking: no
- Impacts a11y: no
- Guidance: -

#429
- Description: Allows KSelect to extend outside of KModal
- Products impact: bugfix
- Addresses: learningequality#324
- Components: KSelect, KModal
- Breaking: no
- Impacts a11y: no
- Guidance: Some core calculations were tweaked so it would be wise to preview KModal and KSelect for regressions

#427
- Description: Display the months of the year within the KDateCalendar in the correct language
- Products impact: bugfix
- Addresses: -
- Components: KDateRange
- Breaking: no
- Impacts a11y: yes
- Guidance: -

#426
- Description: Add 'click' event to KTabsList
- Products impact: new API
- Addresses: -
- Components: KTabsList
- Breaking: no
- Impacts a11y: no
- Guidance: -

#426
- Description: Fix KTabsList focus state
- Products impact: bugfix
- Addresses: -
- Components: KTabsList, KTabs
- Breaking: no
- Impacts a11y: no
- Guidance: -

#425
- Description: Adds pinned and notPinned icons
- Products impact: new API
- Addresses: -
- Components: -
- Breaking: no
- Impacts a11y: no
- Guidance: -

#425
- Description: Updates cloud icon to outline style
- Products impact: updated API
- Addresses: -
- Components: -
- Breaking: no
- Impacts a11y: no
- Guidance: -

#424
- Description: Adds laptop, cloud and wifi icons
- Products impact: new API
- Addresses: -
- Components: -
- Breaking: no
- Impacts a11y: no
- Guidance: -

#420
- Description: Fix randomly missing focus ring
- Products impact: bugfix
- Addresses: -
- Components: -
- Breaking: no
- Impacts a11y: yes
- Guidance: -

#420
- Description: Add KTabs, KTabsList, and KTabsPanel components
- Products impact: new API
- Addresses: https://github.com/learningequality/kolibri-design-system/issues/385
- Components: KTabs, KTabsList, KTabsPanel
- Breaking: no
- Impacts a11y: yes
- Guidance: -

#403
- Description: Add KOptionalText
- Products impact: new API
- Addresses: https://github.com/learningequality/kolibri-design-system/issues/285
- Components: KOptionalText
- Breaking: no
- Impacts a11y: no
- Guidance: -

#387
- Description: Fix KDropdownMenu causing the window to scroll to the top on the menu button click
- Products impact: bugfix
- Addresses: https://github.com/learningequality/kolibri/pull/9833#issuecomment-1322303903
- Components: KDropdownMenu
- Breaking: no
- Impacts a11y: no
- Guidance: -

#406
- Description: Fixes months displayed at the turn of a year in KDateRange, removes font-family, and fixes console warnings
- Products impact: bugfix
- Addresses: https://github.com/learningequality/kolibri-design-system/issues/405
- Components: KDateRange
- Breaking: no
- Impacts a11y: no
- Guidance: -

#404
- Description: Initial implementation of KImg component
- Products impact: new API
- Addresses: https://github.com/learningequality/kolibri-design-system/issues/369
- Components: KImg
- Breaking: no
- Impacts a11y: no
- Guidance: -

#402
- Description: Fixes partially hidden KSelect's dropdown menu when there is not enough space below the button. The menu will now show above the button in such a scenario.
- Products impact: bugfix
- Addresses: https://github.com/learningequality/kolibri/issues/7752
- Components: KSelect
- Breaking: no
- Impacts a11y: no
- Guidance: -

#378
- Description: Fix KDropdownMenu not showing after its refactor in #346 by adding missing template tags to KButton
- Products impact: bugfix
- Addresses: https://github.com/learningequality/kolibri/issues/9754
- Components: KDropdownMenu, KButton
- Breaking: no
- Impacts a11y: no
- Guidance: -

#384
- Description: Add KDateRange component
- Products impact: new API
- Addresses: https://github.com/learningequality/kolibri-design-system/issues/360
- Components: KDateRange
- Breaking: no
- Impacts a11y: no
- Guidance: -

#393
- Description: Update developers documentation to not include deleting KDS from package.json
- Products impact: none
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#400
- Description: Fix useKWindowDimension's resize event listener not being properly removed
- Products impact: bugfix
- Addresses: https://github.com/learningequality/kolibri-design-system/issues/398
- Components: useKWindowDimension
- Breaking: no
- Impacts a11y: no
- Guidance: -

#401
- Description: KBreadcrumbs's links to intermediary items can be optionally disabled by omitting the link attribute, or making it falsey
- Products impact: new API
- Addresses: -
- Components: KBreadcrumbs
- Breaking: no
- Impacts a11y: no
- Guidance: -

#380
- Description: Wraps KRadioButton' label instead of truncating it. Adds a new prop, truncateLabel, that turns on truncating rather than wrapping.
- Products impact: updated API
- Addresses: https://github.com/learningequality/kolibri-design-system/issues/350
- Components: KRadioButton
- Breaking: yes
- Impacts a11y: no
- Guidance: Examine places where KRadioButton is used and see whether the new default behavior (wrapping) is problematic. If needed, you can set truncateLabel to true to retain the previous default behavior (truncating).

#380
- Description: Add the showLabel prop to KRadioButton to determine whether a label should be displayed. Relatedly, make label prop optional.
- Products impact: new API
- Addresses: https://github.com/learningequality/kolibri-design-system/issues/349
- Components: KRadioButton
- Breaking: no
- Impacts a11y: no
- Guidance: -

#380
- Description: KRadioButton emits 'blur' event on blur
- Products impact: new API
- Addresses: https://github.com/learningequality/kolibri-design-system/issues/349
- Components: KRadioButton
- Breaking: no
- Impacts a11y: no
- Guidance: -

#377
- Description: Add useKResponsiveWindow composable
- Products impact: new API
- Addresses: https://github.com/learningequality/kolibri-design-system/issues/288
- Components: useKResponsiveWindow
- Breaking: no
- Impacts a11y: no
- Guidance: -

#353
- Description: Update README.md guidance on yarn link
- Products impact: none
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#367
- Description: Better naming of the changelog section
- Products impact: none
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#358
- Description: Improves DocsShowCode component layout
- Products impact: none
- Addresses: -
- Components: -
- Breaking: -
- Impacts a11y: -
- Guidance: -

#357
- Description: Bind all attributes to navigation element within KBreadcrumbs
- Products impact: updated API
- Addresses: -
- Components: KBreadcrumbs
- Breaking: no
- Impacts a11y: yes
- Guidance: Even though this is a general update that allows all KBreadcrumbs attributes to be passed right to its <nav>, we intially did it to support adding aria-label easily. Whenever you use KBreadcrumbs, consider improving a11y through ariaLabel attribute on KBreadcrumbs.

#361
- Description: Fixes 'Property or method "disabled" is not defined on the instance but referenced during render.' raised by KDropdownMenu. Related to updates introduced in #346.
- Products impact: bugfix
- Addresses: -
- Components: KDropdownMenu
- Breaking: no
- Impacts a11y: no
- Guidance: -

#361
- Description: KButton exposes hasDropdown prop which will show the dropdown arrow icon in a button. Related to updates introduced in #346.
- Products impact: updated API
- Addresses: -
- Components: KButton
- Breaking: no
- Impacts a11y: no
- Guidance: -

#346
- Description: KButton: The default slot doesn't take precedence over the text prop anymore. The slot's content will be rendered above text when both are provided.
- Products impact: updated API
- Addresses: https://github.com/learningequality/kolibri-design-system/issues/164, https://github.com/learningequality/kolibri-design-system/issues/136
- Components: KButton
- Breaking: yes
- Impacts a11y: no
- Guidance: If you use KButton's default slot simultaneously with the text prop, the button most likely won't render as expected. You might need to add some kind of a custom condition to resolve that.

#346
- Description: KDropdownMenu has a new prop hasIcons which controls whether or not the options display an icon.
- Products impact: new API
- Addresses: -
- Components: KDropdownMenu
- Breaking: no
- Impacts a11y: no
- Guidance: -

#346
- Description: KDropdownMenu no longer contains a button. All props related to buttons were removed from KDropdownMenu, namely text, appearance, and disabled. KButton and KIconButton has a new #menu slot in which KDropdownMenu can be placed.
- Products impact: updated API
- Addresses: https://github.com/learningequality/kolibri-design-system/issues/164
- Components: KDropdownMenu
- Breaking: yes
- Impacts a11y: no
- Guidance: Place KDropdownMenu into KButton's or KIconButton's menu slot and move text, appearance, and disabled props from KDropdownMenu to KButton/KIconButton. See an example in the documentation. Visit "Props" and "Slots" sections of these components' documentation pages for more details.

#355
- Description: Moves KSelect from Kolibri to KDS
- Products impact: new API
- Addresses: https://github.com/learningequality/kolibri-design-system/issues/339
- Components: KSelect
- Breaking: no
- Impacts a11y: no
- Guidance: -

#351
- Description: Wrap KCheckbox default slot's content in <label>
- Products impact: updated API
- Addresses: https://github.com/learningequality/kolibri-design-system/issues/347
- Components: KCheckbox
- Breaking: yes
- Impacts a11y: yes
- Guidance: Even though this will fix all places where we forgot to wrap the default's slot content in <label>, it will cause problems in places we didn't forget to do so as there will now be two <label>s wrapping the label content. Therefore, check all places where KCheckbox is used and if you see <label> in its default slot, remove it.

Version 1.4.x

#185 - Handle arrow key navigation and improve focusOutline
#338 - Allow for new 'nav' slot inline in the toolbar
#362 - Add documentation pages for 'KResponsiveWindow' and 'KResponsiveElement'
#364 - Fixes 'Missing focus ring around password inputs' while navigating with keyboard.

Version 1.3.1

#309 - Add jest testing environment to KDS
#311 - Add tests for KRouterLink
#313 - Add tests for KButton
#315 - Add tests for KCheckbox
#320 - Add tests for KModal
#322 - Add tests for KTextbox

Version 1.3.0

#291 - When tracking input modality with trackInputModality, modality is set to keyboard only when the TAB key is pressed
#292 - Add KBreadcrumbs page to the components documentation
#292 - Optimize KBreadcrumbs to use all space available
#292 - Fix KBreadcrumbs items vertical alignment
#292 - Fix KBreadcrumbs items not collapsing when there are more instances on a page

Version 1.2.1

#279 - Fix vertical shifting of KTextbox

Version 1.2.0

#281 - Allow KModal to take a size in pixels
#278 - Adds timer icon
#275 - Renames some icons: socialScienceResource -> socialSciencesResource, mathResource -> mathematicsResource, scienceResource -> sciencesResource, readingWritingResource -> readingAndWritingResource

Version 1.1.0

Added

#270 - New icons for Kolibri 0.15
#272 - Enable 'Loaders' documentation page which was previously hidden

Version 1.0.0

Added

#116, #255 - Changelog
#204 - pointsLeaf icon
#217 - copyToClipboard, infoPrimary, home, unpublishedChange, publishedResource icons
#236 - Learning activity icons
#231 - incorrectReport, registeredKDP, and superadmin icons
#229 - warningIncomplete icon
#150, #152 - KRouterLink - icon, iconAfter and replace props
#199 - KCheckbox - description prop
#137, #142 - KExternalLink - openInNewTab prop
#224 - KContentRenderer - timeSpent, duration, forceTimeBasedProgress, and durationBased props
#108 - App bar documentation
#133 - Documentation about using icons in reStructuredText
#134, #174 - Glossary and anchor links
#165 - Documentation for library components:
- KButton
- KRouterLink
- KExternalLink
- KButtonGroup
- KIconButton
#184 - Imperative verb guidance for modals and page headers
#188 - Menu offset guidelines
#194 - Filters pattern page for:
- Dropdown menus
- Text input dropdowns
- Text filters
- Checkbox lists
#250 - Documentation for design system release process

Changed

#140 - Material design icons is no longer a direct dependency (only a dev dependency) which should reduce timeout errors for products depending on KDS
#143 - KExternalLink - Updated icons and margins for RTL support
#139, #240 - KTextbox - Changed background color and error text color
#153 - KButton - Updated basic-link spacing and color between icons
#223 - Improved component API documentation
#229 - Renamed publishedResource icon to unpublishedResource
#192 - Updated design principles wording
#144 - Updated page headers
#186 - Updated KCheckbox and KSwitch examples

Removed

#243 - KContentRenderer - Removed download_url from mixin

Fixed

#227 - Global styles - Focus outline no longer shows when hovering over elements
#191 - KTextbox - Keyboard-input focus outlines are the standard blue focus
#195 - KRouterLink - Fixed text-wrapping in Safari so child takes full width of parent
#199 - KCheckbox - Updated label display if both slot and label are given
#180 - KDropdownMenu - Removed need to hit tab twice when using keyboard to open dropdown
#145 - KIconButton - Fixed distortion occurring with resized windows by adding minWidth
#191 - KSwitch - Fixed keyboard-input focus outlines so they are the standard blue focus
#195 - KLabeledIcon - Fixed text-wrapping in Safari so child takes full width of parent
#200 - Design system - Fixed keyboard focus rings in examples
#209 - Design system - Fixed sidebar vertical scrolling
#256 - KTextBox - Fixed autofocus error

Version 0.2.1

Added

#95 - Design principles documentation
#97 - Errors documentation
#105 - Switches documentation
#106 - Menu documentation
#110 - email, sidebar, and add icons
#252 - a11y, alternativeRoute, disconnected, forwardRounded, and restart icons
#104 - Support for exporting icons to reStructuredText user documentation

Changed

#121 - Updated clipboard icon
#93 - Fixed regression related to external links opening in new tabs

Removed

#251 - duplicate and copyToClipboard icon aliases removed in favor of copy
#251 - domain icon alias removed because it was the same icon as facility

Fixed

#95, #122 - Fixed z-order bug in icon button
#112, #114, #115 - Documentation bugs and improvements

Version 0.2.0

This was the first release of the Design System, with documentation written in a Nuxt-based statically-generated site. The focus was on migrating components out of the Kolibri and making them reusable in a shared component library.

Version 0.1.0

The design system was originally based on a set of internal Kolibri components and their use as documented in the Kolibri Style Guide, which was first introduced into the Kolibri code base in version 0.6. This remained until version 0.13 after which the content was migrated to the current site.

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Changelog

Upcoming version 5.x.x (`develop` branch)

Version 4.x.x (`release-v4` branch)

Version 3.x.x (`release-v3` branch)

Version 2.0.0

Version 1.4.x

Version 1.3.1

Version 1.3.0

Version 1.2.1

Version 1.2.0

Version 1.1.0

Added

Version 1.0.0

Added

Changed

Removed

Fixed

Version 0.2.1

Added

Changed

Removed

Fixed

Version 0.2.0

Version 0.1.0

FilesExpand file tree

CHANGELOG.md

Latest commit

History

CHANGELOG.md

File metadata and controls

Changelog

Upcoming version 5.x.x (develop branch)

Version 4.x.x (release-v4 branch)

Version 3.x.x (release-v3 branch)

Version 2.0.0

Version 1.4.x

Version 1.3.1

Version 1.3.0

Version 1.2.1

Version 1.2.0

Version 1.1.0

Added

Version 1.0.0

Added

Changed

Removed

Fixed

Version 0.2.1

Added

Changed

Removed

Fixed

Version 0.2.0

Version 0.1.0

Upcoming version 5.x.x (`develop` branch)

Version 4.x.x (`release-v4` branch)

Version 3.x.x (`release-v3` branch)