srcdev-nuxt-components 9.1.43 → 9.1.44

package/app/components/02.molecules/display-chip/tests/DisplayChip.spec.ts

@@ -0,0 +1,191 @@
+import { describe, it, expect, vi } from "vitest";
+import { mountSuspended } from "@nuxt/test-utils/runtime";
+import DisplayChip from "../DisplayChip.vue";
+
+describe("DisplayChip", () => {
+  // ─── Mount ───────────────────────────────────────────────────────────────
+
+  it("mounts without error", async () => {
+    const wrapper = await mountSuspended(DisplayChip);
+    expect(wrapper.vm).toBeTruthy();
+  });
+
+  // ─── Snapshots ───────────────────────────────────────────────────────────
+
+  it("renders correct HTML structure (default)", async () => {
+    const wrapper = await mountSuspended(DisplayChip);
+    expect(wrapper.html()).toMatchSnapshot();
+  });
+
+  it("renders correct HTML structure (with label)", async () => {
+    const wrapper = await mountSuspended(DisplayChip, {
+      props: { config: { size: "12px", maskWidth: "4px", offset: "0px", angle: "90deg", label: "5" } },
+    });
+    expect(wrapper.html()).toMatchSnapshot();
+  });
+
+  it("renders correct HTML structure (with icon)", async () => {
+    const wrapper = await mountSuspended(DisplayChip, {
+      props: { config: { size: "12px", maskWidth: "4px", offset: "0px", angle: "90deg", icon: "mdi:check" } },
+    });
+    expect(wrapper.html()).toMatchSnapshot();
+  });
+
+  it("renders correct HTML structure (square + styleClassPassthrough)", async () => {
+    const wrapper = await mountSuspended(DisplayChip, {
+      props: { shape: "square", styleClassPassthrough: ["online"] },
+    });
+    expect(wrapper.html()).toMatchSnapshot();
+  });
+
+  // ─── Root element ─────────────────────────────────────────────────────────
+
+  it("renders as <span> by default", async () => {
+    const wrapper = await mountSuspended(DisplayChip);
+    expect(wrapper.element.tagName).toBe("SPAN");
+  });
+
+  it("renders as <div> when tag='div'", async () => {
+    const wrapper = await mountSuspended(DisplayChip, { props: { tag: "div" } });
+    expect(wrapper.element.tagName).toBe("DIV");
+  });
+
+  // ─── Base class ───────────────────────────────────────────────────────────
+
+  it("always has the display-chip-core class", async () => {
+    const wrapper = await mountSuspended(DisplayChip);
+    expect(wrapper.classes()).toContain("display-chip-core");
+  });
+
+  // ─── Shape ────────────────────────────────────────────────────────────────
+
+  it("applies circle class by default", async () => {
+    const wrapper = await mountSuspended(DisplayChip);
+    expect(wrapper.classes()).toContain("circle");
+  });
+
+  it("applies square class when shape='square'", async () => {
+    const wrapper = await mountSuspended(DisplayChip, { props: { shape: "square" } });
+    expect(wrapper.classes()).toContain("square");
+    expect(wrapper.classes()).not.toContain("circle");
+  });
+
+  // ─── CSS custom properties ────────────────────────────────────────────────
+
+  it("sets CSS custom properties from config", async () => {
+    const wrapper = await mountSuspended(DisplayChip, {
+      props: {
+        config: { size: "16px", maskWidth: "3px", offset: "4px", angle: "45deg" },
+      },
+    });
+    const style = (wrapper.element as HTMLElement).style;
+    expect(style.getPropertyValue("--chip-size")).toBe("16px");
+    expect(style.getPropertyValue("--chip-mask-width")).toBe("3px");
+    expect(style.getPropertyValue("--chip-offset")).toBe("4px");
+    expect(style.getPropertyValue("--chip-angle")).toBe("45deg");
+  });
+
+  it("sets default CSS custom properties when no config is provided", async () => {
+    const wrapper = await mountSuspended(DisplayChip);
+    const style = (wrapper.element as HTMLElement).style;
+    expect(style.getPropertyValue("--chip-size")).toBe("12px");
+    expect(style.getPropertyValue("--chip-mask-width")).toBe("4px");
+    expect(style.getPropertyValue("--chip-offset")).toBe("0px");
+    expect(style.getPropertyValue("--chip-angle")).toBe("90deg");
+  });
+
+  // ─── Label ────────────────────────────────────────────────────────────────
+
+  it("does not render .chip-label when config has no label", async () => {
+    const wrapper = await mountSuspended(DisplayChip);
+    expect(wrapper.find(".chip-label").exists()).toBe(false);
+  });
+
+  it("renders .chip-label when config.label is set", async () => {
+    const wrapper = await mountSuspended(DisplayChip, {
+      props: { config: { size: "12px", maskWidth: "4px", offset: "0px", angle: "90deg", label: "5" } },
+    });
+    expect(wrapper.find(".chip-label").exists()).toBe(true);
+    expect(wrapper.find(".chip-label").text()).toBe("5");
+  });
+
+  it.each([
+    ["A", "length-1"],
+    ["+2", "length-2"],
+    ["DND", "length-3"],
+  ])("applies length class for label '%s'", async (label, expectedClass) => {
+    const wrapper = await mountSuspended(DisplayChip, {
+      props: { config: { size: "12px", maskWidth: "4px", offset: "0px", angle: "90deg", label } },
+    });
+    expect(wrapper.find(".chip-label").classes()).toContain(expectedClass);
+  });
+
+  it("truncates label to 3 characters when label exceeds maximum length", async () => {
+    const warnSpy = vi.spyOn(console, "warn").mockImplementation(() => {});
+    const wrapper = await mountSuspended(DisplayChip, {
+      props: { config: { size: "12px", maskWidth: "4px", offset: "0px", angle: "90deg", label: "ABCD" } },
+    });
+    expect(wrapper.find(".chip-label").text()).toBe("ABC");
+    warnSpy.mockRestore();
+  });
+
+  it("emits a console warning when label exceeds 3 characters", async () => {
+    const warnSpy = vi.spyOn(console, "warn").mockImplementation(() => {});
+    await mountSuspended(DisplayChip, {
+      props: { config: { size: "12px", maskWidth: "4px", offset: "0px", angle: "90deg", label: "ABCD" } },
+    });
+    expect(warnSpy).toHaveBeenCalledWith(expect.stringContaining("exceeds maximum length of 3 characters"));
+    warnSpy.mockRestore();
+  });
+
+  // ─── Icon ─────────────────────────────────────────────────────────────────
+
+  it("does not render .chip-icon when config has no icon", async () => {
+    const wrapper = await mountSuspended(DisplayChip);
+    expect(wrapper.find(".chip-icon").exists()).toBe(false);
+  });
+
+  it("renders .chip-icon when config.icon is set", async () => {
+    const wrapper = await mountSuspended(DisplayChip, {
+      props: { config: { size: "12px", maskWidth: "4px", offset: "0px", angle: "90deg", icon: "mdi:check" } },
+    });
+    expect(wrapper.find(".chip-icon").exists()).toBe(true);
+  });
+
+  // ─── Slot ─────────────────────────────────────────────────────────────────
+
+  it("renders default slot content", async () => {
+    const wrapper = await mountSuspended(DisplayChip, {
+      slots: { default: "<div class='avatar'>SRC</div>" },
+    });
+    expect(wrapper.find(".avatar").exists()).toBe(true);
+    expect(wrapper.find(".avatar").text()).toBe("SRC");
+  });
+
+  // ─── styleClassPassthrough ────────────────────────────────────────────────
+
+  it("applies a single styleClassPassthrough string", async () => {
+    const wrapper = await mountSuspended(DisplayChip, {
+      props: { styleClassPassthrough: "online" },
+    });
+    expect(wrapper.classes()).toContain("online");
+  });
+
+  it("applies multiple styleClassPassthrough classes from an array", async () => {
+    const wrapper = await mountSuspended(DisplayChip, {
+      props: { styleClassPassthrough: ["online", "featured"] },
+    });
+    expect(wrapper.classes()).toContain("online");
+    expect(wrapper.classes()).toContain("featured");
+  });
+
+  it("updates classes when styleClassPassthrough prop changes", async () => {
+    const wrapper = await mountSuspended(DisplayChip, {
+      props: { styleClassPassthrough: ["online"] },
+    });
+    expect(wrapper.classes()).toContain("online");
+    await wrapper.setProps({ styleClassPassthrough: ["idle"] });
+    expect(wrapper.classes()).not.toContain("online");
+    expect(wrapper.classes()).toContain("idle");
+  });
+});

