srcdev-nuxt-components 9.3.6 → 9.3.8

package/app/components/03.organisms/services/services-grids/stories/ServicesCardGrid.stories.ts

@@ -1,8 +1,23 @@
+import { computed } from "vue";
 import ServicesCardGrid from "../ServicesCardGrid.vue";
 import type { Meta, StoryObj } from "@nuxtjs/storybook";
 import type { Service } from "~/types/types.services";
 
-const meta: Meta<typeof ServicesCardGrid> = {
+type StoryArgs = {
+  tag?: "div" | "section" | "main";
+  eyebrowConfig?: { tag?: "p" | "div" | "span"; fontSize?: "large" | "medium" | "small" };
+  heroConfig?: {
+    tag?: "h1" | "h2" | "h3" | "h4" | "h5" | "h6";
+    fontSize?: "display" | "title" | "heading" | "subheading" | "label";
+  };
+  hrefBase?: string;
+  buttonTextPrefix?: string;
+  styleClassPassthrough?: string | string[];
+  /** Story-only — not a real ServicesCardGrid prop, see useStorySetup below. */
+  lineClamp?: number;
+};
+
+const meta: Meta<StoryArgs> = {
   title: "Organisms/Services/Services Card Grid",
   component: ServicesCardGrid,
   argTypes: {
@@ -31,6 +46,11 @@ const meta: Meta<typeof ServicesCardGrid> = {
       control: "object",
       description: "Additional CSS classes applied to the root element",
     },
+    lineClamp: {
+      control: { type: "number", min: 1, max: 10, step: 1 },
+      description:
+        "Story-only control — sets ServicesCard's --description-line-clamp custom property on the grid wrapper (not a real component prop) to demo description clamping across cards",
+    },
   },
   args: {
     tag: "div",
@@ -39,8 +59,15 @@ const meta: Meta<typeof ServicesCardGrid> = {
     hrefBase: "/services/",
     buttonTextPrefix: "Enquire about",
     styleClassPassthrough: [],
+    lineClamp: 3,
   },
   parameters: {
+    backgrounds: {
+      default: "storybook-canvas",
+      options: {
+        "storybook-canvas": { name: "Canvas", value: "oklch(0.163 0.005 17)" },
+      },
+    },
     docs: {
       description: {
         component:
@@ -51,7 +78,7 @@ const meta: Meta<typeof ServicesCardGrid> = {
 };
 
 export default meta;
-type Story = StoryObj<typeof ServicesCardGrid>;
+type Story = StoryObj<StoryArgs>;
 
 // ─── Fixtures ─────────────────────────────────────────────────────────────────
 
@@ -81,8 +108,79 @@ const sampleServices: Service[] = [
   makeService("colour-treatment", "Colour Treatment", "Add dimension and depth", "https://picsum.photos/seed/card-c/600/800"),
 ];
 
+const makeServiceWithDescription = (
+  slug: string,
+  title: string,
+  subtitle: string,
+  image: string,
+  shortDescription: string
+): Service => ({ ...makeService(slug, title, subtitle, image), shortDescription });
+
+// Six cards with progressively longer shortDescription text, to demo how the same
+// lineClamp value clips each card's description at a different point.
+const lineClampServices: Service[] = [
+  makeServiceWithDescription(
+    "one-liner",
+    "Fringe Trim",
+    "A quick refresh",
+    "https://picsum.photos/seed/clamp-1/600/800",
+    "A quick tidy-up."
+  ),
+  makeServiceWithDescription(
+    "short-desc",
+    "Blow Dry",
+    "Salon finish, fast",
+    "https://picsum.photos/seed/clamp-2/600/800",
+    "A smooth, voluminous blow dry finished with a light-hold spray for lasting body."
+  ),
+  makeServiceWithDescription(
+    "medium-desc",
+    "Balayage",
+    "Freehand colour artistry",
+    "https://picsum.photos/seed/clamp-3/600/800",
+    "Colour swept on by hand, bespoke to your hair's natural fall and texture. Creates soft, sun-kissed dimension that grows out gracefully with minimal upkeep."
+  ),
+  makeServiceWithDescription(
+    "long-desc",
+    "Locs Installation",
+    "Start your loc journey",
+    "https://picsum.photos/seed/clamp-4/600/800",
+    "Professional loc installation tailored to your hair type. We work with all textures and lengths to create beautiful, long-lasting locs, with a full consultation beforehand to agree size, style, and maintenance schedule."
+  ),
+  makeServiceWithDescription(
+    "very-long-desc",
+    "Keratin Treatment",
+    "Smooth, frizz-free hair",
+    "https://picsum.photos/seed/clamp-5/600/800",
+    "A deep-conditioning keratin treatment that smooths the hair cuticle, reduces frizz, and cuts down on daily styling time. Results typically last three to five months depending on hair type, porosity, and aftercare routine, and can be combined with a colour service for a full transformation."
+  ),
+  makeServiceWithDescription(
+    "extra-long-desc",
+    "Full Colour Correction",
+    "Rebuild from the roots",
+    "https://picsum.photos/seed/clamp-6/600/800",
+    "A multi-session colour correction service for hair that's had previous colour go wrong — box dye build-up, uneven tone, brassiness, or over-processed ends. We start with a full strand test and consultation, then work in stages to lift, tone, and rebuild condition safely, protecting hair integrity at every step rather than rushing to a single-visit result that risks further damage."
+  ),
+];
+
 // ─── Stories ──────────────────────────────────────────────────────────────────
 
+/**
+ * lineClamp is a story-only control (not a real ServicesCardGrid prop) that sets
+ * --description-line-clamp on the grid wrapper — the global custom property each
+ * ServicesCard's .description reads for its -webkit-line-clamp value.
+ */
+function useStorySetup(args: StoryArgs) {
+  const clampStyle = computed(() => ({
+    "--description-line-clamp": String(args.lineClamp ?? 3),
+  }));
+  const componentArgs = computed(() => {
+    const { lineClamp: _lineClamp, ...rest } = args;
+    return rest;
+  });
+  return { clampStyle, componentArgs };
+}
+
 export const Default: Story = {
   render: (args) => ({
     components: { ServicesCardGrid },
@@ -180,3 +278,29 @@ export const EmptyData: Story = {
     },
   },
 };
+
+export const DescriptionLineClamp: Story = {
+  name: "Description Line Clamp",
+  args: {
+    lineClamp: 3,
+  },
+  render: (args) => ({
+    components: { ServicesCardGrid },
+    setup() {
+      return { ...useStorySetup(args), lineClampServices };
+    },
+    template: `
+      <div :style="clampStyle">
+        <ServicesCardGrid v-bind="componentArgs" :services-data="lineClampServices" />
+      </div>
+    `,
+  }),
+  parameters: {
+    docs: {
+      description: {
+        story:
+          "Six cards with progressively longer shortDescription text, all sharing one --description-line-clamp value set via the lineClamp control. Use the control to see how the same clamp value affects a one-line description (no visible clamping) versus a long paragraph (clamped with an ellipsis) — card heights stay equal since the meta row and actions slot sit below the clamped description rather than growing with it.",
+      },
+    },
+  },
+};

package/app/components/03.organisms/services/services-grids/stories/ServicesSectionGrid.stories.ts

@@ -32,6 +32,12 @@ const meta: Meta<typeof ServicesSectionGrid> = {
     styleClassPassthrough: [],
   },
   parameters: {
+    backgrounds: {
+      default: "storybook-canvas",
+      options: {
+        "storybook-canvas": { name: "Canvas", value: "oklch(0.163 0.005 17)" },
+      },
+    },
     docs: {
       description: {
         component:

package/app/components/03.organisms/services/services-grids/tests/__snapshots__/ServicesCardGrid.spec.ts.snap

@@ -4,39 +4,63 @@ exports[`ServicesCardGrid > renders correct HTML structure 1`] = `
 "<div class="services-card-grid">
   <div class="services-card">
     <div class="image-wrapper"><img data-nuxt-img="" srcset="/_ipx/_/images/locs-installation.jpg 1x, /_ipx/_/images/locs-installation.jpg 2x" alt="Locs Installation" loading="lazy" class="image" src="/_ipx/_/images/locs-installation.jpg"></div>
-    <div class="eyebrow-text large">Subtitle for Locs Installation</div>
-    <h2 class="hero-text heading axis-horizontal">
-      <!--v-if--><span class="text-block-0 normal">Locs Installation</span>
-    </h2>
-    <div class="description">Short description for Locs Installation.</div><a href="/ui/services/services-section/locs-installation" data-testid="input-button-core" data-theme="default" class="input-button-core secondary mbs-24 is-link">
-      <!--v-if-->
-      <!--v-if--><span class="button-text">Enquire about Locs Installation</span><span class="btn-icon right"><span class="iconify i-mdi:arrow-right icon" aria-hidden="true"></span></span>
-      <!--v-if-->
-    </a>
+    <div class="details-wrapper">
+      <div class="eyebrow-text large">Subtitle for Locs Installation</div>
+      <h2 class="hero-text heading axis-horizontal">
+        <!--v-if--><span class="text-block-0 normal">Locs Installation</span>
+      </h2>
+      <div class="description">Short description for Locs Installation.</div>
+      <div class="footer">
+        <div class="meta">
+          <div class="meta-duration">60 mins</div>
+          <div class="meta-price">£50</div>
+        </div><a href="/services/locs-installation" data-testid="input-button-core" data-theme="default" class="input-button-core secondary mbs-24 is-link">
+          <!--v-if-->
+          <!--v-if--><span class="button-text">Enquire about Locs Installation</span><span class="btn-icon right"><span class="iconify i-mdi:arrow-right icon" aria-hidden="true"></span></span>
+          <!--v-if-->
+        </a>
+      </div>
+    </div>
   </div>
   <div class="services-card">
     <div class="image-wrapper"><img data-nuxt-img="" srcset="/_ipx/_/images/locs-retwist.jpg 1x, /_ipx/_/images/locs-retwist.jpg 2x" alt="Locs Retwist" loading="lazy" class="image" src="/_ipx/_/images/locs-retwist.jpg"></div>
-    <div class="eyebrow-text large">Subtitle for Locs Retwist</div>
-    <h2 class="hero-text heading axis-horizontal">
-      <!--v-if--><span class="text-block-0 normal">Locs Retwist</span>
-    </h2>
-    <div class="description">Short description for Locs Retwist.</div><a href="/ui/services/services-section/locs-retwist" data-testid="input-button-core" data-theme="default" class="input-button-core secondary mbs-24 is-link">
-      <!--v-if-->
-      <!--v-if--><span class="button-text">Enquire about Locs Retwist</span><span class="btn-icon right"><span class="iconify i-mdi:arrow-right icon" aria-hidden="true"></span></span>
-      <!--v-if-->
-    </a>
+    <div class="details-wrapper">
+      <div class="eyebrow-text large">Subtitle for Locs Retwist</div>
+      <h2 class="hero-text heading axis-horizontal">
+        <!--v-if--><span class="text-block-0 normal">Locs Retwist</span>
+      </h2>
+      <div class="description">Short description for Locs Retwist.</div>
+      <div class="footer">
+        <div class="meta">
+          <div class="meta-duration">60 mins</div>
+          <div class="meta-price">£50</div>
+        </div><a href="/services/locs-retwist" data-testid="input-button-core" data-theme="default" class="input-button-core secondary mbs-24 is-link">
+          <!--v-if-->
+          <!--v-if--><span class="button-text">Enquire about Locs Retwist</span><span class="btn-icon right"><span class="iconify i-mdi:arrow-right icon" aria-hidden="true"></span></span>
+          <!--v-if-->
+        </a>
+      </div>
+    </div>
   </div>
   <div class="services-card">
     <div class="image-wrapper"><img data-nuxt-img="" srcset="/_ipx/_/images/colour-treatment.jpg 1x, /_ipx/_/images/colour-treatment.jpg 2x" alt="Colour Treatment" loading="lazy" class="image" src="/_ipx/_/images/colour-treatment.jpg"></div>
-    <div class="eyebrow-text large">Subtitle for Colour Treatment</div>
-    <h2 class="hero-text heading axis-horizontal">
-      <!--v-if--><span class="text-block-0 normal">Colour Treatment</span>
-    </h2>
-    <div class="description">Short description for Colour Treatment.</div><a href="/ui/services/services-section/colour-treatment" data-testid="input-button-core" data-theme="default" class="input-button-core secondary mbs-24 is-link">
-      <!--v-if-->
-      <!--v-if--><span class="button-text">Enquire about Colour Treatment</span><span class="btn-icon right"><span class="iconify i-mdi:arrow-right icon" aria-hidden="true"></span></span>
-      <!--v-if-->
-    </a>
+    <div class="details-wrapper">
+      <div class="eyebrow-text large">Subtitle for Colour Treatment</div>
+      <h2 class="hero-text heading axis-horizontal">
+        <!--v-if--><span class="text-block-0 normal">Colour Treatment</span>
+      </h2>
+      <div class="description">Short description for Colour Treatment.</div>
+      <div class="footer">
+        <div class="meta">
+          <div class="meta-duration">60 mins</div>
+          <div class="meta-price">£50</div>
+        </div><a href="/services/colour-treatment" data-testid="input-button-core" data-theme="default" class="input-button-core secondary mbs-24 is-link">
+          <!--v-if-->
+          <!--v-if--><span class="button-text">Enquire about Colour Treatment</span><span class="btn-icon right"><span class="iconify i-mdi:arrow-right icon" aria-hidden="true"></span></span>
+          <!--v-if-->
+        </a>
+      </div>
+    </div>
   </div>
 </div>"
 `;

package/app/components/03.organisms/services/services-section/ServicesSection.vue

@@ -318,6 +318,25 @@ watch(
               }
             }
           }
+
+          .accordian-item.expanding-panel-classic {
+            border-block-end: 1px solid var(--services-section-faq-divider-color, currentColor);
+            opacity: var(--services-section-faq-divider-opacity, 0.7);
+
+            &:first-child {
+              border-block-start: 1px solid var(--services-section-faq-divider-color, currentColor);
+            }
+
+            .expanding-panel-classic-details .expanding-panel-classic-summary {
+              padding-block: 1.2rem;
+            }
+
+            .expanding-panel-classic-content .inner {
+              .services-section__faq-answer {
+                line-height: var(--services-section-faq-answer-line-height, 1.6);
+              }
+            }
+          }
         }
       }
     }

package/app/components/03.organisms/services/services-section/tests/__snapshots__/ServicesSection.spec.ts.snap

@@ -61,18 +61,18 @@ exports[`ServicesSection > renders correct HTML structure 1`] = `
         <!--v-if--><span class="text-block-0 normal">Frequently Asked Questions</span>
       </h2>
       <div class="display-accordian services-section__faq" id="faq">
-        <div class="expanding-panel accordian-item" icon-size="medium">
-          <details class="expanding-panel-details" name="faq-v-0-0-0">
-            <summary id="id-faq-v-0-0-0-trigger" class="expanding-panel-summary" aria-controls="id-faq-v-0-0-0-content" aria-expanded="false">
+        <div class="expanding-panel-classic accordian-item" icon-size="medium">
+          <details class="expanding-panel-classic-details" name="faq-v-0-0-0">
+            <summary id="id-faq-v-0-0-0-trigger" class="expanding-panel-classic-summary" aria-controls="id-faq-v-0-0-0-content" aria-expanded="false">
               <div class="label-wrapper">FAQ question?</div>
               <div class="icon-wrapper"><span class="iconify i-mdi:chevron-down" aria-hidden="true"></span></div>
             </summary>
-            <div id="id-faq-v-0-0-0-content" class="expanding-panel-content" aria-labelledby="id-faq-v-0-0-0-trigger" role="region">
-              <div class="inner">
-                <p class="services-section__faq-answer">FAQ answer.</p>
-              </div>
-            </div>
           </details>
+          <div id="id-faq-v-0-0-0-content" class="expanding-panel-classic-content" aria-labelledby="id-faq-v-0-0-0-trigger" role="region">
+            <div class="inner">
+              <p class="services-section__faq-answer">FAQ answer.</p>
+            </div>
+          </div>
         </div>
       </div>
       <div class="glass-panel services-section__glass-panel p-24">

package/app/types/components/breadcrumb.ts

@@ -0,0 +1,4 @@
+export interface BreadcrumbItem {
+  label: string;
+  to?: string;
+}

package/app/types/components/index.ts

@@ -14,3 +14,4 @@ export * from "./hero-text"
 export * from "./navigation-horizontal.d"
 export * from "./social-icons-list.d"
 export * from "./content-docs.d"
+export * from "./breadcrumb"

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "srcdev-nuxt-components",
   "type": "module",
-  "version": "9.3.6",
+  "version": "9.3.8",
   "main": "nuxt.config.ts",
   "types": "types.d.ts",
   "license": "MIT",
@@ -16,7 +16,7 @@
     "cleaninstall": "npm run clean && npm run reinstall",
     "generate:ramps": "node scripts/generate-ramps.mjs",
     "check:ramps": "node scripts/check-ramps.mjs",
-    "dev": "npm run generate:ramps && SRCDEV_STANDALONE=true nuxt dev",
+    "dev": "npm run generate:ramps && SRCDEV_STANDALONE=true storybook dev -p 6006",
     "build": "npm run generate:ramps && SRCDEV_STANDALONE=true nuxt build",
     "generate": "npm run generate:ramps && SRCDEV_STANDALONE=true nuxt generate",
     "preview": "SRCDEV_STANDALONE=true nuxt preview",