zdp-design-system 0.43.8

package/dist/components/Kbd.svelte

@@ -0,0 +1,63 @@
+<script lang="ts">
+  export let label: string | null = null;
+  export let size: 'sm' | 'md' = 'md';
+  export let ariaLabel: string | null = null;
+  export let title: string | null = null;
+</script>
+
+{#if ariaLabel}
+  <span class="zdp-kbd__sr-label">{ariaLabel}</span>
+{/if}
+<kbd
+  class={`zdp-kbd zdp-kbd--${size}`}
+  aria-hidden={ariaLabel ? 'true' : undefined}
+  title={title ?? undefined}
+>
+  {#if label !== null}
+    {label}
+  {:else}
+    <slot />
+  {/if}
+</kbd>
+
+<style>
+  .zdp-kbd {
+    background: var(--zdp-color-surface-raised);
+    border: var(--zdp-control-border-width) solid var(--zdp-color-line-subtle);
+    border-radius: var(--zdp-radius-sm);
+    box-sizing: border-box;
+    color: var(--zdp-color-ink-muted);
+    display: inline-grid;
+    font-family: ui-monospace, "SFMono-Regular", Consolas, "Liberation Mono", monospace;
+    font-weight: var(--zdp-font-weight-medium);
+    line-height: 1;
+    min-height: 1.45em;
+    min-width: 1.45em;
+    padding: 0 0.35em;
+    place-items: center;
+    -webkit-user-select: none;
+    user-select: none;
+    vertical-align: middle;
+    white-space: nowrap;
+  }
+
+  .zdp-kbd__sr-label {
+    block-size: 1px;
+    clip: rect(0 0 0 0);
+    clip-path: inset(50%);
+    inline-size: 1px;
+    margin: -1px;
+    overflow: hidden;
+    padding: 0;
+    position: absolute;
+    white-space: nowrap;
+  }
+
+  .zdp-kbd--sm {
+    font-size: 0.78em;
+  }
+
+  .zdp-kbd--md {
+    font-size: 0.86em;
+  }
+</style>

package/dist/components/KeyValue.svelte

@@ -0,0 +1,73 @@
+<script lang="ts">
+  export let columns: 'one' | 'two' = 'one';
+  export let density: 'default' | 'compact' = 'default';
+  export let labelledBy: string | null = null;
+</script>
+
+<dl
+  class={`zdp-key-value zdp-key-value--columns-${columns} zdp-key-value--density-${density}`}
+  aria-labelledby={labelledBy ?? undefined}
+>
+  <slot />
+</dl>
+
+<style>
+  .zdp-key-value {
+    border: 1px solid var(--zdp-color-line-subtle);
+    border-radius: var(--zdp-control-radius);
+    color: var(--zdp-color-ink-normal);
+    display: grid;
+    font-family: var(--zdp-font-family-sans);
+    font-size: var(--zdp-type-body-small-size);
+    line-height: var(--zdp-type-body-small-line-height);
+    margin: 0;
+    min-width: 0;
+  }
+
+  .zdp-key-value :global(dt),
+  .zdp-key-value :global(dd) {
+    border-block-start: 1px solid var(--zdp-color-line-subtle);
+    margin: 0;
+    min-width: 0;
+    padding: var(--zdp-space-3) var(--zdp-space-4);
+  }
+
+  .zdp-key-value :global(dt:first-child),
+  .zdp-key-value :global(dt:first-child + dd) {
+    border-block-start: 0;
+  }
+
+  .zdp-key-value :global(dt) {
+    color: var(--zdp-color-ink-muted);
+    font-weight: var(--zdp-font-weight-medium);
+  }
+
+  .zdp-key-value :global(dd) {
+    color: var(--zdp-color-ink-strong);
+    overflow-wrap: var(--zdp-i18n-overflow-wrap);
+  }
+
+  .zdp-key-value--columns-two {
+    grid-template-columns: minmax(10rem, 0.42fr) minmax(0, 1fr);
+  }
+
+  .zdp-key-value--columns-one {
+    grid-template-columns: 1fr;
+  }
+
+  .zdp-key-value--density-compact :global(dt),
+  .zdp-key-value--density-compact :global(dd) {
+    padding: var(--zdp-space-2) var(--zdp-space-3);
+  }
+
+  @media (max-width: 42rem) {
+    .zdp-key-value--columns-two {
+      grid-template-columns: 1fr;
+    }
+
+    .zdp-key-value--columns-two :global(dd) {
+      border-block-start: 0;
+      padding-block-start: 0;
+    }
+  }
+</style>

package/dist/components/Label.svelte

@@ -0,0 +1,43 @@
+<script lang="ts">
+  export let forId: string | null = null;
+  export let required = false;
+  export let requiredLabel = 'Required';
+</script>
+
+<label class="zdp-label" for={forId ?? undefined}>
+  <slot />
+  {#if required}
+    <span class="zdp-label__required" aria-hidden="true">*</span>
+    <span class="zdp-label__required-text">({requiredLabel})</span>
+  {/if}
+</label>
+
+<style>
+  .zdp-label {
+    color: var(--zdp-color-ink-strong);
+    font-family: var(--zdp-font-family-sans);
+    font-size: var(--zdp-type-label-size);
+    font-weight: var(--zdp-font-weight-medium);
+    line-height: var(--zdp-type-label-line-height);
+  }
+
+  .zdp-label__required {
+    color: var(--zdp-color-accent-danger);
+    margin-left: var(--zdp-space-1);
+    -webkit-user-select: none;
+    user-select: none;
+  }
+
+  .zdp-label__required-text {
+    border: 0;
+    clip: rect(0 0 0 0);
+    clip-path: inset(50%);
+    height: 1px;
+    margin: -1px;
+    overflow: hidden;
+    padding: 0;
+    position: absolute;
+    white-space: nowrap;
+    width: 1px;
+  }
+</style>

package/dist/components/Link.svelte

@@ -0,0 +1,70 @@
+<script lang="ts">
+  export let href: string;
+  export let tone: 'primary' | 'muted' = 'primary';
+  export let target: '_self' | '_blank' | '_parent' | '_top' | undefined = undefined;
+  export let rel: string | undefined = undefined;
+  export let ariaCurrent:
+    | 'page'
+    | 'step'
+    | 'location'
+    | 'date'
+    | 'time'
+    | 'true'
+    | true
+    | false
+    | undefined = undefined;
+  export let ariaKeyShortcuts: string | null = null;
+
+  $: resolvedRel = target === '_blank' ? rel ?? 'noopener noreferrer' : rel;
+  $: resolvedAriaCurrent =
+    ariaCurrent === true ? 'true' : ariaCurrent === false ? undefined : ariaCurrent;
+</script>
+
+<a
+  class={`zdp-link zdp-link--${tone}`}
+  {href}
+  {target}
+  rel={resolvedRel}
+  aria-current={resolvedAriaCurrent}
+  aria-keyshortcuts={ariaKeyShortcuts ?? undefined}
+>
+  <slot />
+</a>
+
+<style>
+  .zdp-link {
+    border-bottom: var(--zdp-control-focus-underline-width) solid transparent;
+    color: var(--zdp-color-ink-normal);
+    font-family: var(--zdp-font-family-sans);
+    font-weight: var(--zdp-font-weight-medium);
+    overflow-wrap: var(--zdp-i18n-overflow-wrap);
+    text-decoration-line: none;
+    transition:
+      background-color var(--zdp-motion-fast) ease,
+      border-color var(--zdp-motion-fast) ease,
+      color var(--zdp-motion-fast) ease;
+  }
+
+  .zdp-link:hover {
+    color: var(--zdp-color-ink-strong);
+  }
+
+  .zdp-link:focus-visible {
+    background: var(--zdp-color-focus-surface);
+    border-bottom-color: var(--zdp-color-focus-line);
+    color: var(--zdp-color-focus-text);
+    outline: 0;
+  }
+
+  .zdp-link[aria-current] {
+    color: var(--zdp-color-ink-strong);
+  }
+
+  .zdp-link--primary {
+    color: var(--zdp-color-ink-normal);
+  }
+
+  .zdp-link--muted {
+    color: var(--zdp-color-ink-muted);
+  }
+</style>

package/dist/components/LocaleSwitcher.svelte

@@ -0,0 +1,209 @@
+<script lang="ts" context="module">
+  let nextLocaleSwitcherInstanceId = 0;
+</script>
+
+<script lang="ts">
+  import {
+    zdpLocaleSwitcherOptions,
+    type ZdpLocaleSwitcherOption,
+    type ZdpLocaleSwitcherSize
+  } from '../preferences';
+
+  export let value = 'en';
+  export let options: readonly ZdpLocaleSwitcherOption[] = zdpLocaleSwitcherOptions;
+  export let ariaLabel = 'Language';
+  export let idPrefix: string | null = null;
+  export let size: ZdpLocaleSwitcherSize = 'md';
+  export let disabled = false;
+  export let onChange:
+    | ((event: MouseEvent | KeyboardEvent, option: ZdpLocaleSwitcherOption) => void)
+    | null = null;
+
+  const fallbackIdPrefix = `zdp-locale-switcher-${++nextLocaleSwitcherInstanceId}`;
+
+  $: enabledOptions = options.filter((option) => !option.disabled);
+  $: activeOption =
+    enabledOptions.find((option) => option.value === value) ?? enabledOptions[0] ?? options[0] ?? null;
+  $: activeValue = activeOption?.value ?? value;
+  $: resolvedIdPrefix = toDomId(idPrefix ?? fallbackIdPrefix);
+
+  function selectOption(event: MouseEvent | KeyboardEvent, option: ZdpLocaleSwitcherOption): void {
+    if (disabled || option.disabled) {
+      return;
+    }
+
+    const previousValue = value;
+    value = option.value;
+
+    if (previousValue !== option.value) {
+      onChange?.(event, option);
+    }
+  }
+
+  function handleKeydown(event: KeyboardEvent): void {
+    if (!['ArrowLeft', 'ArrowRight', 'Home', 'End'].includes(event.key)) {
+      return;
+    }
+
+    const target = event.currentTarget as HTMLElement;
+    const controls = Array.from(target.querySelectorAll<HTMLButtonElement>('[role="radio"]:not(:disabled)'));
+
+    if (controls.length === 0) {
+      return;
+    }
+
+    event.preventDefault();
+
+    const currentIndex = Math.max(
+      0,
+      controls.findIndex((control) => control.getAttribute('aria-checked') === 'true')
+    );
+    const nextIndex = getNextIndex(event.key, currentIndex, controls.length);
+    const nextControl = controls[nextIndex];
+
+    nextControl.focus();
+    nextControl.click();
+  }
+
+  function getNextIndex(key: string, currentIndex: number, length: number): number {
+    if (key === 'Home') {
+      return 0;
+    }
+
+    if (key === 'End') {
+      return length - 1;
+    }
+
+    if (key === 'ArrowLeft') {
+      return (currentIndex - 1 + length) % length;
+    }
+
+    return (currentIndex + 1) % length;
+  }
+
+  function optionId(option: ZdpLocaleSwitcherOption): string {
+    return `${resolvedIdPrefix}-option-${toDomId(option.value)}`;
+  }
+
+  function toDomId(value: string): string {
+    return value.trim().replace(/[^a-zA-Z0-9_-]+/g, '-') || 'option';
+  }
+</script>
+
+<div
+  class={`zdp-locale-switcher zdp-locale-switcher--${size}`}
+  role="radiogroup"
+  aria-label={ariaLabel}
+  aria-disabled={disabled ? 'true' : undefined}
+  tabindex="-1"
+  data-zdp-locale-switcher
+  data-zdp-locale-value={activeValue}
+  onkeydown={handleKeydown}
+>
+  {#each options as option (option.value)}
+    <button
+      class={`zdp-locale-switcher__item ${
+        option.value === activeValue ? 'zdp-locale-switcher__item--selected' : ''
+      }`}
+      id={optionId(option)}
+      type="button"
+      role="radio"
+      lang={option.lang ?? undefined}
+      aria-label={option.ariaLabel ?? option.label}
+      aria-checked={option.value === activeValue}
+      tabindex={option.value === activeValue ? 0 : -1}
+      disabled={disabled || option.disabled}
+      data-zdp-locale-option
+      data-zdp-locale-option-value={option.value}
+      onclick={(event) => selectOption(event, option)}
+    >
+      <span class="zdp-locale-switcher__label" aria-hidden="true">
+        {option.shortLabel ?? option.label}
+      </span>
+    </button>
+  {/each}
+</div>
+
+<style>
+  .zdp-locale-switcher {
+    align-items: center;
+    background: var(--zdp-color-surface-panel);
+    border: var(--zdp-control-border-width) solid var(--zdp-color-line-subtle);
+    border-radius: var(--zdp-control-radius);
+    box-sizing: border-box;
+    color: var(--zdp-color-ink-normal);
+    display: inline-flex;
+    flex: 0 0 auto;
+    font-family: var(--zdp-font-family-sans);
+    gap: var(--zdp-space-1);
+    max-width: 100%;
+    min-width: 0;
+    padding: var(--zdp-space-1);
+  }
+
+  .zdp-locale-switcher__item {
+    align-items: center;
+    background: transparent;
+    border: var(--zdp-control-border-width) solid transparent;
+    border-radius: var(--zdp-control-radius);
+    box-sizing: border-box;
+    color: var(--zdp-color-ink-muted);
+    cursor: pointer;
+    display: inline-grid;
+    font-family: var(--zdp-font-family-sans);
+    font-weight: var(--zdp-font-weight-semibold);
+    justify-content: center;
+    letter-spacing: 0;
+    line-height: 1;
+    min-width: 0;
+    padding: 0 var(--zdp-space-2);
+    place-items: center;
+    text-align: center;
+    transition:
+      background-color var(--zdp-motion-fast) ease,
+      border-color var(--zdp-motion-fast) ease,
+      color var(--zdp-motion-fast) ease;
+    -webkit-user-select: none;
+    user-select: none;
+  }
+
+  .zdp-locale-switcher--sm .zdp-locale-switcher__item {
+    height: var(--zdp-control-icon-sm);
+    min-width: calc(var(--zdp-control-icon-sm) + var(--zdp-space-2));
+  }
+
+  .zdp-locale-switcher--md .zdp-locale-switcher__item {
+    height: var(--zdp-control-icon-md);
+    min-width: calc(var(--zdp-control-icon-md) + var(--zdp-space-2));
+  }
+
+  .zdp-locale-switcher__item:hover:not(:disabled):not([aria-checked='true']) {
+    background: var(--zdp-color-surface-raised);
+    border-color: var(--zdp-color-line-strong);
+    color: var(--zdp-color-ink-strong);
+  }
+
+  .zdp-locale-switcher__item:focus-visible {
+    border-color: var(--zdp-color-focus-line);
+    outline: var(--zdp-control-focus-outline-width) solid var(--zdp-color-focus-surface);
+    outline-offset: var(--zdp-control-focus-outline-offset);
+  }
+
+  .zdp-locale-switcher__item--selected,
+  .zdp-locale-switcher__item[aria-checked='true'] {
+    background: var(--zdp-color-accent-primary-soft);
+    border-color: var(--zdp-color-accent-primary-strong);
+    color: var(--zdp-color-ink-strong);
+  }
+
+  .zdp-locale-switcher__item:disabled {
+    cursor: not-allowed;
+    opacity: 0.56;
+  }
+
+  .zdp-locale-switcher__label {
+    display: inline-block;
+    line-height: 1;
+    white-space: nowrap;
+  }
+</style>