@synergy-design-system/components 1.0.0-main.11 → 1.0.0-main.13

package/dist/internal/test.d.ts

@@ -0,0 +1,28 @@
+/** A testing utility that measures an element's position and clicks on it. */
+export declare function clickOnElement(
+/** The element to click */
+el: Element, 
+/** The location of the element to click */
+position?: 'top' | 'right' | 'bottom' | 'left' | 'center', 
+/** The horizontal offset to apply to the position when clicking */
+offsetX?: number, 
+/** The vertical offset to apply to the position when clicking */
+offsetY?: number): Promise<void>;
+/** A testing utility that moves the mouse onto an element. */
+export declare function moveMouseOnElement(
+/** The element to click */
+el: Element, 
+/** The location of the element to click */
+position?: 'top' | 'right' | 'bottom' | 'left' | 'center', 
+/** The horizontal offset to apply to the position when clicking */
+offsetX?: number, 
+/** The vertical offset to apply to the position when clicking */
+offsetY?: number): Promise<void>;
+/** A testing utility that drags an element with the mouse. */
+export declare function dragElement(
+/** The element to drag */
+el: Element, 
+/** The horizontal distance to drag in pixels */
+deltaX?: number, 
+/** The vertical distance to drag in pixels */
+deltaY?: number): Promise<void>;

package/dist/synergy.d.ts

@@ -1,4 +1,7 @@
-export { default as SynInput } from './components/input/input.js';
 export { default as SynButton } from './components/button/button.js';
+export { default as SynCheckbox } from './components/checkbox/checkbox.js';
+export { default as SynIcon } from './components/icon/icon.js';
+export { default as SynInput } from './components/input/input.js';
+export { default as SynTextarea } from './components/textarea/textarea.js';
 export * from './utilities/form.js';
 export * from './events/events.js';

package/dist/synergy.js

@@ -1,37 +1,58 @@
 import {
-  input_default
-} from "./chunks/chunk.3XRGNU3R.js";
+  textarea_default
+} from "./chunks/chunk.T5JJNDG6.js";
 import {
   getFormControls,
   serialize
 } from "./chunks/chunk.WTCUSH7V.js";
-import "./chunks/chunk.EFGGZW6Y.js";
-import "./chunks/chunk.Y7DVVKVJ.js";
+import {
+  input_default
+} from "./chunks/chunk.FKB4BI2F.js";
+import "./chunks/chunk.SQTGI355.js";
+import "./chunks/chunk.WANL6A7U.js";
 import "./chunks/chunk.W46CFM2R.js";
+import "./chunks/chunk.FLF2E2W4.js";
+import "./chunks/chunk.J44T4LO6.js";
+import "./chunks/chunk.VNC7HKGP.js";
+import "./chunks/chunk.YBIBWRKC.js";
+import {
+  checkbox_default
+} from "./chunks/chunk.MMNWMRST.js";
+import {
+  icon_default
+} from "./chunks/chunk.NXKZDAMQ.js";
 import {
   button_default
-} from "./chunks/chunk.4OMRXGQ5.js";
-import "./chunks/chunk.HLUOHJUC.js";
-import "./chunks/chunk.C4FLGZ7E.js";
-import "./chunks/chunk.N2I6HVX3.js";
-import "./chunks/chunk.XGXFE6IF.js";
+} from "./chunks/chunk.TKXG7VM3.js";
+import "./chunks/chunk.7QGGFKPO.js";
+import "./chunks/chunk.KALIQJUH.js";
 import "./chunks/chunk.R6VNLE6N.js";
 import "./chunks/chunk.A3SKDWCT.js";
+import "./chunks/chunk.N2I6HVX3.js";
+import "./chunks/chunk.XGXFE6IF.js";
+import "./chunks/chunk.YTS5TRJZ.js";
+import "./chunks/chunk.FVSP4LXX.js";
+import "./chunks/chunk.HOGDOKQS.js";
+import "./chunks/chunk.WFAJR3FN.js";
+import "./chunks/chunk.MFFJYORB.js";
 import "./chunks/chunk.WDCAHRYG.js";
