@m3e/slider 1.0.0-rc.1

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 matraic
+Contact: matraic@yahoo.com
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,185 @@
+# @m3e/slider
+
+The `m3e-slider` component enables users to select a numeric value from a continuous or discrete range. Designed according to Material 3 principles, it supports labeled value indicators, tick marks, and snapping behavior.
+
+> **Part of the [M3E](../../README.md) monorepo**  
+> This package is maintained within the unified M3E repository, which provides a suite of Material 3 web components.
+
+## 📦 Installation
+
+```bash
+npm install @m3e/slider
+```
+
+## 💻 Editor Integration
+
+This package includes a [Custom Elements Manifest](https://github.com/webcomponents/custom-elements-manifest) to support enhanced editor tooling and developer experience.
+
+### Visual Studio Code
+
+To enable autocomplete and hover documentation for `@m3e/slider`, install the [Custom Elements Manifest Language Server](https://marketplace.visualstudio.com/items?itemName=pwrs.cem-language-server-vscode) extension. It will automatically detect the manifest bundled with this package and surface tag names, attributes, slots, and events in supported files.
+
+Alternately, you can explicitly reference the `html-custom-data.json` and `css-custom-data.json` in your workspace settings:
+
+```json
+{
+  "html.customData": ["./node_modules/@m3e/slider/dist/html-custom-data.json"],
+  "css.customData": ["./node_modules/@m3e/slider/dist/css-custom-data.json"]
+}
+```
+
+## 🚀 Browser Usage
+
+This package uses [JavaScript Modules](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules#module_specifiers). To use it directly in a browser without a bundler, use a module script similar to the following.
+
+```html
+<script type="module" src="/node_modules/@m3e/slider/dist/index.js"></script>
+```
+
+In addition, you must use an [import map](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/script/type/importmap) to include dependencies.
+
+```html
+<script type="importmap">
+  {
+    "imports": {
+      "lit": "https://cdn.jsdelivr.net/npm/lit@3.3.0/+esm",
+      "@m3e/core": "/node_modules/@m3e/core/dist/index.js"
+    }
+  }
+</script>
+```
+
+> For production, use index.min.js for faster load times.
+
+## 🗂️ Elements
+
+- `m3e-slider` — Allows for the selection of numeric values from a range.
+- `m3e-slider-thumb` — A thumb used to select a value in a slider.
+
+## 🧪 Examples
+
+The following example illustrates a labelled slider with thumb used to select a single numeric value.
+
+```html
+<m3e-slider labelled>
+  <m3e-slider-thumb value="50"></m3e-slider-thumb>
+</m3e-slider>
+```
+
+The next example illustrates a labelled range slider with two thumbs used to select a minimum and maximum numeric value.
+
+```html
+<m3e-slider labelled>
+  <m3e-slider-thumb value="25"></m3e-slider-thumb>
+  <m3e-slider-thumb value="75"></m3e-slider-thumb>
+</m3e-slider>
+```
+
+## 📖 API Reference
+
+### 🗂️ Slider
+
+This section details the attributes, events and CSS custom properties available for the `m3e-slider` component.
+
+#### ⚙️ Attributes
+
+| Attribute  | Type                                                               | Default         | Description                                  |
+| ---------- | ------------------------------------------------------------------ | --------------- | -------------------------------------------- |
+| `disabled` | `boolean`                                                          | `false`         | Whether the element is disabled.             |
+| `discrete` | `boolean`                                                          | `false`         | Whether to show tick marks.                  |
+| `labelled` | `boolean`                                                          | `false`         | Whether to show value labels when activated. |
+| `min`      | `number`                                                           | `0`             | The minimum allowable value.                 |
+| `max`      | `number`                                                           | `100`           | The maximum allowable value.                 |
+| `step`     | `number`                                                           | `1`             | The value at which the thumb will snap.      |
+| `size`     | `"extra-small"`, `"small"`, `"medium"`, `"large"`, `"extra-large"` | `"extra-small"` | The size of the slider.                      |
+
+#### 🔔 Events
+
+| Event    | Description                     |
+| -------- | ------------------------------- |
+| `input`  | Emitted when the value changes. |
+| `change` | Emitted when the value changes. |
+
+#### 🎛️ CSS Custom Properties
+
+| Property                                                     | Description                                                       |
+| ------------------------------------------------------------ | ----------------------------------------------------------------- |
+| `--m3e-slider-min-width`                                     | Minimum inline size of the slider host.                           |
+| `--m3e-slider-small-height`                                  | Height of the slider when size is small or extra-small.           |
+| `--m3e-slider-medium-height`                                 | Height of the slider when size is medium.                         |
+| `--m3e-slider-large-height`                                  | Height of the slider when size is large.                          |
+| `--m3e-slider-extra-large-height`                            | Height of the slider when size is extra-large.                    |
+| `--m3e-slider-small-active-track-shape`                      | Corner shape of the active track for small sliders.               |
+| `--m3e-slider-small-inactive-active-track-start-shape`       | Corner shape of the inactive track start for small sliders.       |
+| `--m3e-slider-small-inactive-track-end-shape`                | Corner shape of the inactive track end for small sliders.         |
+| `--m3e-slider-medium-active-track-shape`                     | Corner shape of the active track for medium sliders.              |
+| `--m3e-slider-medium-inactive-active-track-start-shape`      | Corner shape of the inactive track start for medium sliders.      |
+| `--m3e-slider-medium-inactive-track-end-shape`               | Corner shape of the inactive track end for medium sliders.        |
+| `--m3e-slider-large-active-track-shape`                      | Corner shape of the active track for large sliders.               |
+| `--m3e-slider-large-inactive-active-track-start-shape`       | Corner shape of the inactive track start for large sliders.       |
+| `--m3e-slider-large-inactive-track-end-shape`                | Corner shape of the inactive track end for large sliders.         |
+| `--m3e-slider-extra-large-active-track-shape`                | Corner shape of the active track for extra-large sliders.         |
+| `--m3e-slider-extra-large-inactive-active-track-start-shape` | Corner shape of the inactive track start for extra-large sliders. |
+| `--m3e-slider-extra-large-inactive-track-end-shape`          | Corner shape of the inactive track end for extra-large sliders.   |
+| `--m3e-slider-extra-small-track-height`                      | Height of the track for extra-small sliders.                      |
+| `--m3e-slider-small-track-height`                            | Height of the track for small sliders.                            |
+| `--m3e-slider-medium-track-height`                           | Height of the track for medium sliders.                           |
+| `--m3e-slider-large-track-height`                            | Height of the track for large sliders.                            |
+| `--m3e-slider-extra-large-track-height`                      | Height of the track for extra-large sliders.                      |
+| `--m3e-slider-tick-size`                                     | Size of each tick mark.                                           |
+| `--m3e-slider-tick-shape`                                    | Corner shape of each tick mark.                                   |
+| `--m3e-slider-inactive-track-color`                          | Background color of the inactive track when enabled.              |
+| `--m3e-slider-disabled-inactive-track-color`                 | Base color of the inactive track when disabled.                   |
+| `--m3e-slider-disabled-inactive-track-opacity`               | Opacity of the inactive track when disabled.                      |
+| `--m3e-slider-active-track-color`                            | Background color of the active track when enabled.                |
+| `--m3e-slider-disabled-active-track-color`                   | Base color of the active track when disabled.                     |
+| `--m3e-slider-disabled-active-track-opacity`                 | Opacity of the active track when disabled.                        |
+| `--m3e-slider-tick-active-color`                             | Color of active ticks when enabled.                               |
+| `--m3e-slider-disabled-tick-active-color`                    | Color of active ticks when disabled.                              |
+| `--m3e-slider-tick-inactive-color`                           | Color of inactive ticks when enabled.                             |
+| `--m3e-slider-disabled-tick-inactive-color`                  | Color of inactive ticks when disabled.                            |
+
+### 🗂️ Slider Thumb
+
+This section details the attributes, events and CSS custom properties available for the `m3e-slider-thumb` component.
+
+#### ⚙️ Attributes
+
+| Attribute  | Type               | Default | Description                                                               |
+| ---------- | ------------------ | ------- | ------------------------------------------------------------------------- |
+| `disabled` | `boolean`          | `false` | Whether the element is disabled.                                          |
+| `name`     | `string`           |         | The name that identifies the element when submitting the associated form. |
+| `value`    | `number` \| `null` | `null`  | The value of the thumb.                                                   |
+
+#### 🔔 Events
+
+| Event    | Description                     |
+| -------- | ------------------------------- |
+| `input`  | Emitted when the value changes. |
+| `change` | Emitted when the value changes. |
+
+#### 🎛️ CSS Custom Properties
+
+| Property                              | Description                                    |
+| ------------------------------------- | ---------------------------------------------- |
+| `--m3e-slider-thumb-width`            | Width of the slider thumb.                     |
+| `--m3e-slider-thumb-padding`          | Horizontal padding around the thumb.           |
+| `--m3e-slider-thumb-color`            | Active color of the slider thumb when enabled. |
+| `--m3e-slider-thumb-pressed-width`    | Width of the thumb when pressed.               |
+| `--m3e-slider-thumb-disabled-color`   | Color of the thumb when disabled.              |
+| `--m3e-slider-thumb-disabled-opacity` | Opacity of the thumb when disabled.            |
+| `--m3e-slider-label-width`            | Width of the floating label above the thumb.   |
+| `--m3e-slider-label-container-color`  | Background color of the label container.       |
+| `--m3e-slider-label-color`            | Text color of the label.                       |
+| `--m3e-slider-label-font-size`        | Font size of the label text.                   |
+| `--m3e-slider-label-font-weight`      | Font weight of the label text.                 |
+| `--m3e-slider-label-line-height`      | Line height of the label text.                 |
+| `--m3e-slider-label-tracking`         | Letter spacing of the label text.              |
+
+## 🤝 Contributing
+
+See the root monorepo `CONTRIBUTING.md` for guidelines on contributing to this package.
+
+## 📄 License
+
+This package is licensed under the MIT License.

package/cem.config.mjs

@@ -0,0 +1,16 @@
+import { customElementVsCodePlugin } from "custom-element-vs-code-integration";
+
+export default {
+  globs: ["src/**/*.ts"],
+  exclude: ["src/**/*.spec.ts"],
+  packagejson: true,
+  outdir: "dist",
+  litelement: true,
+  plugins: [
+    customElementVsCodePlugin({
+      outdir: "dist",
+      htmlFileName: "html-custom-data.json",
+      cssFileName: "css-custom-data.json",
+    }),
+  ],
+};

package/demo/index.html

@@ -0,0 +1,86 @@
+<!doctype html>
+<html lang="en" style="overflow-y: auto">
+  <head>
+    <title>Slider for M3E</title>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <meta name="description" content="Slider for M3E" />
+    <base href="./" />
+    <link rel="preconnect" href="https://fonts.googleapis.com" />
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
+    <link
+      href="https://fonts.googleapis.com/css2?family=Roboto:ital,wght@0,100..900;1,100..900&display=swap"
+      rel="stylesheet"
+    />
+    <link
+      href="https://fonts.googleapis.com/css2?family=Material+Symbols+Outlined:opsz,wght,FILL,GRAD@24,400,0..1,0"
+      rel="stylesheet"
+    />
+    <script type="importmap">
+      {
+        "imports": {
+          "lit": "https://cdn.jsdelivr.net/npm/lit@3.3.0/+esm",
+          "@m3e/core": "../../core/dist/index.min.js"
+        }
+      }
+    </script>
+    <script type="module" src="../../theme/dist/index.min.js"></script>
+    <script type="module" src="../dist/index.min.js"></script>
+    <style>
+      body {
+        font-family: "Roboto";
+      }
+      *:not(:defined) {
+        display: none;
+      }
+    </style>
+  </head>
+  <body>
+    <m3e-theme strong-focus>
+      <br /><br /><br /><br />
+      <m3e-slider labelled>
+        <m3e-slider-thumb aria-label="Slider thumb" value="50"></m3e-slider-thumb>
+      </m3e-slider>
+      <m3e-slider labelled>
+        <m3e-slider-thumb aria-label="Slider thumb" value="50"></m3e-slider-thumb>
+      </m3e-slider>
+      <m3e-slider labelled>
+        <m3e-slider-thumb aria-label="Slider thumb" value="50"></m3e-slider-thumb>
+        <m3e-slider-thumb aria-label="Slider thumb" value="75"></m3e-slider-thumb>
+      </m3e-slider>
+      <m3e-slider labelled discrete step="10">
+        <m3e-slider-thumb aria-label="Slider thumb" value="20"></m3e-slider-thumb>
+        <m3e-slider-thumb aria-label="Slider thumb" value="70"></m3e-slider-thumb>
+      </m3e-slider>
+      <m3e-slider labelled min="-50">
+        <m3e-slider-thumb aria-label="Slider thumb" value="-20"></m3e-slider-thumb>
+      </m3e-slider>
+      <br />
+      <br />
+      <m3e-slider labelled disabled>
+        <m3e-slider-thumb aria-label="Slider thumb" value="50"></m3e-slider-thumb>
+      </m3e-slider>
+      <m3e-slider labelled disabled>
+        <m3e-slider-thumb aria-label="Slider thumb" value="50"></m3e-slider-thumb>
+        <m3e-slider-thumb aria-label="Slider thumb" value="75"></m3e-slider-thumb>
+      </m3e-slider>
+      <br /><br />
+      <m3e-slider size="small" labelled>
+        <m3e-slider-thumb aria-label="Slider thumb" value="50"></m3e-slider-thumb>
+        <m3e-slider-thumb aria-label="Slider thumb" value="75"></m3e-slider-thumb>
+      </m3e-slider>
+      <m3e-slider size="medium" labelled>
+        <m3e-slider-thumb aria-label="Slider thumb" value="50"></m3e-slider-thumb>
+        <m3e-slider-thumb aria-label="Slider thumb" value="75"></m3e-slider-thumb>
+      </m3e-slider>
+      <m3e-slider size="large" labelled>
+        <m3e-slider-thumb aria-label="Slider thumb" value="50"></m3e-slider-thumb>
+        <m3e-slider-thumb aria-label="Slider thumb" value="75"></m3e-slider-thumb>
+      </m3e-slider>
+      <m3e-slider size="extra-large" labelled>
+        <m3e-slider-thumb aria-label="Slider thumb" value="50"></m3e-slider-thumb>
+        <m3e-slider-thumb aria-label="Slider thumb" value="75"></m3e-slider-thumb>
+      </m3e-slider>
+    </m3e-theme>
+  </body>
+</html>

package/dist/css-custom-data.json

@@ -0,0 +1,242 @@
+{
+  "$schema": "https://raw.githubusercontent.com/microsoft/vscode-css-languageservice/main/docs/customData.schema.json",
+  "version": 1.1,
+  "properties": [
+    {
+      "name": "--m3e-slider-min-width",
+      "description": "Minimum inline size of the slider host.",
+      "values": []
+    },
+    {
+      "name": "--m3e-slider-small-height",
+      "description": "Height of the slider when size is small or extra-small.",
+      "values": []
+    },
+    {
+      "name": "--m3e-slider-medium-height",
+      "description": "Height of the slider when size is medium.",
+      "values": []
+    },
+    {
+      "name": "--m3e-slider-large-height",
+      "description": "Height of the slider when size is large.",
+      "values": []
+    },
+    {
+      "name": "--m3e-slider-extra-large-height",
+      "description": "Height of the slider when size is extra-large.",
+      "values": []
+    },
+    {
+      "name": "--m3e-slider-small-active-track-shape",
+      "description": "Corner shape of the active track for small sliders.",
+      "values": []
+    },
+    {
+      "name": "--m3e-slider-small-inactive-active-track-start-shape",
+      "description": "Corner shape of the inactive track start for small sliders.",
+      "values": []
+    },
+    {
+      "name": "--m3e-slider-small-inactive-track-end-shape",
+      "description": "Corner shape of the inactive track end for small sliders.",
+      "values": []
+    },
+    {
+      "name": "--m3e-slider-medium-active-track-shape",
+      "description": "Corner shape of the active track for medium sliders.",
+      "values": []
+    },
+    {
+      "name": "--m3e-slider-medium-inactive-active-track-start-shape",
+      "description": "Corner shape of the inactive track start for medium sliders.",
+      "values": []
+    },
+    {
+      "name": "--m3e-slider-medium-inactive-track-end-shape",
+      "description": "Corner shape of the inactive track end for medium sliders.",
+      "values": []
+    },
+    {
+      "name": "--m3e-slider-large-active-track-shape",
+      "description": "Corner shape of the active track for large sliders.",
+      "values": []
+    },
+    {
+      "name": "--m3e-slider-large-inactive-active-track-start-shape",
+      "description": "Corner shape of the inactive track start for large sliders.",
+      "values": []
+    },
+    {
+      "name": "--m3e-slider-large-inactive-track-end-shape",
+      "description": "Corner shape of the inactive track end for large sliders.",
+      "values": []
+    },
+    {
+      "name": "--m3e-slider-extra-large-active-track-shape",
+      "description": "Corner shape of the active track for extra-large sliders.",
+      "values": []
+    },
+    {
+      "name": "--m3e-slider-extra-large-inactive-active-track-start-shape",
+      "description": "Corner shape of the inactive track start for extra-large sliders.",
+      "values": []
+    },
+    {
+      "name": "--m3e-slider-extra-large-inactive-track-end-shape",
+      "description": "Corner shape of the inactive track end for extra-large sliders.",
+      "values": []
+    },
+    {
+      "name": "--m3e-slider-extra-small-track-height",
+      "description": "Height of the track for extra-small sliders.",
+      "values": []
+    },
+    {
+      "name": "--m3e-slider-small-track-height",
+      "description": "Height of the track for small sliders.",
+      "values": []
+    },
+    {
+      "name": "--m3e-slider-medium-track-height",
+      "description": "Height of the track for medium sliders.",
+      "values": []
+    },
+    {
+      "name": "--m3e-slider-large-track-height",
+      "description": "Height of the track for large sliders.",
+      "values": []
+    },
+    {
+      "name": "--m3e-slider-extra-large-track-height",
+      "description": "Height of the track for extra-large sliders.",
+      "values": []
+    },
+    {
+      "name": "--m3e-slider-tick-size",
+      "description": "Size of each tick mark.",
+      "values": []
+    },
+    {
+      "name": "--m3e-slider-tick-shape",
+      "description": "Corner shape of each tick mark.",
+      "values": []
+    },
+    {
+      "name": "--m3e-slider-inactive-track-color",
+      "description": "Background color of the inactive track when enabled.",
+      "values": []
+    },
+    {
+      "name": "--m3e-slider-disabled-inactive-track-color",
+      "description": "Base color of the inactive track when disabled.",
+      "values": []
+    },
+    {
+      "name": "--m3e-slider-disabled-inactive-track-opacity",
+      "description": "Opacity of the inactive track when disabled.",
+      "values": []
+    },
+    {
+      "name": "--m3e-slider-active-track-color",
+      "description": "Background color of the active track when enabled.",
+      "values": []
+    },
+    {
+      "name": "--m3e-slider-disabled-active-track-color",
+      "description": "Base color of the active track when disabled.",
+      "values": []
+    },
+    {
+      "name": "--m3e-slider-disabled-active-track-opacity",
+      "description": "Opacity of the active track when disabled.",
+      "values": []
+    },
+    {
+      "name": "--m3e-slider-tick-active-color",
+      "description": "Color of active ticks when enabled.",
+      "values": []
+    },
+    {
+      "name": "--m3e-slider-disabled-tick-active-color",
+      "description": "Color of active ticks when disabled.",
+      "values": []
+    },
+    {
+      "name": "--m3e-slider-tick-inactive-color",
+      "description": "Color of inactive ticks when enabled.",
+      "values": []
+    },
+    {
+      "name": "--m3e-slider-disabled-tick-inactive-color",
+      "description": "Color of inactive ticks when disabled.",
+      "values": []
+    },
+    {
+      "name": "--m3e-slider-thumb-width",
+      "description": "Width of the slider thumb.",
+      "values": []
+    },
+    {
+      "name": "--m3e-slider-thumb-padding",
+      "description": "Horizontal padding around the thumb.",
+      "values": []
+    },
+    {
+      "name": "--m3e-slider-thumb-color",
+      "description": "Active color of the slider thumb when enabled.",
+      "values": []
+    },
+    {
+      "name": "--m3e-slider-thumb-pressed-width",
+      "description": "Width of the thumb when pressed.",
+      "values": []
+    },
+    {
+      "name": "--m3e-slider-thumb-disabled-color",
+      "description": "Color of the thumb when disabled.",
+      "values": []
+    },
+    {
+      "name": "--m3e-slider-thumb-disabled-opacity",
+      "description": "Opacity of the thumb when disabled.",
+      "values": []
+    },
+    {
+      "name": "--m3e-slider-label-width",
+      "description": "Width of the floating label above the thumb.",
+      "values": []
+    },
+    {
+      "name": "--m3e-slider-label-container-color",
+      "description": "Background color of the label container.",
+      "values": []
+    },
+    {
+      "name": "--m3e-slider-label-color",
+      "description": "Text color of the label.",
+      "values": []
+    },
+    {
+      "name": "--m3e-slider-label-font-size",
+      "description": "Font size of the label text.",
+      "values": []
+    },
+    {
+      "name": "--m3e-slider-label-font-weight",
+      "description": "Font weight of the label text.",
+      "values": []
+    },
+    {
+      "name": "--m3e-slider-label-line-height",
+      "description": "Line height of the label text.",
+      "values": []
+    },
+    {
+      "name": "--m3e-slider-label-tracking",
+      "description": "Letter spacing of the label text.",
+      "values": []
+    }
+  ],
+  "pseudoElements": []
+}