package/app/components/02.molecules/display-chip/tests/__snapshots__/DisplayChip.spec.ts.snap

@@ -0,0 +1,12 @@
+// Vitest Snapshot v1, https://vitest.dev/guide/snapshot.html
+
+exports[`DisplayChip > renders correct HTML structure (default) 1`] = `"<span class="display-chip-core circle" style="--chip-size: 12px; --chip-mask-width: 4px; --chip-offset: 0px; --chip-angle: 90deg;"><!--v-if--><!--v-if--></span>"`;
+
+exports[`DisplayChip > renders correct HTML structure (square + styleClassPassthrough) 1`] = `"<span class="display-chip-core square online" style="--chip-size: 12px; --chip-mask-width: 4px; --chip-offset: 0px; --chip-angle: 90deg;"><!--v-if--><!--v-if--></span>"`;
+
+exports[`DisplayChip > renders correct HTML structure (with icon) 1`] = `
+"<span class="display-chip-core circle" style="--chip-size: 12px; --chip-mask-width: 4px; --chip-offset: 0px; --chip-angle: 90deg;"><span class="iconify i-mdi:check chip-icon" aria-hidden="true"></span>
+<!--v-if--></span>"
+`;
+
+exports[`DisplayChip > renders correct HTML structure (with label) 1`] = `"<span class="display-chip-core circle" style="--chip-size: 12px; --chip-mask-width: 4px; --chip-offset: 0px; --chip-angle: 90deg;"><!--v-if--><span class="chip-label length-1">5</span></span>"`;

