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)

#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: #852
- Components: KTable
- Breaking: No
- Impacts a11y: No
- Guidance: NA

#859
- Description: Add documentation to the KTooltip page
- Products impact: none
- Addresses: #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: #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: #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: #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: #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: #697, #703
- Components: KCardGrid
- Breaking: no
- Impacts a11y: no
- Guidance: -

#785
- Description: Adds detailed guidance to KCard and KCardGrid documentation pages
- Products impact: none
- Addresses: #264, #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: #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: #711.
- Components: -.
- Breaking: no.
- Impacts a11y: no.
- Guidance: -.

#783
- Description: Remove use of KResponsiveElementMixin internally
- Products impact: - none
- Addresses: #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: #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: #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: #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: #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: #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: #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: #702
- Components: KCard
- Breaking: N0
- Impacts a11y: No
- Guidance:

719
- Description: Removes KResponsiveWindowMixin.
- Products impact: removed API.
- Addresses: #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: #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: #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: #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: #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: #775.
- Components: -.
- Breaking: yes.
- Impacts a11y: no.
- Guidance: Please update all v_* theme tokens using the mapping posted in #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: #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: #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: #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: - #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: #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: #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]: #603
#605
- Description: Adds the dropup icon
- Products impact: New icon
- Addresses: #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: #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: #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: #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: #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: #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: #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: #481
- Components: -
- Breaking:
- Impacts a11y:
- Guidance: -

#493
- Description: Changed the value of z-index of KDropdownMenu to 99.
- Products impact: Bugfix
- Addresses: #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: #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: #480
- Components: none
- Breaking: no
- Impacts a11y: no
- Guidance: -
#478
- Description: Changed _dev-only to dev-only
- Products impact: -
- Addresses: #474
- Components: none
- Breaking: no
- Impacts a11y: no
- Guidance: -
#482
- Description: Changed develop branch to main branch in Readme
- Products impact: -
- Addresses: #479
- Components: none
- Breaking: no
- Impacts a11y: no
- Guidance: -
#485
- Description: Updated KRadioButton 'value' prop to 'buttonValue'
- Products impact: Updated API
- Addresses: #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: #450
- Components: KTextTruncator
- Breaking: no
- Impacts a11y: no
- Guidance: -

#460
- Description: Add KLogo
- Products impact: new API
- Addresses: #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: #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: #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: #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: learningequality/kolibri#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: learningequality/kolibri#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: #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: #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: #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: #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: #385
- Components: KTabs, KTabsList, KTabsPanel
- Breaking: no
- Impacts a11y: yes
- Guidance: -

#403
- Description: Add KOptionalText
- Products impact: new API
- Addresses: #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: learningequality/kolibri#9833 (comment)
- 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: #405
- Components: KDateRange
- Breaking: no
- Impacts a11y: no
- Guidance: -

#404
- Description: Initial implementation of KImg component
- Products impact: new API
- Addresses: #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: learningequality/kolibri#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: learningequality/kolibri#9754
- Components: KDropdownMenu, KButton
- Breaking: no
- Impacts a11y: no
- Guidance: -

#384
- Description: Add KDateRange component
- Products impact: new API
- Addresses: #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: #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: #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: #349
- Components: KRadioButton
- Breaking: no
- Impacts a11y: no
- Guidance: -

#380
- Description: KRadioButton emits 'blur' event on blur
- Products impact: new API
- Addresses: #349
- Components: KRadioButton
- Breaking: no
- Impacts a11y: no
- Guidance: -

#377
- Description: Add useKResponsiveWindow composable
- Products impact: new API
- Addresses: #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: #164, #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: #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: #339
- Components: KSelect
- Breaking: no
- Impacts a11y: no
- Guidance: -

#351
- Description: Wrap KCheckbox default slot's content in <label>
- Products impact: updated API
- Addresses: #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.md

CHANGELOG.md

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

Files

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)