Skip to content

Latest commit

 

History

History
2747 lines (1700 loc) · 130 KB

CHANGELOG.md

File metadata and controls

2747 lines (1700 loc) · 130 KB

Changelog

All notable changes to this project will be documented in this file. See standard-version for commit guidelines.

0.85.0 (2024-03-23)

⚠ BREAKING CHANGES

  • use :global() for custom UI Shell styles (#1940) (d5a1148)

0.84.1 (2024-03-16)

Bug Fixes

  • checkbox: forward on:focus, on:blur to Checkbox and InlineCheckbox (#1937) (6364b23)
  • data-table: loosen sort return type to be a number (#1935) (9132bf8), closes #1934

0.84.0 (2024-03-08)

Features

  • ui-shell: support button tooltip in HeaderGlobalAction (#1894) (d8bc651), closes #1893

Bug Fixes

  • exports: resolve imports with explicit *.js extension (#1927) (0405ede), closes #1925

0.83.0 (2024-03-07)

⚠ BREAKING CHANGES

  • link: do not render p for disabled link

Bug Fixes

  • avoid using reserved $ for Svelte 5 compat (a0d5028)
  • link: do not render p for disabled link (8bffc17), closes #1924
  • search: hoist ignore a11y autofocus comment (6152b78)

0.82.11 (2024-02-26)

Bug Fixes

  • code-snippet: showMoreLess={false} should hide button (4085536), closes #1536
  • image-loader: updated src should update the image (0f318aa), closes #1677
  • overflow-menu: use offsetWidth, offsetHeight to compute menu dimensions (#1913) (2404244)
  • toast-notification: fire on:clear from timeout correctly (9aabe3c), closes #1914

0.82.10 (2024-02-12)

Bug Fixes

0.82.9 (2024-02-07)

Bug Fixes

  • context-menu: prevent on:contextmenu default behavior only when opening menu (#1911) (4ad522c), closes #1909
  • types: improve e.detail type for dispatched events (#1907) (6590457)

0.82.8 (2024-01-10)

Bug Fixes

0.82.7 (2023-12-17)

Bug Fixes

  • radio-button: allow value type to be a number (#1868) (4792257)

0.82.6 (2023-12-17)

Bug Fixes

0.82.5 (2023-12-16)

Bug Fixes

  • header-search: blur input when active is false (#1857) (6c9cf9e)
  • package.json: add exports field to package.json to address Vite development warnings (#1864) (7bef3fa)

0.82.4 (2023-11-21)

Bug Fixes

  • header-search: blur input when deactivating (#1855) (192f6a7)

0.82.3 (2023-11-21)

Bug Fixes

  • header-search: "Escape" should close empty search bar (#1853) (e667352)

0.82.2 (2023-11-20)

Bug Fixes

  • header-search: "Escape" should clear search query (#1851) (6da4572)
  • header-search: vertically center button icons (#1850) (d68dc18)

0.82.1 (2023-11-18)

Bug Fixes

  • pagination-nav: set button type="button" to prevent form submission (#1846) (bed073c)

0.82.0 (2023-11-13)

Features

0.81.3 (2023-11-08)

Bug Fixes

0.81.2 (2023-10-27)

Bug Fixes

0.81.1 (2023-10-23)

Bug Fixes

  • multi-select: reset selectedIds when clearing selection (#1832) (e3ab471), closes #1831

0.81.0 (2023-10-13)

Features

  • data-table: pass row to display function (#1810) (9456eaa)
  • deps-dev: upgrade carbon-components to 10.58 (#1828) (519bd86)

Bug Fixes

  • file-uploader-button: clear value by setting to "" instead of null (#1812) (108eb52)
  • radio-button-group: add name and required props (#1037) (24e2a88), closes #1036
  • radio-button-group: strongly type dispatched change/select events (#1819) (06d81dd)
  • tile-group: add name and required props (#1818) (836b360)

0.80.0 (2023-08-26)

Features

Bug Fixes

0.79.0 (2023-07-24)

⚠ BREAKING CHANGES

  • loading: remove id prop from Loading (#1783)

Features

  • file-uploader-button: support danger-tertiary, danger-ghost button variants (#1784) (709322c)
  • file-uploader: add size prop to FileUploaderButton (#1786) (51c281d)
  • file-uploader: make labelTitle, labelDescription slottable (#1780) (239f1b1)
  • slider: add hideLabel prop (#1777) (baff07e), closes #1682

Bug Fixes

  • file-uploader: do not render empty element if labelTitle, labelDescription not provided (#1778) (7ef8b73), closes #1775
  • loading: remove redundant description label (#1783) (d6804b4), closes #1670
  • types: correctly type kind prop in FileUploader, FileUploaderButton (#1781) (a7443c2)
  • types: improve formatting of prop comments (#1779) (be76370)

0.78.0 (2023-07-19)

⚠ BREAKING CHANGES

  • typescript: minimum Svelte version for TypeScript users is 3.55

Features

0.77.0 (2023-07-13)

Features

  • ui-shell: add preventCloseOnClickOutside to HeaderAction (#1625) (ea9b261), closes #1624
  • ui-shell: make company in Header slottable (#1764) (9b3f014)

0.76.1 (2023-07-08)

Bug Fixes

  • date-picker: hide helperText if invalid or warning state (#1759) (d5a4a8b)
  • select: hide helperText if invalid or warning state (#1761) (7579c03)
  • slider: disabled Slider should not submit a form (#1758) (ab21c89)
  • types: allow data-* attributes for props forwarded to HTML elements (#1741) (7fdc2ef)

0.76.0 (2023-06-21)

Features

0.75.1 (2023-06-02)

Bug Fixes

  • expandable-tile: set tile height using resize observer (#1738) (a369962)

0.75.0 (2023-05-21)

Features

0.74.0 (2023-05-18)

Features

Bug Fixes

  • resolve a11y warnings from Svelte version 3.58 (#1732) (c02b473)

0.73.5 (2023-03-26)

0.73.4 (2023-03-21)

Bug Fixes

  • selectable-tile: include dispatched events in types (#1695) (ca40dd1), closes #1694
  • text-input: correctly set input padding for warning state (#1688) (821233a), closes #1687

0.73.3 (2023-03-11)

Bug Fixes

  • 1684: hide helper text container in password input when not used (#1685) (42349eb)

0.73.2 (2023-02-27)

Bug Fixes

0.73.1 (2023-02-19)

Bug Fixes

  • textinput/passwordinput: apply aria-describedby to hint text (b435be4), closes #1633

0.73.0 (2023-02-19)

Features

0.72.3 (2023-02-11)

Bug Fixes

  • types: add missing $$restProps for Checkbox, Filename, FluidForm (#1655) (6450e8b)

0.72.2 (2023-02-05)

Bug Fixes

  • dropdown: dispatch correct selectedItem in select event (#1646) (d897484), closes #1645

0.72.1 (2023-01-25)

Bug Fixes

0.72.0 (2023-01-18)

⚠ BREAKING CHANGES

  • tree-view: remove expanded property from TreeNode interface (#1631)

Bug Fixes

  • dropdown: close when user clicks outside iframe (#1596) (73aa6e2), closes #1595
  • tree-view: remove expanded property from TreeNode interface (#1631) (ec867c4), closes #1630

0.71.0 - 2022-12-31

Breaking Changes

  • Select: rename dispatched change event to update
  • Select: forward change event
  • PaginationNav: use 1-indexing to be consistent with Pagination
  • InlineNotification: remove iconDescription prop (replaced with closeButtonDescription and statusIconDescription)

Features

  • Pagination: dispatch change event when user interacts with previous/next buttons, or page/page size dropdowns
  • InlineNotification: add iconDescription and closeButtonDescription props

Documentation

  • link 'source code' to folder for multiple components
  • PaginationNav: add description for change event

0.70.13 - 2022-12-08

Fixes

  • support NumberInput incrementing/decrementing floating point values
  • allow arrow keys to open and navigate Dropdown menu
  • only fire Dropdown "select" event on interaction
  • avoid runtime error if Dropdown items is an empty array
  • avoid runtime error if MultiSelect items is an empty array
  • avoid runtime error if ComboBox items is an empty array
  • fire OverflowMenu "close" event when clicking outside menu
  • fire Popover "click:outside" event when clicking sibling elements
  • forward Toggle "change" and "keyup" events after toggled updates
  • fix ProgressStep label text if vertical
  • make ProgressStep inherit unclickable styles if preventChangeOnClick
  • add explicit type="button" to TableHeader button
  • add explicit type="button" to ProgressStep button
  • loosen TreeView text prop type from string to any
  • make TreeView children prop type work recursively
  • remove unused derived import from DataTable

0.70.12 - 2022-10-13

Fixes

  • Search prop types should extend input attributes

0.70.11 - 2022-10-13

Fixes

  • ignore false positive a11y warnings from Svelte version 3.51
  • NumberInput with allowInput should not be invalid if value is null

0.70.10 - 2022-10-04

Fixes

  • avoid element reference error in ListBoxMenuItem
  • display warn/invalid icons in DatePickerInput with calendar
  • fix layout regression in HeaderSearch
  • localize HeaderAction, ImageLoader transitions

0.70.9 - 2022-09-23

Fixes

  • fix visual regression in next/previous buttons in Pagination, PaginationNav

0.70.8 - 2022-09-21

Fixes

  • forward keyup, keydown, paste events in ToolbarSearch to Search

0.70.7 - 2022-09-17

Fixes

  • prevent submit event on Modal if primary button is disabled

0.70.6 - 2022-09-05

Fixes

  • resolve Toggle, HeaderSearch accessibility warnings in Svelte >=v3.50

0.70.5 - 2022-09-02

Fixes

  • avoid left margin style if Button is icon-only

0.70.4 - 2022-08-31

Fixes

  • correctly scroll item into view when keyboard navigating Dropdown, ComboBox, MultiSelect

0.70.3 - 2022-08-31

Fixes

  • close menu in Dropdown, MultiSelect when pressing "Escape"
  • prevent default behavior in ComboBox when pressing "Enter," "ArrowUp," or "ArrowDown"
  • scroll item into view when keyboard navigating Dropdown, ComboBox, MultiSelect

0.70.2 - 2022-08-29

Fixes

  • allow $$restProps.style to be correctly set on Content

0.70.1 - 2022-08-23

Fixes

  • do not unset Content left margin for rail SideNav
  • set role, aria-label attributes on DatePicker calendar container

0.70.0 - 2022-08-18

Features

  • add filteredRowIds prop to ToolbarSearch to support pagination

0.69.0 - 2022-08-17

Features

  • dispatch on:click:header--select event in DataTable
  • dispatch on:click:row--select event in DataTable

0.68.0 - 2022-08-15

Features

  • add fullWidth prop to ToastNotification
  • dispatch cancelable on:cancel event in ToolbarBatchActions
  • add active prop to ToolbarBatchActions

Documentation

  • add ToastNotification example "Full width"
  • add DataTable example "Batch selection with controlled toolbar"

0.67.9 - 2022-08-11

Fixes

  • NotificationActionButton types should extend Button props

0.67.8 - 2022-08-10

Fixes

  • remove aria-checked="mixed" if InlineCheckbox is indeterminate
  • add aria-labelledby to Slider thumb
  • add role="switch" to Toggle input

0.67.7 - 2022-08-07

Fixes

  • remove UI Shell Content left margin if SideNav is collapsed

0.67.6 - 2022-08-05

Refactor

  • use class directive in TextInput, DatePickerInput

Fixes

  • avoid dynamic class names in NotificationButton, NotificationIcon
  • forward keydown, keyup events to NumberInput

0.67.5 - 2022-08-04

Fixes

  • correctly select a ComboBox item when pressing "Enter"

0.67.4 - 2022-07-26

Fixes

  • override Toggle margin-top style if hideLabel is true

0.67.3 - 2022-07-26

Fixes

  • correctly pluralize Pagination items display text
  • prevent label text selection in Toggle
  • add missing hideLabel prop to Toggle

0.67.2 - 2022-07-23

Fixes

  • display correct ComboBox value if using itemToString and shouldFilterItem props

0.67.1 - 2022-07-12

Fixes

  • set a high z-index on the SideNav overlay to avoid it being covered by other elements

0.67.0 - 2022-06-29

Breaking Changes

Svelte version >=3.48.0 is required.

  • re-revert 924b6d35 to allow close event in ToastNotification, InlineNotification to be cancellable

0.66.3 - 2022-06-29

Fixes

  • revert 924b6d35 and re-publish since v0.66.2 contains breaking changes

0.66.2 - 2022-06-29

Fixes

  • allow close event in ToastNotification, InlineNotification to be cancellable

Documentation

  • add ToastNotification example "Prevent default close behavior"
  • add InlineNotification example "Prevent default close behavior"

0.66.1 - 2022-06-27

Fixes

  • support PasswordInput invalid state when used in a FluidForm
  • remove title attribute from SideNavMenu icon
  • remove tabindex attribute from SideNavMenu icon
  • override max-height in an expanded SideNavMenu
  • fix ComposedModal type error where the focus node is possibly null

Refactor

  • pass required text prop from CodeSnippet to CopyButton to prevent development warning

Documentation

  • add PasswordInput example "Invalid state"
  • rename ComboBox example "Selected id" to "Initial selected id"
  • revise DatePicker example "DatePicker in a modal" to prevent iframe from stealing focus

0.66.0 - 2022-06-18

Features

  • add fullWidth prop to Slider
  • support number type for selected prop in Select

Fixes

  • only dispatch "change" in Select if selected value has changed
  • use first SelectItem value as default selected value in Select if undefined

Documentation

  • add Slider example "Full width"
  • revise Select example "Default" to demo usage without selected prop

0.65.3 - 2022-06-15

Fixes

  • fix TreeView type error when keyboard navigating an expanded node

0.65.2 - 2022-06-12

Fixes

  • DataTable header keys should be reactive
  • use native binding for value prop in TimePicker
  • use native binding for value prop in ComboBox, MultiSelect

0.65.1 - 2022-06-09

Fixes

  • DataTable column sort direction order should be independent

0.65.0 - 2022-06-07

Breaking Changes

  • mark array-type props as read-only

Features

  • add sortKey, sortDirection props to DataTable for programmatic sorting
  • forward paste event to ComboBox, DatePicker, MultiSelect, NumberInput, Search, TextArea, TextInput, PasswordInput, TimePicker, HeaderSearch
  • support disabled items in Dropdown, MultiSelect, ComboBox

Fixes

  • do not overwrite cells property in rows object in DataTable
  • correctly toggle the body class if using nested modals
  • remove useless inline prop from Dropdown
  • remove redundant Dropdown list box role and id
  • add missing role="option" and aria-selected attributes to ListBoxMenuItem

Refactor

  • set alert Modal attributes in markup instead of script

Documentation

  • add DataTable example "Programmatic sorting"
  • add Modal example "Has scrolling content"
  • add Modal example "Custom focus"
  • add Dropdown example "Disabled items"
  • add MultiSelect example "Disabled items"
  • add ComboBox example "Disabled items"

0.64.3 - 2022-05-29

Fixes

  • active tab in Tabs should not steal focus if programmatically selected
  • set title attribute in CheckBox, MultiSelect, Dropdown, ComboBox if label is truncated

Refactor

  • refactor components to use class: directive instead of the class attribute

Documentation

  • add Tabs example "Disabled tabs"

0.64.2 - 2022-05-25

Fixes

  • apply custom DataTable widths to empty columns

0.64.1 - 2022-05-23

Fixes

  • mark CopyButton text prop as required
  • mark Dropdown selectedId prop as required
  • use @see tag in Theme tokens prop description
  • remove title attribute from Modal, ModalHeader close button
  • remove redundant aria-label from Modal close button icon
  • add aria-hidden="true" to Modal, ModalHeader close button icon

Documentation

  • update Theme docs to specify that it must be used with all.css
  • update DataTable docs to note that custom widths do not work with stickyHeader

0.64.0 - 2022-05-14

Breaking Changes

  • set flatpickrProps.static in DatePicker to be true by default
  • use data attribute instead of id for DataTable headers/rows

Features

  • support custom column widths in DataTable
  • dispatch "expand" and "collapse" events in CodeSnippet

Fixes

  • use @see tag for flatpickr options link in DatePicker
  • pressing "Enter" in DatePicker should update the value
  • dispatched event type without detail should be null, not any
  • type missing "open" event in HeaderAction
  • use small button in multi-line CodeSnippet

Documentation

  • make calendar variants of DatePicker more prominent
  • add DataTable example "Custom column widths"
  • add CodeSnippet examples "Expanded by default" and "Reactive example"

0.63.8 - 2022-05-07

Fixes

  • elevate Toolbar z-index so overflow menu is not clipped by the table

0.63.7 - 2022-05-04

Fixes

  • strongly type translateWithId prop in Dropdown

0.63.6 - 2022-05-04

Fixes

  • add translateWithIdsSelection prop to ComboBox, MultiSelect to customize clear selection description
  • use default values in ListBoxMenuIcon if translateWithIds is undefined
  • use default values in ListBoxSelection if translateWithIds is undefined

0.63.5 - 2022-05-02

Fixes

  • dispatch "change" event in Tabs only if selected index has changed

0.63.4 - 2022-04-30

Fixes

  • add missing "2x3" ratio value to AspectRatio
  • fix typo in ToolbarSearch shouldFilterRows type annotation

Documentation

  • correctly generate icon, action imports in examples
  • remove unnecessary tooltipBodyId in Tooltip examples
  • add DataTable "Expandable and selectable" example
  • add DataTable "Batch selection" example

0.63.3 - 2022-04-28

Fixes

  • fix FileUploaderItem regression where delete event should be dispatched if status is "edit"

Documentation

  • add FileUploader "Item (edit)" example
  • revise FileUploader "Item (edit status, invalid state)" example to include on:delete usage
  • add FileUploader "Item (edit status, invalid state with subject, body)" example

0.63.2 - 2022-04-23

Fixes

  • set type="button" on Dropdown to fix usage in a form
  • re-focus search bar when clearing ToolbarSearch value

0.63.1 - 2022-04-18

Fixes

  • HeaderGlobalAction icon size should be 20 by default
  • fix rows reactivity in DataTable

0.63.0 - 2022-04-17

Breaking Changes

  • remove deprecated components: Icon, IconSkeleton, NotificationTextDetails, ToggleSmall, ToggleSmallSkeleton, HeaderActionSearch
  • remove deprecated component props
  • remove optimizeCarbonImports preprocessor
  • remove GlobalHeader and SideNav subfolders
  • move truncate action from actions to src/Truncate

Features

  • add breakpointObserver, breakpoints to base exports
  • add ProgressBar kind prop to support inline, indented variants

Fixes

  • add explicit type="button" attribute to interactive, filterable tag variants
  • add TypeScript support for sveltekit: attributes for anchor elements
  • Link types should extend a or p attributes
  • prevent selectable DataTable with sticky header from jumping

Refactor

  • use icons from carbon-icons-svelte v11

Documentation

  • add DataTable "Sticky header" example
  • refactor Grid examples
  • add note to UIShell that theming is not supported
  • add ProgressBar examples "Inline variant" and "Indented variant"

Housekeeping

  • upgrade carbon-components to v10.56.0

0.62.3 - 2022-03-26

Fixes

  • fix TreeView filter logic in expandNodes/collapseNodes
  • correctly render slotted label in NumberInput
  • only render expandable DataTable row content when expanded

0.62.2 - 2022-03-23

Fixes

  • DataTable expandable variant should work with zebra styles
  • DatePicker flatpickrProps should override default flatpickr options

Documentation

  • add DataTable "Expandable (zebra styles)" example

0.62.1 - 2022-03-20

Fixes

  • fix ToolbarSearch standalone usage where "DataTable" context can be undefined

0.62.0 - 2022-03-19

Breaking Changes

  • remove Copy component
  • do not prevent default submit behavior in Form

Features

  • add shouldFilterRows prop to ToolbarSearch to support auto-filterable DataTable rows
  • make SideNavLink text slottable
  • make icon prop slottable in ContextMenuOption, Link, Tag, HeaderAction, HeaderActionLink, SideNavLink, SideNavMenu
  • make MultiSelect slottable
  • make Dropdown slottable
  • make ComboBox slottable

Fixes

  • stop click propagation on HeaderAction button

Refactor

  • inline Copy component in CopyButton, CodeSnippet
  • use native bind:value in Search
  • use native bind:value in TextArea

Documentation

  • add DataTable "Filterable" and "Filterable (custom)" examples
  • add MultiSelect "Custom slot" example
  • add Dropdown "Custom slot" example
  • add ComboBox "Custom slot" example
  • add note that items object in ComboBox, Dropdown, MultiSelect requires a unique id
  • add ClickableTile "Prevent default behavior" example
  • add Form "Prevent default behavior" example
  • fix broken link in Checkbox docs

0.61.1 - 2022-03-13

Fixes

  • do not generate CSS file from css/_popover.scss

0.61.0 - 2022-03-13

Breaking Changes

  • remove HeaderActionSlideTransition interface from HeaderAction; type transition prop as SlideParams
  • rename Breakpoint "on:match" event to "on:change"
  • move Breakpoint breakpoints to carbon-components-svelte/src/Breakpoint/breakpoints

Features

  • support DataTable non-selectable rows
  • expose MultiSelect highlightedId as a prop
  • add breakpointObserver store as an alternative to Breakpoint

Fixes

  • audit HeaderAction text styles
  • visually align HeaderActionLink icon with HeaderAction icon
  • fix MultiSelect filterable selection error
  • correctly type FileUploaderDropContainer validateFiles prop
  • inline Popover SCSS from carbon-components@10.47

Refactor

  • remove usage of deprecated Icon component
  • use direct component imports where possible

Documentation

  • add DataTable "Non-selectable rows" example
  • add OverflowMenu "Disabled items" example
  • add Breakpoint "Store and Breakpoint Values" example

0.60.0 - 2022-02-26

Features

  • add RadioButtonGroup hiddenLegend prop to visually hide the legend
  • add ProgressBar size prop to support small size variant

Fixes

  • update DatePicker calendar instance if options change

Refactor

  • remove StructuredList overflow-y style monkey patch

Documentation

  • add RadioButton "Hidden legend" example
  • add ProgressBar "Small size" example

Housekeeping

  • upgrade carbon-components to v10.54.0

0.59.0 - 2022-02-21

Features

  • add maxCount prop to TextArea
  • add disabled prop to FileUploader
  • add files prop to FileUploaderDropContainer
  • add files prop to FileUploaderButton

Fixes

  • change add, change events in FileUploaderDropContainer to dispatch File[] instead of FileList
  • update files prop description in FileUploader

Documentation

  • add TextArea "Maximum character count" example
  • add FileUploader disabled state example
  • add FileUploader "Clear files" example
  • document validateFiles prop for FileUploaderDropContainer
  • add descriptions for FileUploaderButton, FileUploader examples

Housekeeping

  • upgrade carbon-components to v10.53.0

0.58.4 - 2022-02-21

Fixes

  • dispatched events without a detail type should be null instead of any
  • FileUploader clearFiles description should reflect that it's an accessor, not a prop
  • FileUploader should correctly fire add and remove events
  • FileUploader files should not be keyed by file name
  • FileUploader change event detail signature should be File[]
  • fix DataTable regression where sort icon indicators don't update

Refactor

  • remove unnecessary JSDoc default type notation

0.58.3 - 2022-02-20

Fixes

  • correctly set deprecation comments for deprecated components
  • TextInput and PasswordInput should render label if "labelText" slot is used
  • PasswordInput should not render label if no labelText is provided
  • StructuredList overflow-y should not be "hidden"
  • MultiSelect should not prevent default key behavior when open
  • Switch should have type="button"

0.58.2 - 2022-02-12

Fixes

  • Tooltip aria-label should use iconDescription if triggerText is falsy
  • OverflowMenu keyboard navigation should skip disabled items
  • UI Shell HeaderPanelDivider should use hr element to represent divider
  • Button should not set aria-pressed on icon-only, link buttons

0.58.1 - 2022-02-11

Fixes

  • remove whitespace from pre tag in CodeSnippet (Svelte v3.46.4 preserves pre whitespace by default)

0.58.0 - 2022-02-11

Breaking Changes

  • if TextInput is type="number", value can be a number or null to signify "no value"
  • TextInput dispatches instead of forwards input, change events (detail: null | number | string)

Features

  • pass rowIndex, cellIndex to DataTable "cell" slot
  • add itemToInput prop to MultiSelect to customize name, title, labelText values
  • add open prop to TooltipDefinition; dispatch open, close events

Fixes

  • DataTable headers should be reactive
  • DataTable batch selection checkbox should be reactive
  • MultiSelect should correctly lose focus
  • non-filterable MultiSelect should dispatch a blur event
  • resolve MultiSelect accessibility issues
  • toggle HeaderNavMenu when pressing "Enter" or "Space"
  • close HeaderNavMenu menu when pressing "Enter" on an item
  • resolve HeaderNavMenu accessibility issues
  • fix TextInput reactivity by using native bind:value

Documentation

  • remove duplicate "Heading variant" example

Housekeeping

  • upgrade carbon-components to v10.52.0

0.57.1 - 2022-02-01

Fixes

  • Tooltip definition is missing open, close events
  • TooltipDefinition button should have type="button"

0.57.0 - 2022-01-30

Breaking Changes

  • make NumberInput "input" event type consistent with "change" (null | number)

Features

  • dispatch NumberInput input, change events when clicking the steppers
  • add primaryButtonIcon prop to Modal, ModalFooter

Fixes

  • prevent NumberInput from coercing empty string to 0

0.56.1 - 2022-01-27

Fixes

  • NumberInput with value 0 should not be converted to null

0.56.0 - 2022-01-27

Breaking Changes

  • type NumberInput value as null | number instead of string | number (null signifies "no value")

Fixes

  • export readonly as a prop in TextArea
  • fix Checkbox two-way binding for checked, group props

Documentation

  • add Checkbox reactive example for bind:checked
  • update Checkbox reactive example for bind:group to demo two-way binding
  • simplify Tabs reactive example
  • add NumberInput "No value" example

0.55.0 - 2022-01-22

Features

  • forward focus, blur events to NumberInput
  • update ProgressStep icons for current, incomplete steps
  • type id as any instead of string in ComboBox, Dropdown, MultiSelect

Fixes

  • do not coerce empty value to 0 in NumberInput if allowEmpty is true
  • label Slider input if aria-label not explicitly defined
  • add missing required prop to RadioButton
  • add missing required prop to Checkbox
  • include @default undefined annotations for props that are undefined by default

Refactor

  • remove hotfix in DatePicker to prevent disabled icon from being clickable

Housekeeping

  • upgrade carbon-components to v10.51.0

0.54.0 - 2022-01-19

Features

  • support paginated DataTable

0.53.0 - 2022-01-18

Breaking Changes

  • replace selectedIndex with selectedId in Dropdown
  • replace selectedIndex with selectedId in ComboBox

Fixes

  • prevent Dropdown icon from being clickable when disabled

0.52.0 - 2022-01-17

Features

  • make Toggle labels slottable
  • add option to ComboBox.clear to not re-focus input (clear({ focus: false }))

Fixes

  • break out of trap focus in Tooltip when pressing "Escape"
  • pass "name" prop in ComboBox to input element
  • emit change event in Checkbox after modifying state
  • restore explicit typing of null | HTMLElement for TypeScript strict mode
  • dispatch click:button--primary in Modal if shouldSubmitOnEnter is true

Documentation

  • simplify reactive RadioButton example
  • add reactive Select example for Select
  • fix grammar in TreeView "Expand all nodes" example
  • note that Search clear event is also dispatched when pressing "Escape"
  • demo reactivity in expandable Search example

0.51.3 - 2022-01-12

Fixes

  • fix selectedIndex reactivity in ComboBox

Refactor

  • remove redundant null in null | HTMLElement prop types

0.51.2 - 2022-01-10

Fixes

  • correctly reset values in ComboBox when manually clearing selection
  • fix filterable ComboBox keyboard selection
  • remove redundant role attributes from Dropdown, Header to fix a11y warnings
  • fix TileGroup two-way binding on the selected prop

Documentation

  • document DatePicker usage with a Rollup set-up
  • add multiple modals example for Modal
  • add reactive examples for RadioTile

0.51.1 - 2022-01-03

Fixes

  • add missing required prop to Select
  • set global theme variable first in SCSS files

0.51.0 - 2021-12-30

Features

  • enhance Checkbox to support bind:group

0.50.5 - 2021-12-30

Fixes

  • filterable MultiSelect should blur when pressing "Tab"
  • filterable MultiSelect menu should close when pressing "Escape"
  • filterable MultiSelect menu should open when pressing "Space"
  • DatePicker input should not lose focus when pressing "Enter"
  • ToolbarSearch should expand if value is programmatically set

0.50.4 - 2021-12-30

Fixes

  • pressing "Escape" in a DatePicker should not propagate past the open calendar
  • prevent menu icon in filterable MultiSelect from triggering twice

0.50.3 - 2021-12-28

Fixes

  • do not dispatch "click", "click:row" DataTable events when selecting a checkbox or radio button
  • render "labelText" slot if labelText prop or $$slots.labelText is truthy
  • prevent default behavior in Tabs mobile variant when clicking a menu option
  • coalesce nullish values to "" for TextInput, PasswordInput, TextArea

0.50.2 - 2021-11-27

Fixes

  • select correct item in filterable MultiSelect using keyboard navigation
  • do not mutate sortedItems in MultiSelect

0.50.1 - 2021-11-19

Fixes

  • do not dispatch DataTable "click", "click:row" events if target is an OverflowMenu

0.50.0 - 2021-11-18

Features

  • add target prop to ContextMenu to support custom trigger element(s)
  • pass clicked element as event.detail in ContextMenu "open" event

0.49.2 - 2021-11-18

Fixes

  • Tabs should not dispatch an initial "change" event when no change has occurred
  • Pagination page value should not exceed total pages
  • fix Popover relative prop by inlining style
  • replace onDestroy with onMount return function to avoid running code server-side

0.49.1 - 2021-11-17

Fixes

  • include missing Popover styles from carbon-components@10.47

0.49.0 - 2021-11-12

Features

  • support UIShell HeaderNavMenu with current item
  • make InlineNotification title, subtitle props slottable
  • make ToastNotification title, subtitle, and caption props slottable

Refactor

  • remove unnecessary "position: relative" style in ExpandableTile
  • remove unused refContent in ExpandableTile

Housekeeping

  • upgrade carbon-components to v10.48.0

0.48.1 - 2021-11-12

Fixes

  • type DatePicker locale prop as flatpickr CustomLocale or key
  • update remaining carbon-icons-svelte imports to use inlined icons

0.48.0 - 2021-11-11

Breaking Changes

  • remove carbon-icons-svelte from direct dependencies

Features

  • support auto-width Tabs
  • add ref prop to Form

Fixes

  • set calendar instance to null when destroying DatePicker

0.47.6 - 2021-11-10

Fixes

  • fix Tooltip two way binding when icon is in focus
  • coerce TextInput value to a number if type="number"

0.47.5 - 2021-11-07

Fixes

  • fix Tooltip open/close logic to allow two way binding of the open prop
  • inline position: relative style in ExpandableTile

0.47.4 - 2021-11-06

Fixes

  • only dispatch click:row--expand when clicking an expandable DataTable row chevron

0.47.3 - 2021-10-22

Fixes

  • correctly toggle batch expansion button in DataTable

0.47.2 - 2021-10-21

Fixes

  • close the open Tooltip when using multiple tooltips
  • collapse batch expansion button in DataTable if one or more rows is collapsed
  • omit explicit reference to "carbon-icons-svelte" from icon prop descriptions

0.47.1 - 2021-10-20

Fixes

  • include border style for non-expandable rows in a batch expandable DataTable

0.47.0 - 2021-10-19

Features

  • add nonExpandableRowIds prop to DataTable to specify rows that should not be expandable

0.46.0 - 2021-10-17

Breaking Changes

  • use .svelte.d.ts extension instead of .d.ts for Svelte component TypeScript definitions

Features

  • support Tag outline type
  • add hideLabel prop to MultiSelect
  • allow any Svelte component to be used for icon props, not just CarbonIcon
  • add closeIcon prop to HeaderAction to override the default Close20 icon

Fixes

  • avoid opening the calendar if DatePickerInput is a disabled fieldset descendant
  • remove stopPropagation modifier from HeaderAction to allow multiple UI Shell app switchers

Housekeeping

  • upgrade carbon-components to v10.46.0

0.45.1 - 2021-10-15

Fixes

  • prevent space/enter keys from selecting incomplete ProgressIndicator steps

0.45.0 - 2021-10-13

Features

  • add TreeView component accessors to programmatically expand/collapse nodes

0.44.7 - 2021-10-13

Fixes

  • add missing value prop to Checkbox

0.44.6 - 2021-10-11

Fixes

  • fix DataTable sorting to tolerate null, undefined values

0.44.5 - 2021-10-04

Fixes

  • correctly apply menuOptionsClass in OverflowMenu

0.44.4 - 2021-09-28

Fixes

  • ClickableTile TypeScript definition restProps should extend attributes of either a or p tags

0.44.3 - 2021-09-23

Fixes

  • correctly apply styles when using a static width DataTable with a title and description

0.44.2 - 2021-09-14

Fixes

  • prevent redundant clear events in ComboBox

0.44.1 - 2021-09-11

Fixes

  • if ComboBox is disabled, clicking the chevron icon should not toggle the dropdown
  • ToolbarBatchActions cancel button text should be slottable

0.44.0 - 2021-09-07

Features

  • add ability to override or customize DatePicker calendar options using the flatpickrProps prop

0.43.0 - 2021-09-06

Features

  • add ability to programmatically clear a ComboBox using the clear component accessor

0.42.3 - 2021-09-05

Fixes

  • RadioButton "labelText" slot should render even if labelText is falsy
  • only render FormGroup legend element if legendText is truthy

0.42.2 - 2021-07-29

Fixes

  • fix reactivity regression in ComboBox

Documentation

  • update example set-ups
  • document styling instructions, carbon-preprocess-svelte in README.md

0.42.1 - 2021-07-26

Fixes

  • disable a11y-mouse-events-have-key-events warnings
  • upgrade carbon-icons-svelte to v10.36.0 to quell a11y-mouse... warnings

Refactor

  • remove formatStyle utility in OverflowMenu

Documentation

  • add svelte:head example usage for loading CDN styles
  • add instructions for dynamic theming
  • update number of available Carbon icons

0.42.0 - 2021-07-22

Features

  • add helperText prop to DatePickerInput

Fixes

  • replace svelte:body with svelte:window when listening for an outside click

Documentation

  • fix typos in styling instructions
  • update expanded nodes guidance
  • add DatePicker example "With helper text"

Refactor

  • omit explicit treeview.scss import in css/*.scss files as it is included by default in carbon-components@10.40

Housekeeping

  • upgrade carbon-components to v10.40.0

0.41.0 - 2021-07-18

Features

  • add expandedIds to TreeView

Fixes

  • do not fall back to an empty string for a DataTable value if falsy
  • omit disabled attribute in Button if value is falsy

Documentation

  • add styling instructions to the home page

0.40.1 - 2021-07-14

Fixes

  • focus first, non-disabled TreeView node if active id does not match the selected id
  • set type="button" on OverflowMenu to prevent submit behavior when pressing "Enter"
  • update semantic attributes in OverflowMenuItem
  • do not render OverflowMenuItem title attribute if using a slot
  • do not dispatch NumberInput on:change event on initialization
  • dynamically load ESM flatpickr rangePlugin
  • forward input, focus events to Select
  • type DataTableRowId as any, fixes

0.40.0 - 2021-07-11

Breaking Changes

  • remove appendTo prop in DatePicker for server-side rendering (SSR) compatibility

Features

  • add Breakpoint component to detect the current Carbon grid size based on browser width
  • add Theme component to dynamically update the current theme client-side
  • add valueFrom, valueTo props for range DatePicker
  • export multiSelectRef, fieldRef, selectionRef in MultiSelect
  • add clearItem, clearAll instance methods to LocalStorage
  • support NumberInput readonly variant

Fixes

  • append DatePicker instance to local reference to prevent arrow key locking
  • fix on:change type signature in DatePicker
  • export id prop in ProgressBar
  • add skeleton text for every row and column in DataTableSkeleton
  • deprecate shouldShowBorder prop in Table
  • correctly type exported constant props and function declarations as accessors in SvelteComponentTyped interface

Documentation

  • document Breakpoint component
  • document Theme component
  • add ProgressBar "UX example"
  • add DatePicker example "Range"
  • add NumberInput example "Read-only variant"

Housekeeping

  • upgrade carbon-components to v10.39.0

0.39.0 - 2021-07-05

Breaking Changes

  • remove clipboard-copy direct dependency; use native Clipboard API instead of clipboard-copy to copy text in CopyButton, CodeSnippet

Features

  • add TreeView component
  • add RecursiveList component
  • support 3 buttons in Modal, ComposedModal via secondaryButtons
  • make DataTable title/description slottable
  • allow custom expansionBreakpoint in UI Shell Header, SideNav
  • dispatch "click:button--primary" as an alias to "submit" in Modal, ComposedModal

Fixes

  • export useStaticWidth prop in DataTable
  • do not render DataTable table header if title/description not provided

Documentation

  • add TreeView documentation
  • add RecursiveList documentation
  • add CopyButton examples "Overriding copy functionality", "Preventing copy functionality"
  • add CodeSnippet examples "Overriding copy functionality", "Preventing copy functionality"
  • add DataTable example "Static width"
  • include typedefs in Component API section

0.38.2 - 2021-07-03

Fixes

  • prevent <TextArea readonly={false} /> from being read-only
  • only focus OveflowMenuItem if not disabled
  • trap tab focus within Modal, ComposedModal

0.38.1 - 2021-06-29

Fixes

  • add Gray 80 (g80) theme to all.scss and the pre-compiled all.css

0.38.0 - 2021-06-27

Features

  • support read-only TextInput
  • render a checkmark icon for the selected ComboBox item

Fixes

  • adjust FileUploaderDropContainer markup to avoid accessibility error for nested interactive controls
  • use ErrorFilled16 icon in InlineLoading for the error status
  • render iconDescription as title in error/warning icons in InlineLoading
  • update accessibility attributes for StructuredList
  • use span instead of div in TooltipDefinition to avoid potential invalid HTML
  • close MultiSelect menu when blurring the last filterable option
  • open/focus field when tab focusing a filterable MultiSelect
  • unblock tab navigation when blurring MultiSelect
  • select correct item using keyboard navigation in a filterable ComboBox
  • unblock input after clearing a ComboBox selection
  • update ComboBox input text if item is selected
  • toggle SideNav rail when clicking the hamburger menu
  • update ContextMenu class names
  • close ContextMenu when left clicking anywhere

Documentation

  • add TextInput example "Read-only variant"
  • add Popover example "Popover alignment"

Housekeeping

  • upgrade carbon-components to v10.38.0

0.37.0 - 2021-06-26

Features

  • add ProgressBar component

Fixes

  • omit size prop in ToolbarSearch
  • omit passing iconDescription to NotificationIcon in InlineNotification, ToastNotification

Refactor

  • use class directive in TextInput

Documentation

  • add ProgressBar component documentation

Housekeeping

  • upgrade carbon-components to version 10.37.0

0.36.0 - 2021-06-26

Features

  • add condensed, flush props to StructuredList
  • support SideNav rail
  • add isSelected prop to HeaderNavItem
  • make components with labelText prop slottable (e.g., ...)

Fixes

  • set min/max height for multi-line CodeSnippet
  • make ImageLoader SSR compatible by using a window type check guard
  • default isSelected to false in SideNavMenuItem
  • forward keydown event to TextArea
  • deprecate border prop in StructuredList

Documentation

  • add separate disabled example for filterable/interactive tags
  • update number of supported chart types from 17 to 20

Housekeeping

  • upgrade carbon-components to version 10.36.0

0.35.0 - 2021-06-26

Features

  • support expressive styles for Button, UnorderedList, OrderedList
  • support large size for Button (size="lg")
  • support large, extra-large ButtonSkeleton sizes
  • support field, small sizes for FileUploaderItem
  • allow custom Search icon
  • allow NumberInput input steppers to be hidden (hideSteppers={true})
  • add icon prop to TooltipIcon
  • support disabled TooltipIcon

Fixes

  • make Tooltip screenreader description less verbose

Documentation

  • add Button examples "Large size", "Expressive styles"
  • add OrderedList example "Expressive styles"
  • add UnorderedList example "Expressive styles"
  • add Search example "Custom search icon"
  • add NumberInput example "Hidden steppers"
  • add TooltipIcon example "Disabled"

Housekeeping

  • upgrade carbon-components to version 10.35.0

0.34.0 - 2021-06-25

Features

  • add new Gray 80 (g80) theme
  • support expandable Search variant
  • dispatch open, close, click:overlay events in SideNav
  • allow custom hamburger menu icons (iconMenu, iconClose)
  • support "xl" Button size
  • support "medium" DataTable size
  • support warning state, inline variant for PasswordInput

Fixes

  • replace <strong> with semantic paragraph element for file uploader label
  • wrap code element with pre
  • add missing restProps annotation to ToolbarSearch

Refactor

  • remove usage of deprecated Icon component
  • use button specific tooltip class for icon-only variant

Documentation

  • update available site theming options to include Gray 80 (g80)
  • add Search example "Expandable variant"
  • add Button example "Extra-large size"
  • add DataTable example "Medium rows"
  • add PasswordInput examples "Inline" and "Warning state"

Housekeeping

  • upgrade carbon-components to version 10.34.0

0.33.0 - 2021-04-30

Features

  • support nested object values for DataTable sorting
  • pass DataTable header display function to slotted cell
  • add icon prop to Link to support rendering links with icons; refactor OutboundLink to use Link.icon prop

Fixes

  • prevent DataTable sorting from crashing by defaulting undefined to an empty string
  • add extra DataTable cell colspan to support expandable, selectable rows
  • support disabled state for ClickableTile
  • add missing "3x2" ratio to AspectRatio

Documentation

Housekeeping

  • upgrade carbon-components to version 10.33.0

0.32.2 - 2021-04-23

Fixes

  • prevent multiple Dropdown items from being selected by updating the selectedId
  • prevent the default keydown behavior so that pressing "Enter" should open the Dropdown menu
  • resolve Carbon icon imports to Svelte files in DataTable, HamburgerMenu components

Housekeeping

  • patch carbon-components to version 10.32.1

0.32.1 - 2021-04-02

Fixes

  • hotfix compiled CSS to correctly render default background color for inputs

0.32.0 - 2021-04-02

Breaking Changes

  • copy text by default in CodeSnippet and CopyButton using clipboard-copy
  • deprecate light prop in ContentSwitcher

Features

  • support disabled state for SelectableTile, RadioTile
  • add TooltipFooter component
  • support OverflowMenu in Breadcrumbs
  • support danger kind for ContextMenuOption
  • allow sorting to be disabled for a specific header in DataTable
  • render an empty header column in DataTableSkeleton if a value is { "empty": true }
  • export inputRef prop in MultiSelect
  • add searchClass prop to Search, which is passed to the outermost element
  • add noMargin prop to FormGroup to remove default bottom margin (default value is false)

Fixes

  • render initial ContextMenu position based on viewport constraints
  • correctly display invalid text in TimePicker
  • remove outer div in ToolbarSearch
  • set hasScrollingContent class on ModalBody

Documentation

  • add disabled state examples for SelectableTile, RadioTile
  • add expandable DataTable size examples, empty header column DataTableSkeleton example
  • remove the light ContentSwitcher example

Housekeeping

  • upgrade carbon-components to version 10.32.0
  • add clipboard-copy to direct dependencies

0.31.1 - 2021-03-28

Fixes

  • add missing "name" attribute to non-mobile NumberInput
  • forward missing "keydown" event to Form
  • forward click/keydown/mouse events in FluidForm to Form

0.31.0 - 2021-03-20

Breaking Changes

  • remove default title value in InlineNotification
  • remove default title, caption values in ToastNotification
  • remove iconDescription prop from HeaderNavMenu

Features

  • add Popover component
  • add ContextMenu component
  • add "container" type for TabsSkeleton
  • add warning state to Select
  • dispatch "on:click:button--next" and "on:click:button--previous" in Pagination

Fixes

  • replace chevron icons with "Add" and "Subtract" icons in NumberInput
  • fix Slider markup to use CSS to hide input if hideTextInput is true
  • remove hotfix inline style to center dropdown chevron
  • add "rowgroup" role to StructuredListBody
  • fix type definition for MultiSelect: "clear" should be typed as a custom event
  • remove line breaks in anchor element in Link
  • only set autofocus attribute if the value is true

Documentation

  • add Slider hidden text input, invalid, disabled examples
  • add Select warning, invalid, helper text, skeleton (hidden label) examples
  • add RadioButton disabled buttons example
  • update sample copy in ToastNotification, InlineNotification
  • update Select item groups example to use the hidden default option

Housekeeping

  • upgrade carbon-components to version 10.31.0
  • upgrade carbon-icons-svelte to version 10.27.0 (icons are correctly typed using SvelteComponentTyped)

0.30.0 - 2021-03-13

Breaking Changes

  • forward $$restProps to the input element in Search, MultiSelect, ComboBox, TimePicker, DatePickerInput, NumberInput

Features

  • add ImageLoader component
  • add LocalStorage component
  • forward "clear" event in ToolbarSearch
  • add isSelected prop for icon-only, ghost buttons
  • add legendText prop/slot to RadioButtonGroup
  • add interactive prop to Tag
  • make UI Shell SideNavMenuItem text slottable
  • deprecate Icon, IconSkeleton

Fixes

  • set aria-hidden attribute in UI Shell SideNav
  • only show overlay for non-fixed UI Shell SideNav
  • correctly render skeleton styles for TextInputSkeleton
  • only render RadioButton label if labelText is truthy
  • deprecate the NumberInput mobile variant
  • add missing type annotation for dispatched MultiSelect select event
  • remove redundant "button" role in Button
  • update styles for ListBoxSelection to fix filterable MultiSelect
  • temporarily apply override styles to ListBoxMenuIcon to correctly render Dropdown chevron icon
  • apply z-index: 1 on tooltip when open; style can be overridden through $$restProps.style

Documentation

  • add "on:clear" example for Search
  • add custom tooltip example for PasswordInput
  • add legend text examples for RadioButtonGroup
  • add filterable (disabled) variant for Tag
  • remove the mobile variant example for NumberInput

Housekeeping

  • upgrade carbon-components to v10.30.0

0.29.2 - 2021-03-01

Fixes

  • remove blank line after slot to correctly render button with icon in Safari 13

0.29.1 - 2021-02-26

Fixes

  • fix blur logic in ComboBox, MultiSelect based on relatedTarget tag name
  • fix truncate action to preserve existing class names on node
  • use new component tokens to correctly render CSS for tags, low contrast notifications

0.29.0 - 2021-02-19

Breaking Changes

  • The default placeholder text for TimePicker is changed from "hh=mm" to "hh:mm"

Features

  • Add UI Shell SideNavDivider component
  • Add a direction prop to ComboBox, Dropdown, MultiSelect to render the dropdown menu above or below the input
  • Support ComboBox warning state
  • Add text truncation component (Truncate) and action (use:truncate)
  • Use shorthand scss imports in css/*.scss files
  • Use the official SvelteComponentTyped interface in the component TypeScript definitions

Fixes

  • Use description as warning icon title in ProgressStep
  • Include pre-compiled CSS to library side effects to prevent inadvertent tree-shaking
  • Fix DataTable type definition to include $$restProps

Documentation

  • Add filterable small Tag example
  • Add ComboBox invalid state example
  • Add "Top direction" examples for ComboBox, Dropdown, MultiSelect
  • Demo ProgressIndicator invalid/disabled steps
  • Fix RadioTile light variant example

Housekeeping

  • Upgrade carbon-components to version 10.29.0

0.28.0 - 2021-02-05

Breaking Changes

  • The transitionend event in ComposedModal is dispatched, not forwarded; it will only trigger when the modal has finished animating

Features

  • Support small size variant for Tag (size="sm")
  • Dispatch close event in a filterable Tag (an alias for click)
  • Dispatch toggle event in Toggle
  • Make tooltipText slottable in TooltipIcon (slot name="tooltipText")
  • Add hideLabel prop to Dropdown
  • Dispatch transitionend event in Modal, ComposedModal to fire after the modal has finished animating
  • Add warn state to DatePickerInput

Fixes

  • Forward the click event to Tab
  • Do not trigger initial Tab focus when mounting

Documentation

  • Add a "Hidden label" example for the Select component
  • Add a light variant example for OverflowMenu
  • Add a reactive example for Tabs

Housekeeping

  • Upgrade carbon-components to version 10.28.0
  • Remove unused @carbon/themes development dependency; themes are pulled from carbon-components

0.27.0 - 2021-01-28

Features

  • Ship scss files used to pre-compile CSS
  • Add optimizeCarbonImports preprocessor to rewrite base imports from Carbon components/icons/pictograms to the source Svelte file
  • Support warning state in Dropdown, MultiSelect, NumberInput
  • Set default values for Button tooltipAlignment ("center") and tooltipPosition ("bottom") in Button
  • Infer icon-only Button variant using $$slots API
  • Support disabled state for CodeSnippet (single or multi type only)
  • Add optional expand/collapse icon labels to ExpandableTile
  • Support custom icon variant for Tag
  • Add timeout to dispatched on:close event detail in InlineNotification and ToastNotification
  • Upgrade flatpickr to version 4.6.9 for ES module (ESM) imports

Fixes

  • Co-locate DataTableSkeleton with DataTable components
  • Prevent MultiSelect dropdown from opening if disabled
  • Forward submit event to FluidForm
  • Correctly apply class props in ModalHeader
  • Add missing warning class to TextInput
  • Disable visibility toggle if PasswordInput is disabled
  • "Show more" button in CodeSnippet should be "field" sized, not small
  • Remove extraneous "bx--btn--copy" class from CodeSnippet
  • Adjust Loading spinner styles to remove excess padding
  • Prevent class from being overridden by $$restProps in InlineNotification, ToastNotification, NotificationActionButton
  • Remove extraneous focus ring in Modal
  • Remove aria-hidden prop from ToolbarSearch
  • Add label id to Slider
  • Remove menubar role from HeaderNav; deprecate ariaLabel prop in HeaderNav in favor of real HTML attributes "aria-label" and "aria-labelledby"
  • Remove notificationType prop from InlineNotification and ToastNotification
  • Focus the first item when opening an OverflowMenu for the first time
  • Close the OverflowMenu on the focusout event
  • Forward $$restProps to the input element for TextInput, PasswordInput

Breaking Changes

  • DataTableSkeleton.svelte is moved to src/DataTable
  • notificationType is removed from InlineNotification and ToastNotification
  • Svelte version 3.25 or greater is required due to use of the $$slots API
  • $$restProps are forwarded to the input element for TextInput, PasswordInput
  • renderIcon prop renamed to icon in NotificationButton
  • icon prop type changed to "typeof import("carbon-icons-svelte").CarbonIcon" in HeaderAction, HeaderActionLink, SideNavLink, SideNavMenu
  • Pre-compiled CSS StyleSheets use the "compressed" sass.outputStyle instead of "compact"

Documentation

  • Add documentation for dynamic, client-side theming
  • Add icon-only example for the "danger-tertiary" Button
  • Update number of supported Carbon icons and pictograms
  • Use more realistic body copy in Notification usage examples
  • Update development workflow in the contributing guidelines

Housekeeping

  • Replace node-sass with sass
  • Upgrade carbon-components to version 10.27.0
  • Upgrade @carbon/themes to version 10.26.0
  • Upgrade autoprefixer, postcss, prettier-plugin-svelte

0.26.0 - 2020-12-11

Features

  • Render the UI Shell hamburger menu only if the SideNav component is present (PR #457, issue #434)
  • Clear the Search input value if the "Escape" key is pressed (PR #448)
  • Customize the Tooltip alignment using the align prop (PR #446, issue #398)

Fixes

  • Fix files prop type FileUploader to be a list of Files instead of file names (PR #437)
  • Allow binding decimal values in NumberInput (PR #444)
  • Spread $$restProps in DataTableSkeleton to the top-level element to be consistent with DataTable (PR #441, issue #423)
  • Close the Tooltip on the mousedown event; re-focus the tooltip icon after closing and forward click, mousedown events
  • Focus the Dropdown button correctly for multiple dropdowns (PR #447)
  • Focus the ComboBox input correctly for multiple combo boxes (PR #447)
  • Blur an opened ComboBox when clicking a search input (PR #447, issue #436)
  • Prevent cursor shift in UI Shell HeaderSearch when using the up/down arrow keys to navigate results (PR #432, issue #431)
  • Deprecate small prop in ButtonSkeleton
  • Fix CodeSnippetSkeleton type to only be "single" or "multi"

Breaking Changes

  • files in FileUploader components is a list of Files, not just file names
  • $$restProps is spread to the top-level element in DataTableSkeleton

Documentation

  • Add reactive, hidden, custom alignment examples for Tooltip
  • Add reactive examples for Search, ContentSwitcher, Toggle components
  • Add plain Header (no SideNav) UI Shell example

Housekeeping

  • Upgrade carbon-components to version 10.25 for the pre-compiled CSS StyleSheets

0.25.1 - 2020-11-28

Fixes

  • set selectedResultIndex in HeaderSearch when clicking a result (PR #430, issue #429)

0.25.0 - 2020-11-27

Features

  • Add padding prop to Grid, Row, Column components (PR #420, issue #410)
  • Add transition prop to UI Shell HeaderAction to customize panel slide transition; by default, the slide duration is 200ms (PR #419, issue #384)

Fixes

Documentation

Housekeeping

  • pin development dependency sveld to version 0.3.0

Contributors

0.24.0 - 2020-11-26

Features

  • Add HeaderSearch component for the UI Shell that can render user-provided search results (PR #417, issue #395); HeaderActionSearch is deprecated in favor of HeaderSearch
  • Expand headers prop type in DataTableSkeleton to be consistent with that of the DataTable (PR #415, issue #413)

Fixes

  • Update DataTableRow prop type in DataTable to require an "id" key and value (PR #415, issue #414)

Documentation

0.23.2 - 2020-11-25

Fixes

  • Fix dispatched "change" event in RadioButtonGroup (PR #408)
  • Export component types and interfaces (PR #411, issue #409)

0.23.1 - 2020-11-22

Fixes

  • Fix selected prop reactivity in RadioButtonGroup so that it can be programmatically updated (PR #407, issue #406)
  • Allow click propagation in ListBox so that list box menus can close correctly; this fixes behavior in the ComboBox, Dropdown, and MultiSelect components (PR #405, issue #388)

Documentation

0.23.0 - 2020-11-20

Features

  • Persist UI Shell Header hamburger menu if persistentHamburgerMenu is true (PR #396, issue #374, rendered example)
  • Disable auto focus in ComposedModal if selectorPrimaryFocus is null (PR #393)
  • Use small size Toggle variant if size is "sm"; deprecate ToggleSmall which will be removed in the next major release (PR #401)

Fixes

  • Fix currentIndex reactivity in ProgressIndicator so that it can be programmatically updated (PR #404, issue #399)

Refactoring

  • Rewrite TypeScript definitions with better type signatures for slots, dispatched events; fix IntrinsicAttributes errors (PR #385, issue #304)
  • Remove useless if statement that wraps svelte:component in Button; by design, svelte:component will not render falsy values (PR #402)

Documentation

Housekeeping

  • Upgrade carbon-icons-svelte from version ^10.17 to ^10.21

Breaking Changes

  • Internal component TypeScript interfaces are no longer exported to avoid polluting library exports

0.22.0 - 2020-10-30

Features

  • Button: add "danger-tertiary", "danger-ghost" kinds
  • OverflowMenu: support "sm", "xl" size variants
  • TimePicker: support "sm", "xl" size variants
  • Link: support "sm", "lg" size variants
  • OrderedList: support native list styles
  • MultiSelect: forward "clear" event
  • MultiSelect: dispatch "select" event to be consistent with ComboBox, Dropdown

Fixes

  • OverflowMenu: dynamic menu shadow width should be scoped to component instance; remove tabindex attribute from trigger button
  • CodeSnippet: showMoreLess should be re-computed if code is dynamically updated

Documentation

  • Document itemToString prop for Dropdown, MultiSelect
  • MultiSelect: add example for "Initial selected items"
  • CodeSnippet: add example for dynamically updating code
  • CodeSnippet: add example for "Hidden code snippet" edge case (issue #373)
  • OverflowMenu: add example for "Custom trigger icon"

Housekeeping

  • upgrade carbon-components to v10.23.1, @carbon/themes to v10.22.1
  • bump/patch development dependencies

0.21.0 - 2020-10-26

Features

  • ListBoxMenu: forward "scroll" event (PR #366)
  • ComboBox: export reference to list box menu (PR #366)
  • DataTable: add ToolbarMenu, ToolbarMenuItem (PR #369)
  • DataTable: support empty table body columns by adding optional empty key to headers prop (PR #370)
  • Dropdown: support "sm", "xl" field sizes

Fixes

  • DataTable: cancelling batch selection should deselect "select all rows" checkbox
  • Toolbar: remove duplicate "bx--toolbar-content" element

Documentation

  • DataTable: add example "Empty column with overflow menu"
  • hand off current theme for examples opened in a new tab
  • add field size examples for Dropdown, MultiSelect, Select

0.20.0 - 2020-10-24

Features

  • DataTable: add Toolbar, ToolbarContent, ToolbarSearch, ToolbarBatchActions
  • DataTable: support row selection, batch selection, radio selection
  • DataTable: dispatch "mouseenter", "mouseleave" events on table rows
  • Search: forward "focus", "blur" events to search input; dispatch "clear" event

Fixes

  • DataTable: include sort direction with custom sort method (PR #356)
  • fix: allow item ids in ComboBox, Dropdown, MultiSelect to be numbers
  • fix(ui-shell): initialize platformName as empty string to prevent rendering as "undefined"

Refactoring

  • refactor(ui-shell): remove redundant conditional in HeaderGlobalAction

Documentation

0.19.0 - 2020-10-23

Features

  • DataTable: add optional display and sort methods in header object (PR #352)
  • ProgressIndicator: add preventChangeOnClick; default value is false (PR #351)
  • TooltipDefinition: make tooltip text slottable through slot="tooltip"

Fixes

  • ProgressIndicator: make currentIndex reactive (PR #351)
  • ComposedModal: use onDestroy for destroy logic due to async usage of onMount(PR #348)
  • Search: forward size prop to Search skeleton

Refactoring

  • TooltipDefinition: remove redundant hidden reactive variable

Breaking Changes

  • ProgressIndicator: clicking a completed step will update currentIndex; to opt out of this default behavior, set preventChangeOnClick to true

Documentation

  • ContentSwitcher: add "Selected index" example
  • CodeSnippet: add multi-line skeleton example
  • InlineLoading: add UX example showcasing various statuses

0.18.0 - 2020-10-17

Features

  • DataTable: support individual, batch row expansion (PR 341)
  • DataTable: make header, row cells slottable (PR 342)

Fixes

  • fix(data-table): fix misaligned tall row table headers (PR 340)
  • Documentation generator: parse ArrayExpression in exported props (PR 341)

Breaking Changes

  • Remove top-level slot in DataTable in favor of named slots (PR 341)

Documentation

  • add Component API metadata (PR 340)
  • DataTable: add expandable, batch expandable examples (PR 341)
  • DataTable: add slottable cells example (PR 342)

0.17.0 - 2020-10-16

Features

  • feat: set rel="nooopener noreferrer" if target="_blank" on link components (PR #321)
  • feat: support Search disabled state (PR #330)
  • feat(button-skeleton): add size prop consistent with Button (PR #332)
  • feat(progress-indicator-skeleton): add count prop (PR #332)
  • feat(accordion): add disabled prop for Accordion and AccordionItem (PR #333)
  • feat(accordion): add "sm", "xl" size variants to Accordion and AccordionSkeleton (PR #333)
  • feat(content-switcher): add "sm", "xl" size variants (PR #334)
  • feat(code-snippet): add wrapText prop for "multi" type CodeSnippet (PR #335)
  • feat(aspect-ratio): add AspectRatio component (PR #336)
  • feat(dropdown): dispatch select event, use window instead of body for click events (PR #339)

Fixes

  • fix(combo-box): disabled combobox should not open (PR #329)
  • fix(inline-loading): add wrapper class "bx--inline-loading" (PR #332)
  • fix(breadcrumb): forward noTrailingSlash to skeleton (PR #332)
  • fix(skeleton-text): unkey paragraph rows due to high collision rate (PR #332)
  • fix(accordion-skeleton): forward align prop (PR #333)

Refactoring

  • refactor(icon): remove old logic that inferred icon size from function name (PR #332)

Documentation

  • AspectRatio (new component): demo all ratios
  • Breadcrumb: use noTrailingSlash in skeleton example
  • Button: demo skeleton size variants
  • CodeSnippet: add example "Wrap text"
  • ComboBox: add examples "Light variant," "Filterable"
  • ContentSwitcher: add examples "Extra-large size" and "Small size"
  • SkeletonText: add example "Paragraph with custom line count"
  • Pagination: add example "Hidden page size"
  • ProgressIndicator: demo custom step count for skeleton
  • Link: add example Target _blank
  • MultiSelect: add example "No alphabetical sorting"
  • Accordion: add examples for "Extra-large" and "Small" size variants
  • Accordion: add examples for "Disabled" and "Disabled (item)"
  • AccordionSkeleton: add examples "Skeleton (chevron aligned left)" and size variants

Housekeeping

  • chore(deps-dev): bump carbon-components to ^v10.22 (PR #337)
  • retire Storybook by removing Storybook-related dependencies, set-up and stories (PR #331)
  • use npm-run-all to run build:css and build:lib in parallel (PR #331)

0.16.0 - 2020-10-12

Features

  • Pagination: add pageSizeInputDisabled prop to hide page size buttons (default is false) (PR #292)
  • ListBoxMenu: add ref prop (PR #303)
  • Pre-compiled CSS: upgrade carbon-components to version 10.21

Fixes

  • Link: explicitly define href prop to fix TypeScript errors (PR #301)
  • RadioButtonGroup: explicitly define id prop to fix TypeScript errors (PR #303)
  • ComboBox: light prop should use the light variant (PR #303)
  • ComposedModal: class "bx--body--with-modal-open" should be removed when closing the modal (PR #306)
  • Dropdown: remove unused setContext import (PR #308)
  • css/all.css: default theme should be "white," not "g10" (PR #322)
  • UI Shell: HeaderAction menu should close when clicking in the window, not just the document body (PR #323)

Performance

  • DatePicker: remove default i10n locales import to reduce bundle size by ~42 kB (PR #316)

Breaking Changes

  • DatePicker: default i10n locales are no longer imported
  • if using css/all.css, set the "theme" attribute on the HTML element to "g10" in order to use the Gray 10 theme

Documentation

Housekeeping

  • Git hooks: only lint staged files in the pre-commit Git hook (PR #319)

0.15.0 - 2020-10-01

Features

  • DataTableSkeleton: add size prop to support "compact", "small", "tall" row heights (PR #279, thanks @albertms10)

  • HeaderPanelLink: forward click event (PR #286, thanks @weaseldotro)

  • FluidForm: add FluidForm component and support fluid variants for TextInput, PasswordInput (PR #293, thanks @josefaidt)

  • UI Shell: add ref prop to interactive (i.e., anchor links, buttons) UI Shell elements (PR #297, thanks @josefaidt)

Fixes

  • Slider: attach mousemove/touch events to document body, not slider input (issue #288)

  • Slider: value prop type should be a number, not a string (issue #289)

  • Slider: input value should not update if disabled is true

  • Slider: change event should only be dispatched if the value changes

  • UI Shell: correctly bind ref prop in HeaderGlobalAction (PR #297, thanks @josefaidt)

  • export DatePickerSkeleton, FileUploaderSkeleton components

Breaking Changes

  • DataTableSkeleton: compact prop is removed in favor of size="compact"

Dependencies

  • upgrade carbon-icons-svelte to version ^10.17.0

Housekeeping

  • prettier: enable svelteBracketNewLine for improved readability (PR #281, thanks @josefaidt)

  • git: add husky, lint-staged to development workflow (PR #295, thanks @josefaidt)

0.14.0 - 2020-09-23

Features

Fixes

  • DataTableSkeleton: add showHeader, showToolbar props
  • OverflowMenu: focus menu button on escape key only
  • DataTable: fix headers JSDoc type annotation (PR #271, thanks @albertms10)

Breaking Changes

  • DataTableSkeleton: showHeader and showToolbar are true by default

0.13.0 - 2020-09-18

Features

  • Move helper text below form inputs in ComboBox, Dropdown, MultiSelect, TextArea, NumberInput, TextInput, Select (PR #256, issue #255)

  • ProgressIndicator: add spaceEqual prop and functionality (PR #263, issue #262)

Fixes

  • Link: remove visited styles by default (PR #259, issue #258)

  • TimePickerSelect: deprecate hideLabel prop to match spec and set default value to true (PR #261, issue #260)

Breaking Changes

  • TimePickerSelect: hideLabel prop is true by default

0.12.3 - 2020-09-16

Fixes

0.12.2 - 2020-09-14

Fixes

  • Dropdown: allow event propagation when clicking the chevron icon (73861e2)

0.12.1 - 2020-09-14

Fixes

  • Pagination: ensure page, pageSize values are numbers (0138910)
  • Pagination: dispatch "update" event only when pageSize or page values update (458d1b5)
  • Pagination: use correct size carbon icons for buttons (size 16 instead of 24) (192f98d)
  • ProgressStep: use button element; set negative tabindex if disabled is true (3202f39)
  • ProgressStep: forward click event (6cb877e)
  • SideNavMenu, SideNavMenuItem: remove "role", "aria-haspopup" attributes causing a11y warnings
  • RadioTile: move keydown, tabindex to input element (17d97d1)

0.12.0 - 2020-09-13

Features

  • css: ship pre-compiled CSS StyleSheets for each Carbon theme (70e0875)

Documentation

  • examples: add example set-ups using popular bundlers/frameworks
  • update README guidance on consuming the library

0.11.0 - 2020-09-05

Features

  • UI Shell: add HeaderGlobalAction component (7b3c111)

0.10.0 - 2020-09-05

Features

  • UI Shell: add Close/AppSwitcher as default icons for HeaderAction component (5f62cde)
  • ButtonSet: add stacked prop (c8e0a59)
  • Link: set rel attribute to "noopener noreferrer" if target is "_blank" (4b7d254)

Fixes

  • TextInput: add missing required prop to input (PR #237), thanks @kamil-murtaza)
  • StructuredList: change element semantics from section to div to avoid accessibility error (117dbcf)
  • MultiSelect: add light variant to text input (6a955b1)
  • NumberInput: disable label, helper text if disabled is set to true (37c7f07)
  • Pagination: use singular page range text if total is 1 (3d64fb2)

Housekeeping

  • add .prettierrc and enable svelteStrictMode (42b8159)
  • remove documentation of non-existent small Button prop (41a533d)
  • upgrade TypeScript to version >=4 (e7e67f3)
  • bump prettier, prettier-plugin-svelte (322b238)
  • bump rollup, rollup plugins (00b9068)
  • require node >=12 for development/CI (bf0f11a)

0.9.7 - 2020-08-23

  • Fix InlineNotification and ToastNotification timeout (PR#235, thanks @Overbryd)

0.9.6 - 2020-08-15

  • use svelte compiler to generate TypeScript definitions, documentation (issue #227, PR #228)
  • fix DatePicker to use default imports (reverts 6d5f1e5; issue #232)

0.9.5 - 2020-08-12

  • fix Modal and ComposedModal to prevent modal from closing unexpectedly (PR #231)

0.9.4 - 2020-08-08

  • ignore false positive a11y-label-has-associated-control warnings added in svelte^v3.24.1
  • fix DatePicker: use wildcard import to resolve flatpickr "no default" error when using ESM
  • allow CodeSnippet button to be optional by using the hideCopyButton prop
  • refactor CodeSnippet: replace afterUpdate with reactive statement
  • fix CodeSnippet: forward feedback, feedbackTimeout props to Copy component

0.9.3 - 2020-08-02

  • rename UI Shell Header slot from "skip-to-main-content" to "skip-to-content"
  • support fixed SideNav
  • add expandedByDefault prop to Header to prevent SideNav from being expanded

0.9.2 - 2020-08-01

  • add "skip-to-main-content" slot to Header
  • make platformName prop in UI Shell Header slottable (i.e., ...)
  • make company prop Header optional
  • fix UI Shell Header to add space between company and platform name for ARIA label
  • fix UI Shell HeaderAction bug where panel would not open
  • add ButtonSet component
  • fix Accordion to avoid $$restProps.class override

0.9.1 - 2020-07-30

  • fix TabContent to remove hidden prop when panel is selected

0.9.0 - 2020-07-30

  • add TypeScript definitions
  • dispatch "select" and "clear" events in ComboBox
  • forward keydown event to TextInput, PasswordInput components
  • add count prop to TabsSkeleton
  • apply toggle behavior to HeaderAction button; dispatch "open" and "close" events
  • fix forwarded click event in CodeSnippet
  • fix class name typo in UnorderedList

0.8.5 - 2020-07-23

  • add noGutter, noGutterLeft, noGutterRight props to Grid, Row, Column
  • add aspectRatio prop to Column

0.8.4 - 2020-07-22

  • add Grid components (Grid, Row, Column)
  • add PaginationNav component
  • fix TooltipIcon to avoid $$restProps.class override

0.8.3 - 2020-07-20

  • bump carbon-icons-svelte dependency to version >=10.14.0
  • support size prop (undefined or "sm" or "lg) in DatePickerInput, NumberInput, Select, PasswordInput, TextInput components
  • support light variant for ContentSwitcher
  • focus ComboBox after clearing the selection
  • fix ListBox regression where size class can be overriden by $$restProps.class
  • fix Pagination regression where current page selection value is stuck at 1

0.8.2 - 2020-07-19

  • fix ComboBox to close dropdown menu when pressing the "Escape" key (Issue #198)

0.8.1 - 2020-07-19

  • fix bug in Tag to prevent custom class from overriding tag class
  • fix SSR rendering issue in Modal by replacing onDestroy with onMount (Issue #200)

0.8.0 - 2020-07-19

  • use $$restProps API (requires Svelte version >=3.20)
  • upgrade carbon-icons-svelte to version >=10.13.0
  • use svelte class:{value} API instead of cx
  • add ref prop to "interactive" components like text inputs, anchor links... (Issue #196)
  • add slot to Content Switcher Switch component (Issue #183)
  • fix ContentSwitcher bug where bound selectedIndex could not be updated
  • remove unused lib utilities (cx, css, fillArray)
  • refactor component exports and folder structure
  • create Sapper app for e2e testing and alternative development environment in docs/
  • update Travis CI config to build library, build storybook, and run e2e tests in docs/
  • remove Jest in favor of integration/e2e testing with Cypress
  • update contributing guidelines

0.7.6 - 2020-07-19

  • Add named slot to UI Shell HeaderAction component for text (PR#201, thanks @danielboven)

0.7.5 - 2020-07-17

  • Add name prop to form-related components (PR#199, thanks @softartisan)

  • Add Content, SkipToContent components to the UI Shell

  • Forward on:click event to UI Shell Header component

0.7.4 - 2020-06-17

  • Fix OverflowMenu focus behavior to set didOpen only if open is true (PR#193)

0.7.3 - 2020-06-16

  • Fix OverflowMenu to focus button only after closing the menu (PR#192)

0.7.2 - 2020-06-04

  • Add sort direction to dispatched "click:header" event for a sortable DataTable (PR#188, thanks @mabentley85!)

0.7.1 - 2020-06-03

  • Add missing RadioTile export

0.7.0 - 2020-05-29

  • Dispatch "update" event in Pagination for pageSize, page variables (PR#185, thanks @mabentley85!)

  • Drop carbon-components as a peer dependency

0.6.3 - 2020-05-26

  • Replace "javascript:void(0)" with "/" in HeaderNavMenu href attribute to fix a11y "not a valid attribute" warning; href is an exported property that can be overriden by the consumer (Issue #184)

  • Ignore a11y-no-onchange warning in TimePickerSelect

  • Bump development dependency svelte to v3.23.0

0.6.2 - 2020-05-09

  • Fix tileMaxHeight bug in ExpandableTile by setting the value only if the default value is 0 (Issue #180)

0.6.1 - 2020-05-08

  • Fix Pagination bug by binding the correct variable (selected) to the Select component (PR#179, thanks @ericol!)

0.6.0 - 2020-05-07

  • Fix button with icon bug by manually setting hasIconOnly in Button. This results in a breaking change for icon-only buttons, which now must include hasIconOnly (Issue #174)

0.5.1 - 2020-05-03

  • Fix focus/dispatch bug in Modal, ComposedModal (PR#173, thanks @mfeitoza!)

0.5.0 - 2020-04-29

  • Ship DataTable that supports sorting

  • Pin dependencies, remove commitlint, husky, eslint, prettier

0.4.2 - 2020-04-20

0.4.1 - 2020-04-18

  • Refactor UI Shell components to be modular (header, left panel, right panel) (PR#168, thanks @mfeitoza!)

0.4.0 - 2020-04-18

0.3.3 - 2020-03-09

  • Fix "window is undefined" error when using UIShell with server-side rendering (SSR) (PR#149, thanks @pbxothi!)

0.3.2 - 2020-02-12

  • Fix SkeletonText duplicate style attribute to work with svelte^3.18.2 (#134)

0.3.1 - 2020-02-03

  • Fix DatePicker locale initialization bug

  • Fix CheckboxSkeleton styles; bump carbon-components version to ^10.9.3

0.3.0 - 2020-02-03

  • Add UIShell component (thanks @Heydan83!) (#10)

  • Add single component skeleton states for Accordion, CodeSnippet

  • Fix Select, SelectItem to support two-way binding, programmatic prop setting

  • Fix Tab to set selected prop to currentIndex after updating

0.2.1 - 2020-01-08

  • Check if l10n.en is defined in DatePicker component to resolve Svelte REPL compilation

0.2.0 - 2020-01-08

  • Include src in files published to npm to resolve Svelte module entry (#102)

  • Support most Carbon components (See the GitHub project)

0.1.0 - 2019-12-15

  • Initial release