package/app/pages/ui/display-chip.vue

@@ -5,26 +5,71 @@
         <LayoutRow tag="div" variant="popout">
           <h1 class="page-heading-2">Display Chip</h1>
 
-          <form>
-            <div class="form-row">
-              <div class="form-col">
-                <label for="size">Size - {{ chipConfig.size }}</label>
-                <input @input="changeSize" id="size" type="range" min="1" max="24" :value="12" />
-              </div>
-              <div class="form-col">
-                <label for="maskWidth">Mask Width - {{ chipConfig.maskWidth }}</label>
-                <input @input="changeMaskWidth" id="maskWidth" type="range" min="0" max="12" :value="4" />
-              </div>
-              <div class="form-col">
-                <label for="offset">Offset - {{ chipConfig.offset }}</label>
-                <input @input="changeOffset" id="offset" type="range" min="-12" max="12" :value="2" />
-              </div>
-              <div class="form-col">
-                <label for="angle">Angle - {{ chipConfig.angle }}</label>
-                <input @input="changeAngle" id="angle" type="range" min="0" max="360" :value="45" />
+          <!-- ── QA Panel (dev only) ───────────────────────────────── -->
+          <div v-if="isDev" class="qa-panel">
+            <details class="qa-panel__details">
+              <summary class="qa-panel__summary">
+                <span class="qa-panel__title">QA — DisplayChip</span>
+                <code class="qa-panel__status">
+                  size:{{ qaSize }}px · mask:{{ qaMaskWidth }}px · offset:{{ qaOffset }}px · angle:{{ qaAngle }}deg
+                </code>
+              </summary>
+              <div class="qa-panel__body">
+
+                <div class="qa-panel__group">
+                  <span class="qa-panel__label">Size</span>
+                  <div class="qa-panel__chips">
+                    <button
+                      v-for="preset in sizePresets"
+                      :key="preset"
+                      class="qa-panel__chip"
+                      :class="{ 'is-active': qaSize === preset }"
+                      @click="qaSize = preset"
+                    >{{ preset }}px</button>
+                  </div>
+                </div>
+
+                <div class="qa-panel__group">
+                  <span class="qa-panel__label">Mask Width</span>
+                  <div class="qa-panel__chips">
+                    <button
+                      v-for="preset in maskWidthPresets"
+                      :key="preset"
+                      class="qa-panel__chip"
+                      :class="{ 'is-active': qaMaskWidth === preset }"
+                      @click="qaMaskWidth = preset"
+                    >{{ preset }}px</button>
+                  </div>
+                </div>
+
+                <div class="qa-panel__group">
+                  <span class="qa-panel__label">Offset</span>
+                  <div class="qa-panel__chips">
+                    <button
+                      v-for="preset in offsetPresets"
+                      :key="preset"
+                      class="qa-panel__chip"
+                      :class="{ 'is-active': qaOffset === preset }"
+                      @click="qaOffset = preset"
+                    >{{ preset }}px</button>
+                  </div>
+                </div>
+
+                <div class="qa-panel__group">
+                  <span class="qa-panel__label">Angle — {{ qaAngle }}deg</span>
+                  <input
+                    v-model.number="qaAngle"
+                    type="range"
+                    min="0"
+                    max="360"
+                    step="1"
+                    class="qa-panel__range"
+                  />
+                </div>
+
               </div>