-import "./chunks/chunk.2NHBIE4V.js";
-import "./chunks/chunk.IFBY43YE.js";
-import "./chunks/chunk.KXCGB2XT.js";
-import "./chunks/chunk.MRBFJWMS.js";
+import "./chunks/chunk.LJVC6UEV.js";
+import "./chunks/chunk.VZ7S7YYN.js";
+import "./chunks/chunk.UFEBKPYW.js";
+import "./chunks/chunk.BREU4ILT.js";
 import "./chunks/chunk.5OIEI73E.js";
 import "./chunks/chunk.6C4JXZZN.js";
 import "./chunks/chunk.U7ZJ22QM.js";
 import "./chunks/chunk.C7624ITA.js";
-import "./chunks/chunk.BREU4ILT.js";
 import "./chunks/chunk.O7USYXBT.js";
+import "./chunks/chunk.2XZKXVMR.js";
 import "./chunks/chunk.DJOAQ4JU.js";
 export {
   button_default as SynButton,
+  checkbox_default as SynCheckbox,
+  icon_default as SynIcon,
   input_default as SynInput,
+  textarea_default as SynTextarea,
   getFormControls,
   serialize
 };

package/dist/vscode.html-custom-data.json

@@ -163,6 +163,63 @@
         }
       ]
     },
+    {
+      "name": "syn-checkbox",
+      "description": "Checkboxes allow the user to toggle an option on or off.\n---\n\n\n### **Events:**\n - **syn-blur** - Emitted when the checkbox loses focus.\n- **syn-change** - Emitted when the checked state changes.\n- **syn-focus** - Emitted when the checkbox gains focus.\n- **syn-input** - Emitted when the checkbox receives input.\n- **syn-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n\n### **Methods:**\n - **click()** - Simulates a click on the checkbox.\n- **focus(options: _FocusOptions_)** - Sets focus on the checkbox.\n- **blur()** - Removes focus from the checkbox.\n- **checkValidity()** - Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity()** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message: _string_)** - Sets a custom validation message. The value provided will be shown to the user when the form is submitted. To clear\nthe custom validation message, call this method with an empty string.\n\n### **Slots:**\n - _default_ - The checkbox's label.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **control** - The square container that wraps the checkbox's checked state.\n- **control--checked** - Matches the control part when the checkbox is checked.\n- **control--indeterminate** - Matches the control part when the checkbox is indeterminate.\n- **checked-icon** - The checked icon, an `<syn-icon>` element.\n- **indeterminate-icon** - The indeterminate icon, an `<syn-icon>` element.\n- **label** - The container that wraps the checkbox's label.",
+      "attributes": [
+        { "name": "title", "values": [] },
+        {
+          "name": "name",
+          "description": "The name of the checkbox, submitted as a name/value pair with form data.",
+          "values": []
+        },
+        {
+          "name": "value",
+          "description": "The current value of the checkbox, submitted as a name/value pair with form data.",
+          "values": []
+        },
+        {
+          "name": "size",
+          "description": "The checkbox's size.",
+          "values": [
+            { "name": "small" },
+            { "name": "medium" },
+            { "name": "large" }
+          ]
+        },
+        {
+          "name": "disabled",
+          "description": "Disables the checkbox.",
+          "values": []
+        },
+        {
+          "name": "checked",
+          "description": "Draws the checkbox in a checked state.",
+          "values": []
+        },
+        {
+          "name": "indeterminate",
+          "description": "Draws the checkbox in an indeterminate state. This is usually applied to checkboxes that represents a \"select\nall/none\" behavior when associated checkboxes have a mix of checked and unchecked states.",
+          "values": []
+        },
+        {
+          "name": "form",
+          "description": "By default, form controls are associated with the nearest containing `<form>` element. This attribute allows you\nto place the form control outside of a form and associate it with the form that has this `id`. The form must be in\nthe same document or shadow root for this to work.",
+          "values": []
+        },
+        {
+          "name": "required",
+          "description": "Makes the checkbox a required field.",
+          "values": []
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://synergy.style/components/checkbox"
+        }
+      ]
+    },
     {
       "name": "syn-input",
       "description": "Inputs collect data from the user.\n---\n\n\n### **Events:**\n - **syn-blur** - Emitted when the control loses focus.\n- **syn-change** - Emitted when an alteration to the control's value is committed by the user.\n- **syn-clear** - Emitted when the clear button is activated.\n- **syn-focus** - Emitted when the control gains focus.\n- **syn-input** - Emitted when the control receives input.\n- **syn-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n\n### **Methods:**\n - **focus(options: _FocusOptions_)** - Sets focus on the input.\n- **blur()** - Removes focus from the input.\n- **select()** - Selects all the text in the input.\n- **setSelectionRange(selectionStart: _number_, selectionEnd: _number_, selectionDirection: _'forward' | 'backward' | 'none'_)** - Sets the start and end positions of the text selection (0-based).\n- **setRangeText(replacement: _string_, start: _number_, end: _number_, selectMode: _'select' | 'start' | 'end' | 'preserve'_)** - Replaces a range of text with a new string.\n- **showPicker()** - Displays the browser picker for an input element (only works if the browser supports it for the input type).\n- **stepUp()** - Increments the value of a numeric input type by the value of the step attribute.\n- **stepDown()** - Decrements the value of a numeric input type by the value of the step attribute.\n- **checkValidity()** - Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity()** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message: _string_)** - Sets a custom validation message. Pass an empty string to restore validity.\n\n### **Slots:**\n - **label** - The input's label. Alternatively, you can use the `label` attribute.\n- **prefix** - Used to prepend a presentational icon or similar element to the input.\n- **suffix** - Used to append a presentational icon or similar element to the input.\n- **clear-icon** - An icon to use in lieu of the default clear icon.\n- **show-password-icon** - An icon to use in lieu of the default show password icon.\n- **hide-password-icon** - An icon to use in lieu of the default hide password icon.\n- **help-text** - Text that describes how to use the input. Alternatively, you can use the `help-text` attribute.\n\n### **CSS Parts:**\n - **form-control** - The form control that wraps the label, input, and help text.\n- **form-control-label** - The label's wrapper.\n- **form-control-input** - The input's wrapper.\n- **form-control-help-text** - The help text's wrapper.\n- **base** - The component's base wrapper.\n- **input** - The internal `<input>` control.\n- **prefix** - The container that wraps the prefix.\n- **clear-button** - The clear button.\n- **password-toggle-button** - The password toggle button.\n- **suffix** - The container that wraps the suffix.",
@@ -366,6 +423,156 @@
           "url": "https://synergy.style/components/spinner"
         }
       ]
