@ongov/ontario-design-system-component-library 4.3.1-alpha.1 → 5.0.0-alpha.10

package/src/components/ontario-search-box/readme.md

@@ -0,0 +1,132 @@
+import { OntarioSearchBox } from '@ongov/ontario-design-system-component-library-react';
+
+# ontario-search-box
+
+Use a search box to let users complete keyword-based searches.
+
+## User guidance
+
+Please refer to the [Ontario Design System](https://designsystem.ontario.ca/components/detail/search-box.html) for current documentation guidance.
+
+## Configuration
+
+Once the component package has been installed (see Ontario Design System Component Library for installation instructions), the search box component can be added directly into the project's code, and can be customized by updating the properties outlined [here](#properties). Additional information on custom types for header properties are outlined [here](#custom-property-types). Please see the [examples](#examples) below for how to configure the component.
+
+## Example
+
+### Search box with caption
+
+```html
+<ontario-search-box id="ontario-search-box" caption="Search the directory"></ontario-search-box>
+```
+
+<div>
+    <OntarioSearchBox id="ontario-search-box" caption="Search the directory"></OntarioSearchBox>
+</div>
+
+### Handling searching
+
+The `<ontario-search-box>` provides two ways to handle searching.
+
+#### The `performSearch()` function
+
+The `performSearch()` function allows for custom logic to be executed when the search box is submitted for searching. When the search box calls this function internally it will pass to it a string that is the value of the search field. This function is [asynchronous](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/async_function) and should return a [`Promise<void>`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise).
+
+##### Example
+
+The following example registers a simple function on `window` `load` that assigns a custom function to the search box's `performSearch()` function to handle the application specific search logic.
+
+```html
+<script>
+	window.addEventListener('load', () => {
+		console.log('Loaded Search Box Event Listener');
+
+		const searchBox = document.getElementById('ontario-search-box');
+		searchBox.performSearch = async (value) => {
+			console.log('Performing search with value:', value);
+		};
+	});
+</script>
+```
+
+#### Using the `searchOnSubmit` function
+
+As an alternative to using a custom `performSearch()` function the search box also emits an event, `searchOnSubmit` that can be listened to to trigger any custom search logic that is needed. This allows for applications to listen for a search being performed and act accordingly. The value of the search box will be passed via the [`CustomEvent` `detail`](https://developer.mozilla.org/en-US/docs/Web/API/CustomEvent/CustomEvent#detail) property.
+
+##### Example
+
+The following example registers a simple function on `window` `load` that adds an event listener to the search box listening for the `searchOnSubmit` event and outputs the value of the `detail` property.
+
+```html
+<script>
+	window.addEventListener('load', () => {
+		console.log('Loaded Search Box Event Listener');
+
+		const searchBox = document.getElementById('ontario-search-box');
+		searchBox.addEventListener('searchOnSubmit', (event) => {
+			console.log('Search Event Detail:', event.detail);
+		});
+	});
+</script>
+```
+
+## Custom property types
+
+### caption
+
+The `caption` property is used to render the label for the ontario-input. It can be passed either a string or an object. If no `captionType` needs to be specified, it can be passed as a string.
+
+```html
+caption='{ "captionText": "Input label", "captionType": "large" }'
+```
+
+| Property name | Type                               | Description                                                                                                                                      |
+| ------------- | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `captionText` | `string`                           | Text to display as the input question                                                                                                            |
+| `captionType` | `"default" \| "large"\| "heading"` | The type of label to display for the input question. This is optional, and if no information is provided, it will default to the `default` type. |
+
+<!-- Auto Generated Below -->
+
+## Properties
+
+| Property         | Attribute    | Description                                                                                                                                                                                                                                                                                                                                                                            | Type                                                            | Default     |
+| ---------------- | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------- | ----------- |
+| `caption`        | `caption`    | The text to display as the input label                                                                                                                                                                                                                                                                                                                                                 | `Caption \| string`                                             | `undefined` |
+| `customOnBlur`   | --           | Used to add a custom function to the input onBlur event.                                                                                                                                                                                                                                                                                                                               | `((event: Event) => void) \| undefined`                         | `undefined` |
+| `customOnChange` | --           | Used to add a custom function to the input onChange event.                                                                                                                                                                                                                                                                                                                             | `((event: Event) => void) \| undefined`                         | `undefined` |
+| `customOnFocus`  | --           | Used to add a custom function to the input onFocus event.                                                                                                                                                                                                                                                                                                                              | `((event: Event) => void) \| undefined`                         | `undefined` |
+| `customOnInput`  | --           | Used to add a custom function to the input onInput event.                                                                                                                                                                                                                                                                                                                              | `((event: Event) => void) \| undefined`                         | `undefined` |
+| `elementId`      | `element-id` | The unique identifier of the search-box component. This is optional - if no ID is passed, one will be generated.                                                                                                                                                                                                                                                                       | `string \| undefined`                                           | `undefined` |
+| `hintText`       | `hint-text`  | Used to include the ontario-hint-text component for the search-box. This is optional.                                                                                                                                                                                                                                                                                                  | `Hint \| string \| undefined`                                   | `undefined` |
+| `language`       | `language`   | The language of the component. This is used for translations. If none is passed, it will default to English.                                                                                                                                                                                                                                                                           | `"en" \| "fr" \| undefined`                                     | `'en'`      |
+| `performSearch`  | --           | This Function to perform a search operation. This function will be called when the search submit button is triggered. The value argument is used for as search term to use for the search operation. This parameter is optional. The performSearch prop can be set dynamically using JavaScript, allowing you to define custom search functionality when the search form is submitted. | `((value?: string \| undefined) => Promise<void>) \| undefined` | `undefined` |
+| `required`       | `required`   | This is used to determine whether the dropdown list is required or not. This prop gets passed to the InputCaption utility to display either an optional or required flag in the label. If no prop is set, it will default to false (optional).                                                                                                                                         | `boolean \| undefined`                                          | `false`     |
+| `value`          | `value`      | The value of the search term. This is optional.                                                                                                                                                                                                                                                                                                                                        | `string \| undefined`                                           | `undefined` |
+
+## Events
+
+| Event            | Description                                                                                                       | Type                                                                        |
+| ---------------- | ----------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------- |
+| `inputOnBlur`    | Emitted when a keyboard input event occurs when an input has lost focus.                                          | `CustomEvent<InputInteractionEvent & { focused: boolean; }>`                |
+| `inputOnChange`  | Emitted when a keyboard input or mouse event occurs when an input has been changed.                               | `CustomEvent<{ id?: string \| undefined; value?: string \| undefined; }>`   |
+| `inputOnFocus`   | Emitted when a keyboard input event occurs when an input has gained focus.                                        | `CustomEvent<InputInteractionEvent & { focused: boolean; }>`                |
+| `inputOnInput`   | Emitted when a input  occurs when an input has been changed.                                                      | `CustomEvent<InputInteractionEvent & { inputType?: string \| undefined; }>` |
+| `searchOnSubmit` | Emitted when the search is submitted. Below is an example on how to hook into the event to get the event details. | `CustomEvent<string>`                                                       |
+
+## Dependencies
+
+### Depends on
+
+- [ontario-hint-text](../ontario-hint-text)
+
+### Graph
+
+```mermaid
+graph TD;
+  ontario-search-box --> ontario-hint-text
+  style ontario-search-box fill:#f9f,stroke:#333,stroke-width:4px
+```
+
+---
+
+_Built with [StencilJS](https://stenciljs.com/)_

package/src/components/ontario-search-box/test/__snapshots__/ontario-search-box.spec.tsx.snap

@@ -0,0 +1,35 @@
+// Jest Snapshot v1, https://goo.gl/fbAQLP
+
+exports[`ontario-search-box should render a default search box element 1`] = `
+<ontario-search-box>
+  <template shadowrootmode="open">
+    <form class="ontario-columns ontario-large-6 ontario-large-offset-0 ontario-medium-6 ontario-medium-offset-3 ontario-search__container ontario-small-10" id="ontario-search-form-container" name="searchForm" novalidate="">
+      <label class="ontario-label" htmlfor="ontario-search-input-field"></label>
+      <div class="ontario-search__input-container">
+        <input aria-autocomplete="none" autocomplete="off" class="ontario-input ontario-search__input" id="ontario-search-input-field" name="search" required="" type="search" value="">
+        <input class="ontario-search__reset" id="ontario-search-reset" type="reset" value="">
+        <button class="ontario-search__submit" id="ontario-search-box__submit" type="submit">
+          <span></span>
+        </button>
+      </div>
+    </form>
+  </template>
+</ontario-search-box>
+`;
+
+exports[`ontario-search-box should render the expected html 1`] = `
+<ontario-search-box class="hydrated" id="ontario-search-box">
+  <template shadowrootmode="open">
+    <form class="ontario-columns ontario-large-6 ontario-large-offset-0 ontario-medium-6 ontario-medium-offset-3 ontario-search__container ontario-small-10" id="ontario-search-form-container" name="searchForm" novalidate="">
+      <label class="ontario-label" htmlfor="ontario-search-input-field"></label>
+      <div class="ontario-search__input-container">
+        <input aria-autocomplete="none" autocomplete="off" class="ontario-input ontario-search__input" id="ontario-search-input-field" name="search" required="" type="search" value="">
+        <input class="ontario-search__reset" id="ontario-search-reset" type="reset" value="">
+        <button class="ontario-search__submit" id="ontario-search-box__submit" type="submit">
+          <span></span>
+        </button>
+      </div>
+    </form>
+  </template>
+</ontario-search-box>
+`;

package/src/components/ontario-search-box/test/ontario-search-box.e2e.ts

@@ -0,0 +1,21 @@
+import { newE2EPage } from '@stencil/core/testing';
+
+describe('ontario-search-box', () => {
+	//checks if the component has hydrated class
+	it('renders', async () => {
+		const page = await newE2EPage();
+		await page.setContent(`<ontario-search-box></ontario-search-box>`);
+		const element = await page.find('ontario-search-box');
+		expect(element).toHaveClass('hydrated');
+	});
+
+	it('checks the onclick event', async () => {
+		const page = await newE2EPage();
+		await page.setContent('<ontario-search-box></ontario-search-box>');
+		const changedEvent = await page.spyOnEvent('click');
+		const component = await page.find('ontario-search-box >>> #ontario-search-submit');
+		component.click();
+		await page.waitForChanges();
+		expect(changedEvent).toHaveReceivedEventTimes(1);
+	});
+});

package/src/components/ontario-search-box/test/ontario-search-box.spec.tsx

@@ -0,0 +1,22 @@
+import { newSpecPage } from '@stencil/core/testing';
+import { OntarioSearchBox } from '../ontario-search-box';
+
+describe('ontario-search-box', () => {
+	it('should render the expected html', async () => {
+		const page = await newSpecPage({
+			components: [OntarioSearchBox],
+			html: `<ontario-search-box id="ontario-search-box" class="hydrated"></ontario-search-box>`,
+		});
+
+		expect(page.root).toMatchSnapshot();
+	});
+
+	it('should render a default search box element', async () => {
+		const page = await newSpecPage({
+			components: [OntarioSearchBox],
+			html: `<ontario-search-box></ontario-search-box>`,
+		});
+
+		expect(page.root).toMatchSnapshot();
+	});
+});

package/src/components/ontario-table/ontario-table.scss

@@ -5,7 +5,7 @@
 @use '@ongov/ontario-design-system-global-styles/dist/styles/scss/1-variables/font-sizes.variables' as fontSizes;
 @use '@ongov/ontario-design-system-global-styles/dist/styles/scss/1-variables/font-weights.variables' as fontWeights;
 @use '@ongov/ontario-design-system-global-styles/dist/styles/scss/1-variables/line-heights.variables' as lineHeights;
-@use '@ongov/ontario-design-system-global-styles/dist/styles/scss/1-variables/typography.variables' as typography;
+@use '@ongov/ontario-design-system-global-styles/dist/styles/scss/1-variables/fonts.variables' as fonts;
 @use '@ongov/ontario-design-system-global-styles/dist/styles/scss/2-tools/functions/global.functions' as globalFunctions;
 
 $ontario-table-caption-background: #0000001a;
@@ -28,14 +28,22 @@ $ontario-table-caption-custom-spacing: spacing.$spacing-4 + math.div(spacing.$sp
 }
 
 .ontario-table-div {
-	background: linear-gradient(to right, colours.$ontario-colour-white 30%, $ontario-table-shadow--cover),
+	background:
+		linear-gradient(to right, colours.$ontario-colour-white 30%, $ontario-table-shadow--cover),
 		linear-gradient(to right, $ontario-table-shadow--cover, colours.$ontario-colour-white 70%) 0 100%,
 		linear-gradient(to right, $ontario-table-shadow--black 0%, $ontario-table-shadow--clear 100.01%),
 		linear-gradient(to left, $ontario-table-shadow--black 0%, $ontario-table-shadow--clear 100.01%);
 	background-repeat: no-repeat;
-	background-size: globalFunctions.px-to-rem(40) 100%, globalFunctions.px-to-rem(40) 100%,
-		globalFunctions.px-to-rem(14) 100%, globalFunctions.px-to-rem(14) 100%;
-	background-position: 0 0, 100%, 0 0, 100%;
+	background-size:
+		globalFunctions.px-to-rem(40) 100%,
+		globalFunctions.px-to-rem(40) 100%,
+		globalFunctions.px-to-rem(14) 100%,
+		globalFunctions.px-to-rem(14) 100%;
+	background-position:
+		0 0,
+		100%,
+		0 0,
+		100%;
 	background-attachment: local, local, scroll, scroll;
 	overflow-x: auto;
 
@@ -208,13 +216,13 @@ $ontario-table-caption-custom-spacing: spacing.$spacing-4 + math.div(spacing.$sp
 	}
 
 	&.ontario-table-cell--numeric {
-		font-family: typography.$ontario-font-courier-prime;
+		font-family: fonts.$ontario-font-courier-prime;
 		font-size: globalFunctions.px-to-rem(17);
 		padding: globalFunctions.px-to-rem(19) spacing.$spacing-5 globalFunctions.px-to-rem(19) spacing.$spacing-4;
 		text-align: right;
 
 		strong {
-			font-family: typography.$ontario-font-courier-prime;
+			font-family: fonts.$ontario-font-courier-prime;
 		}
 	}
 }

package/src/components/ontario-table/ontario-table.tsx

@@ -159,8 +159,8 @@ export class OntarioTable implements Table {
 		return this.zebraStripes === 'disabled'
 			? `ontario-table--no-zebra-stripes`
 			: this.zebraStripes === 'enabled'
-			? `ontario-table--zebra-stripes-enabled`
-			: ``;
+				? `ontario-table--zebra-stripes-enabled`
+				: ``;
 	};
 
 	private getTableClasses = () => {
@@ -298,8 +298,8 @@ export class OntarioTable implements Table {
 									const rowClass = rowData.highlight
 										? `ontario-table-row--highlight`
 										: rowData.subtotal
-										? `ontario-table-row--subtotal`
-										: undefined;
+											? `ontario-table-row--subtotal`
+											: undefined;
 
 									return this.generateTableDataHTML('tableData', rowData, columns, rowClass);
 								})}

package/src/components/ontario-table/test/__snapshots__/ontario-table.spec.tsx.snap

@@ -28,7 +28,7 @@ exports[`ontario-table snapshot - 3 columns (non-numeric) should render the expe
 							}
 						}
 					]">
-  <mock:shadow-root>
+  <template shadowrootmode="open">
     <div class="ontario-table-container">
       <div class="ontario-table-scroll--wrapper">
         <div class="ontario-table-scroll--div" style="visibility: visible; height: 20px; width: undefinedpx;"></div>
@@ -89,7 +89,7 @@ exports[`ontario-table snapshot - 3 columns (non-numeric) should render the expe
         </table>
       </div>
     </div>
-  </mock:shadow-root>
+  </template>
 </ontario-table>
 `;
 
@@ -158,7 +158,7 @@ exports[`ontario-table snapshot - 5 columns (numeric) should render the expected
 							&quot;footer&quot;: true
 						}
 					]" zebra-stripes="enabled">
-  <mock:shadow-root>
+  <template shadowrootmode="open">
     <div class="ontario-table-container">
       <div class="ontario-table-scroll--wrapper">
         <div class="ontario-table-scroll--div" style="visibility: visible; height: 20px; width: undefinedpx;"></div>
@@ -297,7 +297,7 @@ exports[`ontario-table snapshot - 5 columns (numeric) should render the expected
         </table>
       </div>
     </div>
-  </mock:shadow-root>
+  </template>
 </ontario-table>
 `;
 
@@ -446,7 +446,7 @@ exports[`ontario-table snapshot - 7 columns (numeric and condensed) should rende
 							&quot;footer&quot;: true
 						}
 					]">
-  <mock:shadow-root>
+  <template shadowrootmode="open">
     <div class="ontario-table-container">
       <div class="ontario-table-scroll--wrapper">
         <div class="ontario-table-scroll--div" style="visibility: visible; height: 20px; width: undefinedpx;"></div>
@@ -764,6 +764,6 @@ exports[`ontario-table snapshot - 7 columns (numeric and condensed) should rende
         </table>
       </div>
     </div>
-  </mock:shadow-root>
+  </template>
 </ontario-table>
 `;

package/src/components/ontario-textarea/ontario-textarea.scss

@@ -1,7 +1,7 @@
 @use '@ongov/ontario-design-system-global-styles/dist/styles/scss/1-variables/global.variables' as globalVariables;
 @use '@ongov/ontario-design-system-global-styles/dist/styles/scss/1-variables/spacing.variables' as spacing;
 @use '@ongov/ontario-design-system-global-styles/dist/styles/scss/1-variables/colours.variables' as colours;
-@use '@ongov/ontario-design-system-global-styles/dist/styles/scss/1-variables/typography.variables' as typography;
+@use '@ongov/ontario-design-system-global-styles/dist/styles/scss/1-variables/fonts.variables' as fonts;
 @use '@ongov/ontario-design-system-global-styles/dist/styles/scss/2-tools/placeholder/focus.placeholders' as
 	focusPlaceholders;
 @use '@ongov/ontario-design-system-global-styles/dist/styles/scss/1-variables/font-sizes.variables' as fontSizes;
@@ -17,7 +17,7 @@ $ontario-textarea-border-width: 0.125rem;
 	box-sizing: border-box;
 	color: colours.$ontario-colour-black;
 	font-size: fontSizes.$ontario-font-size-standard-body-text;
-	font-family: typography.$ontario-font-open-sans;
+	font-family: fonts.$ontario-font-open-sans;
 	line-height: globalVariables.$line-height-default;
 	display: block;
 	max-width: globalVariables.$standard-width;

package/src/components/ontario-textarea/test/__snapshots__/ontario-textarea.spec.tsx.snap

@@ -2,7 +2,7 @@
 
 exports[`ontario-textarea snapshot should render the expected html 1`] = `
 <ontario-textarea caption="{&quot;captionText&quot;: &quot;Ontario Textarea&quot;}" element-id="ontario-textarea" name="ontario-textarea">
-  <mock:shadow-root>
+  <template shadowrootmode="open">
     <div class="ontario-form-group">
       <label class="ontario-label" htmlfor="ontario-textarea">
         Ontario Textarea
@@ -15,6 +15,6 @@ exports[`ontario-textarea snapshot should render the expected html 1`] = `
         <div class="ontario-error-messaging__content"></div>
       </div><textarea class="ontario-textarea" id="ontario-textarea" name="ontario-textarea" value=""></textarea>
     </div>
-  </mock:shadow-root>
+  </template>
 </ontario-textarea>
 `;