@sondor-technology/sondor-components 1.0.9 → 1.0.10

package/src/components/vertical-nav/vertical-nav-group.ts

@@ -22,13 +22,13 @@ export class StNavGroup extends LitElement {
       button {
         display: flex;
         align-items: center;
-        gap: var(--st-spacing-sm, 8px);
+        gap: var(--st-spacing-sm);
         width: 100%;
         box-sizing: border-box;
         background: transparent;
         border: none;
         padding: var(--st-spacing-sm) var(--st-spacing-xl);
-        padding-left: calc(var(--st-spacing-xl, 24px) + (var(--nav-depth, 0) * 16px));
+        padding-left: calc(var(--st-spacing-xl) + (var(--nav-depth, 0) * 16px));
         color: var(--st-color-text);
         font-size: var(--st-font-size-sm);
         font-weight: var(--st-font-weight-semibold);
@@ -39,7 +39,7 @@ export class StNavGroup extends LitElement {
       }
 
       button:hover {
-        background-color: var(--st-color-surface-hover, rgba(0, 0, 0, 0.03));
+        background-color: var(--st-color-surface-hover);
       }
 
       button:focus-visible {

package/src/components/vertical-nav/vertical-nav-item.ts

@@ -19,11 +19,11 @@ export class StNavItem extends LitElement {
       a {
         display: flex;
         align-items: center;
-        gap: var(--st-spacing-sm, 8px);
+        gap: var(--st-spacing-sm);
         width: 100%;
         box-sizing: border-box;
         padding: 8px var(--st-spacing-xl);
-        padding-left: calc(var(--st-spacing-xl, 24px) + (var(--nav-depth, 0) * 16px));
+        padding-left: calc(var(--st-spacing-xl) + (var(--nav-depth, 0) * 16px));
         color: var(--st-color-text-muted);
         font-size: var(--st-font-size-sm);
         text-decoration: none;
@@ -37,7 +37,7 @@ export class StNavItem extends LitElement {
 
       a:hover {
         color: var(--st-color-text);
-        background-color: var(--st-color-surface-hover, rgba(0, 0, 0, 0.03));
+        background-color: var(--st-color-surface-hover);
       }
 
       a:focus-visible {
@@ -56,7 +56,7 @@ export class StNavItem extends LitElement {
         color: var(--st-color-primary);
         border-left-color: var(--st-color-primary);
         font-weight: var(--st-font-weight-bold);
-        background-color: var(--st-color-primary-light, rgba(98, 0, 238, 0.05));
+        background-color: var(--st-color-primary-light);
       }
     `,
   ];

package/src/components/video-embed/video-embed.ts

@@ -0,0 +1,162 @@
+import {LitElement, html, css, PropertyValues} from "lit";
+import {customElement, property} from "lit/decorators.js";
+import {resetStyles} from "../../styles/reset.js";
+
+const ID_PATTERN = /^[\w-]+$/;
+
+/**
+ * Shows a poster and a play button, and only loads the video player (an iframe, which is heavy
+ * and sets third-party cookies) once someone presses play. Pages stay fast and visitors are not
+ * tracked before they choose to watch.
+ *
+ * Give it a `youtube` or `vimeo` id, or an `https` embed address in `src`. Slot your own poster
+ * as `<img slot="poster" alt="">`: no third-party request is made until play is pressed.
+ *
+ * Events: `st-play` (bubbles, composed) when the player is loaded.
+ */
+@customElement("st-video-embed")
+export class StVideoEmbed extends LitElement {
+  /** A YouTube video id. Uses the privacy-enhanced youtube-nocookie.com player. */
+  @property({type: String}) youtube = "";
+  /** A Vimeo video id. Asks Vimeo not to track the viewer. */
+  @property({type: String}) vimeo = "";
+  /** Any other player, as an https embed address. */
+  @property({type: String}) src = "";
+  /** Name of the video. Used for the play button and the player's accessible title. */
+  @property({type: String}) label = "Video";
+  @property({type: String}) ratio = "16/9";
+  /** True once the player has been loaded. Setting it to true loads the player. */
+  @property({type: Boolean, reflect: true}) playing = false;
+
+  static styles = [
+    resetStyles,
+    css`
+      :host {
+        display: block;
+        position: relative;
+        overflow: hidden;
+        aspect-ratio: var(--_ratio, 16 / 9);
+        background: var(--st-color-surface-muted);
+        border-radius: var(--st-image-radius, var(--st-radius-md));
+      }
+
+      .facade {
+        position: relative;
+        display: grid;
+        place-items: center;
+        width: 100%;
+        height: 100%;
+        padding: 0;
+        border: 0;
+        background: none;
+        cursor: pointer;
+      }
+
+      ::slotted([slot="poster"]) {
+        position: absolute;
+        inset: 0;
+        width: 100%;
+        height: 100%;
+        object-fit: cover;
+      }
+
+      .play {
+        position: relative;
+        display: grid;
+        place-items: center;
+        width: 4.5rem;
+        height: 4.5rem;
+        border-radius: 50%;
+        background: var(--st-color-primary);
+        color: var(--st-color-on-primary);
+        box-shadow: var(--st-shadow-lg);
+        transition: transform 0.2s ease;
+      }
+
+      .play svg {
+        width: 1.75rem;
+        height: 1.75rem;
+        margin-left: 0.2rem;
+        fill: currentColor;
+      }
+
+      .facade:hover .play {
+        transform: scale(1.08);
+      }
+
+      .facade:focus-visible {
+        outline: 3px solid var(--st-color-primary);
+        outline-offset: -3px;
+      }
+
+      iframe {
+        width: 100%;
+        height: 100%;
+        border: 0;
+      }
+
+      @media (prefers-reduced-motion: reduce) {
+        .play {
+          transition: none;
+        }
+      }
+    `,
+  ];
+
+  /** The player address, or an empty string when nothing valid was given. */
+  private get _playerUrl(): string {
+    if (this.youtube && ID_PATTERN.test(this.youtube)) {
+      return `https://www.youtube-nocookie.com/embed/${this.youtube}?autoplay=1&rel=0`;
+    }
+    if (this.vimeo && ID_PATTERN.test(this.vimeo)) {
+      return `https://player.vimeo.com/video/${this.vimeo}?autoplay=1&dnt=1`;
+    }
+    try {
+      const url = new URL(this.src); // no base: relative addresses must be rejected
+      return this.src && url.protocol === "https:" ? url.href : "";
+    } catch {
+      return "";
+    }
+  }
+
+  /** Loads the player. */
+  play() {
+    if (!this._playerUrl || this.playing) return;
+    this.playing = true;
+  }
+
+  protected updated(changed: PropertyValues<this>) {
+    if (this.ratio) this.style.setProperty("--_ratio", this.ratio);
+    if (changed.has("playing") && changed.get("playing") === false && this.playing) {
+      this.dispatchEvent(new CustomEvent("st-play", {bubbles: true, composed: true}));
+      this.renderRoot.querySelector("iframe")?.focus();
+    }
+  }
+
+  render() {
+    const url = this._playerUrl;
+    if (this.playing && url) {
+      return html`<iframe
+        src=${url}
+        title=${this.label}
+        allow="autoplay; encrypted-media; picture-in-picture; fullscreen"
+        allowfullscreen
+        referrerpolicy="strict-origin-when-cross-origin"
+      ></iframe>`;
+    }
+    return html`
+      <button class="facade" type="button" ?disabled=${!url} aria-label=${`Play video: ${this.label}`} @click=${this.play}>
+        <slot name="poster"></slot>
+        <span class="play" aria-hidden="true">
+          <svg viewBox="0 0 24 24"><path d="M8 5v14l11-7z"></path></svg>
+        </span>
+      </button>
+    `;
+  }
+}
+
+declare global {
+  interface HTMLElementTagNameMap {
+    "st-video-embed": StVideoEmbed;
+  }
+}

package/src/index.ts

@@ -0,0 +1,108 @@
+// Barrel: registers every custom element. Prefer subpath imports for smaller bundles.
+import "./components/accordion/accordion.js";
+import "./components/alert/alert.js";
+import "./components/avatar/avatar.js";
+import "./components/badge/badge.js";
+import "./components/breadcrumb/breadcrumb.js";
+import "./components/button/button.js";
+import "./components/button-group/button-group.js";
+import "./components/calendar/calendar.js";
+import "./components/checkbox/checkbox.js";
+import "./components/code-block/code-block.js";
+import "./components/content-card/content-card.js";
+import "./components/cron-builder/cron-builder.js";
+import "./components/divider/divider.js";
+import "./components/drawer/drawer.js";
+import "./components/field/field.js";
+import "./components/footer/footer.js";
+import "./components/form/form-step.js";
+import "./components/form/form.js";
+import "./components/grid/grid-row.js";
+import "./components/grid/grid.js";
+import "./components/icon/icon.js";
+import "./components/input/input.js";
+import "./components/link/link.js";
+import "./components/metadata/metadata.js";
+import "./components/modal/modal.js";
+import "./components/page-layout/page-layout.js";
+import "./components/pagination/pagination.js";
+import "./components/pin-input/pin-input.js";
+import "./components/popover/popover.js";
+import "./components/progress/progress.js";
+import "./components/radio/radio.js";
+import "./components/radio-group/radio-group.js";
+import "./components/router/router.js";
+import "./components/select/select.js";
+import "./components/skeleton/skeleton.js";
+import "./components/spinner/spinner.js";
+import "./components/switch/switch.js";
+import "./components/table/data-table.js";
+import "./components/table/table.js";
+import "./components/tabs/tab-panel.js";
+import "./components/tabs/tab.js";
+import "./components/tabs/tabs.js";
+import "./components/textarea/textarea.js";
+import "./components/theme-toggle/theme-toggle.js";
+import "./components/time-picker/time-picker.js";
+import "./components/toast/toast.js";
+import "./components/toggle-group/toggle-button.js";
+import "./components/toggle-group/toggle-group.js";
+import "./components/tooltip/tooltip.js";
+import "./components/vertical-nav/vertical-nav-group.js";
+import "./components/vertical-nav/vertical-nav-item.js";
+import "./components/line-chart/line-chart.js";
+import "./components/bar-chart/bar-chart.js";
+import "./components/pie-chart/pie-chart.js";
+import "./components/heat-map/heat-map.js";
+import "./components/sparkline/sparkline.js";
+import "./components/stat-card/stat-card.js";
+import "./components/list/list.js";
+import "./components/list/list-item.js";
+import "./components/context-menu/context-menu.js";
+import "./components/reveal/reveal.js";
+import "./components/lazy/lazy.js";
+import "./components/image/image.js";
+import "./components/video-embed/video-embed.js";
+import "./components/container/container.js";
+import "./components/section/section.js";
+import "./components/stack/stack.js";
+import "./components/scroll-progress/scroll-progress.js";
+import "./components/back-to-top/back-to-top.js";
+import "./components/consent/consent.js";
+import "./components/site-header/site-header.js";
+import "./components/hero/hero.js";
+import "./components/feature-grid/feature-grid.js";
+import "./components/feature-grid/feature.js";
+import "./components/split/split.js";
+import "./components/cta/cta.js";
+import "./components/stats/stats.js";
+import "./components/stats/stat.js";
+import "./components/timeline/timeline.js";
+import "./components/timeline/timeline-item.js";
+import "./components/testimonials/testimonials.js";
+import "./components/testimonials/testimonial.js";
+import "./components/faq/faq.js";
+import "./components/faq/faq-item.js";
+import "./components/logo-cloud/logo-cloud.js";
+import "./components/pricing/pricing.js";
+import "./components/pricing/pricing-tier.js";
+import "./components/team/team.js";
+import "./components/team/person.js";
+import "./components/contact/contact.js";
+import "./components/post-list/post-list.js";
+import "./components/post-list/post-card.js";
+import "./components/project-grid/project-grid.js";
+import "./components/project-grid/project-card.js";
+import "./components/series-nav/series-nav.js";
+
+export * from "./components/consent/consent.utils.js";
+export {resetFormState} from "./components/form/form-reset.js";
+export {iconPaths, type IconName} from "./components/icon/icon-paths.js";
+export {showToast, type ToastVariant} from "./components/toast/toast.js";
+export {buildPages} from "./components/pagination/pagination.utils.js";
+export * from "./components/chart/chart.utils.js";
+export type {ChartSeries} from "./components/chart/chart-base.js";
+export type {ListItemData} from "./components/list/list.js";
+export type {TableColumn} from "./components/table/table.js";
+export type {MenuItem} from "./components/context-menu/context-menu.js";
+export * from "./components/table/data-table.utils.js";

package/src/styles/globals.css

@@ -70,6 +70,12 @@
   --st-blue-800: #1e40af;
   --st-blue-900: #1e3a8a;
 
+  /* Chart-only hues */
+  --st-teal-400: #2dd4bf;
+  --st-teal-600: #0d9488;
+  --st-pink-400: #f472b6;
+  --st-pink-600: #db2777;
+
   /* ==========================================================
      Global Spacing Scale
      ========================================================== */
@@ -78,4 +84,61 @@
   --st-spacing-md: 1rem;
   --st-spacing-lg: 1.5rem;
   --st-spacing-xl: 2rem;
+  --st-spacing-2xl: 3rem;
+  --st-spacing-3xl: 4rem;
+
+  /* ==========================================================
+     Page layout (containers and sections)
+     ========================================================== */
+  --st-container-sm: 40rem;
+  --st-container-md: 56rem;
+  --st-container-lg: 72rem;
+  --st-container-xl: 90rem;
+  --st-gutter: clamp(1rem, 4vw, 2rem);
+  --st-section-space-sm: clamp(1.5rem, 4vw, 3rem);
+  --st-section-space-md: clamp(3rem, 8vw, 6rem);
+  --st-section-space-lg: clamp(4rem, 12vw, 9rem);
+
+  /* ==========================================================
+     Motion (used by st-reveal)
+     ========================================================== */
+  --st-ease-out: cubic-bezier(0.22, 1, 0.36, 1);
+  --st-duration-reveal: 600ms;
+
+  --st-gray-300: #d4d4d8;
+  --st-gray-500: #71717a;
+  
+  /* ==========================================================
+     Radius Scale
+     ========================================================== */
+  --st-radius-sm: 0.375rem;
+  --st-radius-md: 0.5rem;
+  --st-radius-lg: 0.75rem;
+
+  /* ==========================================================
+     Elevation (shadows) and overlays
+     ========================================================== */
+  --st-shadow-sm: 0 1px 3px rgb(0 0 0 / 0.1);
+  --st-shadow-md: 0 4px 6px -1px rgb(0 0 0 / 0.1);
+  --st-shadow-lg: 0 10px 15px -3px rgb(0 0 0 / 0.1), 0 4px 6px -2px rgb(0 0 0 / 0.05);
+  --st-shadow-xl: 0 20px 25px -5px rgb(0 0 0 / 0.1), 0 8px 10px -6px rgb(0 0 0 / 0.1);
+  --st-shadow-drawer: 0 4px 24px rgb(0 0 0 / 0.15);
+  --st-shadow-inset: inset 0 3px 5px rgb(0 0 0 / 0.2);
+  --st-color-overlay: rgb(0 0 0 / 0.5);
+
+  /* ==========================================================
+     Code block palette (always dark, independent of theme)
+     ========================================================== */
+  --st-code-bg: #161b22;
+  --st-code-header-bg: #0d1117;
+  --st-code-border: #30363d;
+  --st-code-text: #c9d1d9;
+  --st-code-muted: #8b949e;
+  --st-code-accent: #79c0ff;
+  --st-code-hover: rgb(255 255 255 / 0.1);
+  --st-code-success: #3fb950;
+  --st-code-string: #a5d6ff;
+  --st-code-keyword: #ff7b72;
+  --st-code-function: #d2a8ff;
+  --st-code-number: #ffa657;
 }

package/src/styles/index.css

@@ -1,6 +1,7 @@
 @import "./globals.css";
 @import "./typography.css";
 @import "./theme.css";
+@import "./prose.css";
 
 /* Hide custom elements before they are initialized */
 :not(:defined) {
@@ -26,7 +27,8 @@ h3,
 h4,
 h5,
 h6 {
-  color: var(--st-color-text);
+  /* Inherit so headings placed on a coloured background (an accent row) stay readable. */
+  color: inherit;
   font-weight: var(--st-font-weight-bold);
   line-height: var(--st-line-height-tight);
   margin-top: 0;

package/src/styles/prose.css

@@ -0,0 +1,154 @@
+/*
+ * Article typography. Add the `st-prose` class to a wrapper around long-form content (blog posts,
+ * legal pages, rendered Markdown) and every heading, paragraph, list, quote, table and image
+ * inside it is styled, with no classes needed on the content itself.
+ *
+ *   <article class="st-prose">...</article>
+ *
+ * Tune it with --st-prose-width (line length) and --st-prose-scroll-offset (space reserved for a
+ * sticky header when jumping to a heading).
+ */
+.st-prose {
+  max-width: var(--st-prose-width, 70ch);
+  color: var(--st-color-text);
+  font-size: var(--st-font-size-lg);
+  line-height: 1.75;
+  overflow-wrap: break-word;
+}
+
+.st-prose > :first-child {
+  margin-top: 0;
+}
+
+.st-prose > :last-child {
+  margin-bottom: 0;
+}
+
+.st-prose :is(h1, h2, h3, h4, h5, h6) {
+  margin-top: var(--st-spacing-2xl);
+  margin-bottom: var(--st-spacing-md);
+  scroll-margin-top: var(--st-prose-scroll-offset, var(--st-site-header-height, var(--st-spacing-xl)));
+  text-wrap: balance;
+}
+
+.st-prose :is(h2, h3, h4) + :is(h2, h3, h4) {
+  margin-top: var(--st-spacing-lg);
+}
+
+.st-prose :is(p, ul, ol, blockquote, pre, table, figure, hr, dl) {
+  margin-top: 0;
+  margin-bottom: var(--st-spacing-lg);
+}
+
+.st-prose a {
+  text-decoration: underline;
+  text-underline-offset: 0.2em;
+}
+
+.st-prose :is(ul, ol) {
+  padding-left: var(--st-spacing-xl);
+}
+
+.st-prose ul {
+  list-style: disc;
+}
+
+.st-prose ol {
+  list-style: decimal;
+}
+
+.st-prose li {
+  margin-bottom: var(--st-spacing-sm);
+}
+
+.st-prose li::marker {
+  color: var(--st-color-text-muted);
+}
+
+.st-prose li > :is(ul, ol) {
+  margin-top: var(--st-spacing-sm);
+  margin-bottom: 0;
+}
+
+.st-prose blockquote {
+  padding: var(--st-spacing-xs) 0 var(--st-spacing-xs) var(--st-spacing-lg);
+  border-left: 4px solid var(--st-color-primary);
+  color: var(--st-color-text-muted);
+  font-style: italic;
+}
+
+.st-prose blockquote > :last-child {
+  margin-bottom: 0;
+}
+
+.st-prose pre {
+  overflow-x: auto;
+  padding: var(--st-spacing-md);
+  border-radius: var(--st-radius-md);
+  background: var(--st-code-bg, var(--st-color-surface));
+  color: var(--st-code-text, var(--st-color-text));
+  font-size: var(--st-font-size-sm);
+  line-height: 1.6;
+}
+
+.st-prose pre code {
+  padding: 0;
+  background: none;
+  font-size: inherit;
+}
+
+.st-prose img,
+.st-prose video {
+  max-width: 100%;
+  height: auto;
+  border-radius: var(--st-radius-md);
+}
+
+.st-prose figcaption {
+  margin-top: var(--st-spacing-sm);
+  color: var(--st-color-text-muted);
+  font-size: var(--st-font-size-sm);
+  text-align: center;
+}
+
+.st-prose hr {
+  border: 0;
+  border-top: 1px solid var(--st-color-border);
+}
+
+.st-prose table {
+  display: block;
+  overflow-x: auto;
+  width: 100%;
+  border-collapse: collapse;
+  font-size: var(--st-font-size-base);
+}
+
+.st-prose :is(th, td) {
+  padding: var(--st-spacing-sm) var(--st-spacing-md);
+  border-bottom: 1px solid var(--st-color-border);
+  text-align: left;
+}
+
+.st-prose th {
+  font-weight: var(--st-font-weight-bold);
+}
+
+.st-prose :is(kbd, mark) {
+  padding: 0.1em 0.4em;
+  border-radius: var(--st-radius-sm);
+}
+
+.st-prose kbd {
+  border: 1px solid var(--st-color-border);
+  background: var(--st-color-surface);
+  font-family: var(--st-font-family-mono);
+  font-size: 0.85em;
+}
+
+@media print {
+  .st-prose {
+    max-width: none;
+    font-size: 11pt;
+  }
+}

package/src/styles/reset.ts

@@ -9,6 +9,11 @@ export const resetStyles = css`
     box-sizing: border-box;
   }
 
+  /* A component's own display value must not defeat the native hidden attribute */
+  :host([hidden]) {
+    display: none !important;
+  }
+
   /* 2. Prevent mobile tap highlights and set base behavior */
   :host {
     -webkit-tap-highlight-color: transparent;

package/src/styles/theme.css

@@ -30,6 +30,33 @@
   --st-color-info-bg: var(--st-blue-100);
 
   --st-hover-brightness: 0.9;
+
+  /* Categorical chart palette */
+  --st-chart-1: var(--st-purple-600);
+  --st-chart-2: var(--st-blue-600);
+  --st-chart-3: var(--st-green-600);
+  --st-chart-4: var(--st-amber-600);
+  --st-chart-5: var(--st-red-600);
+  --st-chart-6: var(--st-teal-600);
+  --st-chart-7: var(--st-pink-600);
+  --st-chart-8: var(--st-gray-500);
+
+  --st-color-primary-hover: var(--st-purple-800);
+  --st-color-primary-light: var(--st-color-primary-bg);
+  --st-color-primary-muted: color-mix(in srgb, var(--st-color-primary) 25%, transparent);
+  --st-color-primary-dark: color-mix(in srgb, var(--st-color-primary), black 20%);
+  --st-color-secondary: var(--st-color-text-muted);
+  --st-color-danger: var(--st-color-error);
+
+  /* Text drawn on top of solid semantic backgrounds */
+  --st-color-on-primary: var(--st-white);
+  --st-color-on-success: var(--st-white);
+  --st-color-on-warning: var(--st-white);
+  --st-color-on-info: var(--st-white);
+  --st-color-on-danger: var(--st-white);
+
+  --st-color-bg-rgb: 255 255 255;
+  --st-color-scroll-shadow: rgb(0 0 0 / 0.15);
 }
 
 /* ==========================================================
@@ -65,6 +92,31 @@
 
   --st-hover-brightness: 1.3;
 
+  /* Categorical chart palette */
+  --st-chart-1: var(--st-purple-400);
+  --st-chart-2: var(--st-blue-400);
+  --st-chart-3: var(--st-green-400);
+  --st-chart-4: var(--st-amber-400);
+  --st-chart-5: var(--st-red-400);
+  --st-chart-6: var(--st-teal-400);
+  --st-chart-7: var(--st-pink-400);
+  --st-chart-8: var(--st-gray-300);
+
+  --st-color-primary-hover: var(--st-purple-200);
+  --st-color-primary-light: var(--st-color-primary-bg);
+  --st-color-primary-muted: color-mix(in srgb, var(--st-color-primary) 25%, transparent);
+  --st-color-primary-dark: color-mix(in srgb, var(--st-color-primary), black 20%);
+  --st-color-secondary: var(--st-color-text-muted);
+  --st-color-danger: var(--st-color-error);
+
+  --st-color-on-primary: var(--st-gray-900);
+  --st-color-on-success: var(--st-gray-900);
+  --st-color-on-warning: var(--st-gray-900);
+  --st-color-on-info: var(--st-gray-900);
+  --st-color-on-danger: var(--st-gray-900);
+
+  --st-color-bg-rgb: 24 24 27;
+
   --st-icon-filter: invert(1);
-  --st-color-scroll-shadow: rgba(0, 0, 0, 0.6);
+  --st-color-scroll-shadow: rgb(0 0 0 / 0.6);
 }

package/src/styles/typography.css

@@ -6,6 +6,7 @@
   /* Font Weights */
   --st-font-weight-regular: 400;
   --st-font-weight-medium: 500;
+  --st-font-weight-semibold: 600;
   --st-font-weight-bold: 700;
 
   /* Font Sizes (Scale) - Assuming a 16px browser base */