+    },
+    {
+      "name": "syn-textarea",
+      "description": "Textareas collect data from the user and allow multiple lines of text.\n---\n\n\n### **Events:**\n - **syn-blur** - Emitted when the control loses focus.\n- **syn-change** - Emitted when an alteration to the control's value is committed by the user.\n- **syn-focus** - Emitted when the control gains focus.\n- **syn-input** - Emitted when the control receives input.\n- **syn-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n\n### **Methods:**\n - **focus(options: _FocusOptions_)** - Sets focus on the textarea.\n- **blur()** - Removes focus from the textarea.\n- **select()** - Selects all the text in the textarea.\n- **scrollPosition(position: _{ top?: number; left?: number }_): _{ top: number; left: number } | undefined_** - Gets or sets the textarea's scroll position.\n- **setSelectionRange(selectionStart: _number_, selectionEnd: _number_, selectionDirection: _'forward' | 'backward' | 'none'_)** - Sets the start and end positions of the text selection (0-based).\n- **setRangeText(replacement: _string_, start: _number_, end: _number_, selectMode: _'select' | 'start' | 'end' | 'preserve'_)** - Replaces a range of text with a new string.\n- **checkValidity()** - Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity()** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message: _string_)** - Sets a custom validation message. Pass an empty string to restore validity.\n\n### **Slots:**\n - **label** - The textarea's label. Alternatively, you can use the `label` attribute.\n- **help-text** - Text that describes how to use the input. Alternatively, you can use the `help-text` attribute.\n\n### **CSS Parts:**\n - **form-control** - The form control that wraps the label, input, and help text.\n- **form-control-label** - The label's wrapper.\n- **form-control-input** - The input's wrapper.\n- **form-control-help-text** - The help text's wrapper.\n- **base** - The component's base wrapper.\n- **textarea** - The internal `<textarea>` control.",
+      "attributes": [
+        { "name": "title", "values": [] },
+        {
+          "name": "name",
+          "description": "The name of the textarea, submitted as a name/value pair with form data.",
+          "values": []
+        },
+        {
+          "name": "value",
+          "description": "The current value of the textarea, submitted as a name/value pair with form data.",
+          "values": []
+        },
+        {
+          "name": "size",
+          "description": "The textarea's size.",
+          "values": [
+            { "name": "small" },
+            { "name": "medium" },
+            { "name": "large" }
+          ]
+        },
+        {
+          "name": "label",
+          "description": "The textarea's label. If you need to display HTML, use the `label` slot instead.",
+          "values": []
+        },
+        {
+          "name": "help-text",
+          "description": "The textarea's help text. If you need to display HTML, use the `help-text` slot instead.",
+          "values": []
+        },
+        {
+          "name": "placeholder",
+          "description": "Placeholder text to show as a hint when the input is empty.",
+          "values": []
+        },
+        {
+          "name": "rows",
+          "description": "The number of rows to display by default.",
+          "values": []
+        },
+        {
+          "name": "resize",
+          "description": "Controls how the textarea can be resized.",
+          "values": [
+            { "name": "none" },
+            { "name": "vertical" },
+            { "name": "auto" }
+          ]
+        },
+        {
+          "name": "disabled",
+          "description": "Disables the textarea.",
+          "values": []
+        },
+        {
+          "name": "readonly",
+          "description": "Makes the textarea readonly.",
+          "values": []
+        },
+        {
+          "name": "form",
+          "description": "By default, form controls are associated with the nearest containing `<form>` element. This attribute allows you\nto place the form control outside of a form and associate it with the form that has this `id`. The form must be in\nthe same document or shadow root for this to work.",
+          "values": []
+        },
+        {
+          "name": "required",
+          "description": "Makes the textarea a required field.",
+          "values": []
+        },
+        {
+          "name": "minlength",
+          "description": "The minimum length of input that will be considered valid.",
+          "values": []
+        },
+        {
+          "name": "maxlength",
+          "description": "The maximum length of input that will be considered valid.",
+          "values": []
+        },
+        {
+          "name": "autocapitalize",
+          "description": "Controls whether and how text input is automatically capitalized as it is entered by the user.",
+          "values": [
+            { "name": "off" },
+            { "name": "none" },
+            { "name": "on" },
+            { "name": "sentences" },
+            { "name": "words" },
+            { "name": "characters" }
+          ]
+        },
+        {
+          "name": "autocorrect",
+          "description": "Indicates whether the browser's autocorrect feature is on or off.",
+          "values": []
+        },
+        {
+          "name": "autocomplete",
+          "description": "Specifies what permission the browser has to provide assistance in filling out form field values. Refer to\n[this page on MDN](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/autocomplete) for available values.",
+          "values": []
+        },
+        {
+          "name": "autofocus",
+          "description": "Indicates that the input should receive focus on page load.",
+          "values": []
+        },
+        {
+          "name": "enterkeyhint",
+          "description": "Used to customize the label or icon of the Enter key on virtual keyboards.",
+          "values": [
+            { "name": "enter" },
+            { "name": "done" },
+            { "name": "go" },
+            { "name": "next" },
+            { "name": "previous" },
+            { "name": "search" },
+            { "name": "send" }
+          ]
+        },
+        {
+          "name": "spellcheck",
+          "description": "Enables spell checking on the textarea.",
+          "values": []
+        },
+        {
+          "name": "inputmode",
+          "description": "Tells the browser what type of data will be entered by the user, allowing it to display the appropriate virtual\nkeyboard on supportive devices.",
+          "values": [
+            { "name": "none" },
+            { "name": "text" },
+            { "name": "decimal" },
+            { "name": "numeric" },
+            { "name": "tel" },
+            { "name": "search" },
+            { "name": "email" },
+            { "name": "url" }
+          ]
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://synergy.style/components/textarea"
+        }
+      ]
     }
   ]
 }