-            </div>
-          </form>
+            </details>
+          </div>
 
           <section>
             <div class="dl">
@@ -106,6 +151,8 @@
 </template>
 
 <script setup lang="ts">
+import type { DisplayChipConfig } from "~/types/components";
+
 definePageMeta({
   layout: false,
 });
@@ -118,59 +165,148 @@ useHead({
   },
 });
 
-const chipConfig = reactive({
-  size: "12px",
-  maskWidth: "4px",
-  offset: "2px",
-  angle: "45deg",
-});
+// ── QA controls (dev only) ────────────────────────────────────────
+const isDev = import.meta.dev;
+
+const qaSize = ref(12);
+const qaMaskWidth = ref(4);
+const qaOffset = ref(2);
+const qaAngle = ref(45);
 
-const changeSize = (e: Event) => {
-  const target = e.target as HTMLInputElement;
-  chipConfig.size = `${target.value}px`;
-};
-
-const changeMaskWidth = (e: Event) => {
-  const target = e.target as HTMLInputElement;
-  chipConfig.maskWidth = `${target.value}px`;
-};
-
-const changeOffset = (e: Event) => {
-  const target = e.target as HTMLInputElement;
-  chipConfig.offset = `${target.value}px`;
-};
-
-const changeAngle = (e: Event) => {
-  const target = e.target as HTMLInputElement;
-  chipConfig.angle = `${target.value}deg`;
-};
+const sizePresets = [8, 10, 12, 16, 20, 24];
+const maskWidthPresets = [0, 2, 4, 6, 8];
+const offsetPresets = [-4, 0, 2, 4, 8];
+
+const chipConfig = computed((): DisplayChipConfig => ({
+  size: `${qaSize.value}px`,
+  maskWidth: `${qaMaskWidth.value}px`,
+  offset: `${qaOffset.value}px`,
+  angle: `${qaAngle.value}deg`,
+}));
 </script>
 
 <style lang="css">
 .ui-display-chip-page {
-  form {
-    margin-bottom: 2rem;
-
-    .form-row {
-      .form-col {
-        display: grid;
-        grid-template-columns: 200px 200px;
-        gap: 1rem;
-        padding: 0.5rem 0;
-
-        label {
-          font-weight: bold;
-        }
+  /* ── QA Panel ──────────────────────────────────────────────────── */
 
-        input {
-          padding: 0.5rem;
-          border: 1px solid var(--slate-07);
-          border-radius: 4px;
-          font-size: 1rem;
-        }
-      }
+  .qa-panel {
+    background: oklch(15% 0 0);
+    color: white;
+    font-size: 1.3rem;
+  }
+
+  .qa-panel__details {
+    padding: 1rem 2rem;
+  }
+
+  .qa-panel__summary {
+    cursor: pointer;
+    display: flex;
+    align-items: center;
+    gap: 1.6rem;
+    list-style: none;
+    user-select: none;
+
+    &::-webkit-details-marker { display: none; }
+  }
+
+  .qa-panel__title {
+    font-weight: 600;
+    font-size: 1.1rem;
+    text-transform: uppercase;
+    letter-spacing: 0.08em;
+  }
+
+  .qa-panel__status {
+    font-family: monospace;
+    font-size: 1.2rem;
+    background: oklch(0% 0 0 / 0.3);
+    padding: 0.2rem 0.8rem;
+    border-radius: 0.4rem;
+    user-select: text;
+    cursor: text;
+  }
+
+  .qa-panel__body {
+    display: flex;
+    flex-wrap: wrap;
+    gap: 2.4rem;
+    padding-block: 1.2rem 0.4rem;
+  }
+
+  .qa-panel__group {
+    display: flex;
+    flex-direction: column;
+    gap: 0.6rem;
+  }
+
+  .qa-panel__label {
+    font-size: 1.1rem;
+    text-transform: uppercase;
+    letter-spacing: 0.08em;
+    opacity: 0.55;
+  }
+
+  .qa-panel__chips {
+    display: flex;
+    flex-wrap: wrap;
+    gap: 0.4rem;
+  }
+
+  .qa-panel__chip {
+    font-family: monospace;
+    font-size: 1.2rem;
+    color: white;
+    background: oklch(0% 0 0 / 0.25);
+    border: 1px solid oklch(100% 0 0 / 0.18);
+    padding: 0.3rem 1rem;
+    border-radius: 0.4rem;
+    cursor: pointer;
+    transition: background 0.15s;
+
+    &:hover { background: oklch(0% 0 0 / 0.4); }
+
+    &.is-active {
+      background: oklch(55% 0.18 240);
+      border-color: oklch(55% 0.18 240);
+    }
+  }
+
+  .qa-panel__range {
+    appearance: none;
+    width: 18rem;
+    height: 0.4rem;
+    background: oklch(100% 0 0 / 0.18);
+    border-radius: 0.4rem;
+    outline: none;
+    cursor: pointer;
+
+    &::-webkit-slider-thumb {
+      appearance: none;
+      width: 1.4rem;
+      height: 1.4rem;
+      border-radius: 50%;
+      background: oklch(55% 0.18 240);
+      cursor: pointer;
+      transition: background 0.15s;
+    }
+
+    &::-moz-range-thumb {
+      width: 1.4rem;
+      height: 1.4rem;
+      border: none;
+      border-radius: 50%;
+      background: oklch(55% 0.18 240);
+      cursor: pointer;
+      transition: background 0.15s;
     }
+
+    &:hover::-webkit-slider-thumb { background: oklch(62% 0.18 240); }
+    &:hover::-moz-range-thumb { background: oklch(62% 0.18 240); }
   }
+
+  /* ── Demo grid ─────────────────────────────────────────────────── */
+
   section {
     margin-top: 2rem;
 
@@ -181,11 +317,10 @@ const changeAngle = (e: Event) => {
       align-items: center;
       justify-content: start;
 
-      /* background-color: var(--slate-05); */
-
       .dt {
         font-weight: bold;
       }
+
       .dd {
         margin: 0;
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "srcdev-nuxt-components",
   "type": "module",
-  "version": "9.1.43",
+  "version": "9.1.44",
   "main": "nuxt.config.ts",
   "types": "types.d.ts",
   "license": "MIT",

package/app/components/display-avatar/DisplayAvatar.vue

@@ -1,148 +0,0 @@
-<template>
-  <component
-    :is="props.chip ? DisplayChip : as"
-    v-bind="props.chip ? (typeof props.chip === 'object' ? { config: props.chip } : { config: chipDefaultConfig }) : {}"
-    class="display-avatar"
-    :class="[size, elementClasses]"
-    :style-class-passthrough="elementClasses"
-  >
-    <slot name="default">
-      <NuxtImg v-if="src" :src :alt="alt || 'Avatar'" width="100%" height="100%" class="avatar-image" />
-      <span v-else>{{ fallback }}</span>
-    </slot>
-    <slot name="icon"></slot>
-  </component>
-</template>
-
-<script setup lang="ts">
-import DisplayChip from "../display-chip/DisplayChip.vue";
-import type { DisplayChipProps } from "../../types/components";
-
-export interface AvatarSlots {
-  default(props?: {}): any;
-  icon(props?: {}): any;
-}
-
-const props = defineProps({
-  as: {
-    type: [String, Object] as PropType<any>,
-    default: "span",
-  },
-  src: {
-    type: String,
-    default: undefined,
-  },
-  alt: {
-    type: String,
-    default: undefined,
-  },
-  text: {
-    type: String,
-    default: undefined,
-  },
-  size: {
-    type: String as PropType<"xs" | "s" | "md" | "lg" | "xl" | string>,
-    default: "md",
-  },
-  chip: {
-    type: [Boolean, Object] as PropType<boolean | DisplayChipProps>,
-    default: undefined,
-  },
-  class: {
-    type: [String, Array, Object] as PropType<any>,
-    default: undefined,
-  },
-  style: {
-    type: [String, Array, Object] as PropType<any>,
-    default: undefined,
-  },
-  styleClassPassthrough: {
-    type: [String, Array] as PropType<string | string[]>,
-    default: () => [],
-  },
-});
-
-defineSlots<AvatarSlots>();
-
-const { elementClasses, resetElementClasses, updateElementClasses } = useStyleClassPassthrough(
-  props.styleClassPassthrough
-);
-
-if (props.chip && typeof props.chip === "object" && !("styleClassPassthrough" in props.chip)) {
-  updateElementClasses(["display-avatar", props.size]);
-}
-
-const fallback = computed(
-  () =>
-    props.text ||
-    (props.alt || "")
-      .split(" ")
-      .map((word) => word.charAt(0))
-      .join("")
-      .substring(0, 2)
-);
-
-const chipDefaultConfig = {
-  size: "12px",
-  maskWidth: "4px",
-  offset: "0px",
-  angle: "90deg",
-};
-
-watch(
-  () => props.styleClassPassthrough,
-  () => {
-    resetElementClasses(props.styleClassPassthrough);
-  }
-);
-</script>
-
-<style lang="css">
-@layer components {
-.display-avatar {
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  border-radius: 50%;
-  color: var(--slate-03);
-
-  isolation: isolate;
-
-  &.xs {
-    width: 24px;
-    height: 24px;
-    font-size: 0.75rem;
-  }
-  &.s {
-    width: 32px;
-    height: 32px;
-    font-size: 0.875rem;
-  }
-  &.md {
-    width: 40px;
-    height: 40px;
-    font-size: 1rem;
-  }
-  &.lg {
-    width: 48px;
-    height: 48px;
-    font-size: 1.125rem;
-  }
-  &.xl {
-    width: 56px;
-    height: 56px;
-    font-size: 1.25rem;
-  }
-
-  .avatar-image {
-    width: 100%;
-    border-radius: 50%;
-    object-fit: cover;
-  }
-
-  .avatar-icon {
-    font-size: 24px;
-  }
-}
-}
-</style>