@wix/agent-skills 1.7.0 → 1.8.0

package/skills/wix-headless/references/astro/templates/bookings/components-bookings.css

@@ -0,0 +1,413 @@
+/* src/styles/components-bookings.css
+ *
+ * Bookings-pack component CSS. Pre-copied by the orchestrator at Step 4.5
+ * before Phase 3 Components dispatches. Do NOT write or modify this file
+ * from a Phase 3 or Phase 4 subagent — it is already on disk.
+ *
+ * This file is the SINGLE source of truth for bookings-component classes.
+ * The designer's global.css does NOT publish .service-card, .service-grid,
+ * .availability-calendar, .time-slot, or .booking-form — those all live
+ * here. See references/shared/STYLING.md § "Component-specific CSS is
+ * owned by the component, not the designer".
+ *
+ * Class groups in this file:
+ * - .service-card / .service-grid / .service-card-* → ServiceCard.astro,
+ *   services/index.astro, index.astro home teaser
+ * - .availability-calendar / .time-slot / .time-slot-* / .availability-*
+ *   → AvailabilityCalendar.tsx date picker + slot grid
+ * - .booking-form / .booking-field / .booking-* → BookingForm.tsx
+ *   details form + submit button
+ *
+ * Rules use direct CSS (`var(--token)`) only — no `@apply`. Tailwind v4
+ * `@apply` in a non-entrypoint file only resolves utilities whose theme keys
+ * the designer's `@theme` block declares. Direct `var(--color-ink)` /
+ * `var(--spacing-sm)` calls work against any designer-published token set as
+ * long as the core scales exist (they always do). Use fallback chains
+ * (`var(--color-paper-warm, var(--color-paper, var(--color-cream)))`) for
+ * sometimes-published tokens.
+ */
+
+/* =========================================================================
+   Service grid + card — owned here, NOT in global.css.
+   .service-card uses overflow: hidden + border-radius, so inner padding
+   is the responsibility of THIS file (whoever sets the radius owns the
+   inset). The image is clipped by the card's overflow; content needs
+   padding-inline so text doesn't sit flush against the rounded edge.
+   ========================================================================= */
+.service-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(300px, 1fr));
+  gap: var(--spacing-xl);
+  transition: opacity 200ms ease;
+}
+body[data-navigating="true"] .service-grid {
+  opacity: 0.55;
+  pointer-events: none;
+}
+
+.service-card {
+  position: relative;
+  display: flex;
+  flex-direction: column;
+  background: var(--color-paper, var(--color-cream));
+  border-radius: var(--radius-xl);
+  overflow: hidden;
+  text-decoration: none;
+  color: inherit;
+  transition: transform 280ms ease, box-shadow 280ms ease;
+  box-shadow: var(--shadow-card, 0 4px 16px -8px rgba(0, 0, 0, 0.15));
+}
+.service-card:hover {
+  transform: translateY(-4px);
+}
+.service-card:hover .service-card-image img {
+  transform: scale(1.04);
+}
+
+.service-card-image {
+  aspect-ratio: 3 / 2;
+  overflow: hidden;
+  background: var(--color-paper-warm, var(--color-surface-secondary, var(--color-cream)));
+}
+.service-card-image img {
+  width: 100%;
+  height: 100%;
+  object-fit: cover;
+  transition: transform 600ms ease;
+}
+.service-card-image--placeholder {
+  /* fallback when no image is provided */
+}
+
+.service-card-meta {
+  display: flex;
+  flex-direction: column;
+  gap: var(--spacing-xs);
+  padding: var(--spacing-md) var(--spacing-md) var(--spacing-lg);
+  flex: 1;
+}
+
+.service-card-name {
+  margin: 0;
+  font-family: var(--font-display);
+  font-size: 1.125rem;
+  line-height: 1.25;
+  color: var(--color-ink);
+}
+
+.service-card-tagline {
+  margin: 0;
+  font-family: var(--font-body);
+  font-size: 0.875rem;
+  color: var(--color-ink-soft, var(--color-mute));
+  line-height: 1.45;
+}
+
+.service-card-price {
+  display: flex;
+  align-items: center;
+  gap: var(--spacing-sm);
+  margin-top: auto;
+  padding-top: var(--spacing-sm);
+  font-family: var(--font-body);
+  font-size: 0.875rem;
+  color: var(--color-mute);
+}
+.service-card-price span + span::before {
+  content: "·";
+  padding-right: var(--spacing-sm);
+  color: var(--color-rule);
+}
+
+/* =========================================================================
+   Availability calendar — date navigator + slot grid.
+   Owned here, NOT in global.css.
+   ========================================================================= */
+.availability-calendar {
+  display: flex;
+  flex-direction: column;
+  gap: var(--spacing-lg);
+}
+
+.availability-date-nav {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: var(--spacing-md);
+  padding: var(--spacing-sm) 0;
+  border-bottom: 1px solid var(--color-rule);
+}
+
+.availability-date-label {
+  font-family: var(--font-display);
+  font-size: 1rem;
+  color: var(--color-ink);
+  flex: 1;
+  text-align: center;
+}
+
+.availability-nav-btn {
+  padding: var(--spacing-sm) var(--spacing-md);
+  background: transparent;
+  border: 1px solid var(--color-rule);
+  border-radius: var(--radius-sm);
+  color: var(--color-ink);
+  font-family: var(--font-body);
+  font-size: 0.875rem;
+  cursor: pointer;
+  transition: background-color 150ms ease, border-color 150ms ease;
+}
+.availability-nav-btn:hover:not(:disabled) {
+  background: var(--color-paper-warm, var(--color-cream));
+  border-color: var(--color-ink);
+}
+.availability-nav-btn:disabled {
+  opacity: 0.35;
+  cursor: not-allowed;
+}
+
+.availability-slots {
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(100px, 1fr));
+  gap: var(--spacing-sm);
+}
+
+.availability-loading,
+.availability-empty,
+.availability-error {
+  font-family: var(--font-body);
+  font-size: 0.9375rem;
+  color: var(--color-ink-soft, var(--color-mute));
+  padding: var(--spacing-lg) 0;
+  text-align: center;
+}
+.availability-error {
+  color: var(--color-error, var(--color-accent));
+}
+
+/* =========================================================================
+   Time slot buttons — individual slot items in the grid.
+   Three states: available (default), selected, unavailable.
+   ========================================================================= */
+.time-slot {
+  padding: var(--spacing-sm) var(--spacing-md);
+  border: 1px solid var(--color-rule);
+  border-radius: var(--radius-sm);
+  background: var(--color-paper, var(--color-cream));
+  color: var(--color-ink);
+  font-family: var(--font-body);
+  font-size: 0.875rem;
+  text-align: center;
+  cursor: pointer;
+  transition: background-color 150ms ease, border-color 150ms ease, color 150ms ease;
+}
+.time-slot--available {
+  border-color: var(--color-ink);
+}
+.time-slot--available:hover {
+  background: var(--color-ink);
+  color: var(--color-paper);
+}
+.time-slot--selected {
+  background: var(--color-ink);
+  color: var(--color-paper);
+  border-color: var(--color-ink);
+  font-weight: 600;
+}
+.time-slot--unavailable {
+  opacity: 0.3;
+  cursor: not-allowed;
+  border-color: var(--color-rule);
+}
+
+/* =========================================================================
+   Booking form — rendered after a slot is selected.
+   Owned here, NOT in global.css.
+   ========================================================================= */
+.booking-form {
+  display: flex;
+  flex-direction: column;
+  gap: var(--spacing-lg);
+  padding: var(--spacing-xl);
+  border: 1px solid var(--color-rule);
+  border-radius: var(--radius-md);
+  background: var(--color-paper-warm, var(--color-paper, var(--color-cream)));
+}
+
+.booking-form-header {
+  display: flex;
+  flex-direction: column;
+  gap: var(--spacing-xs);
+}
+.booking-form-title {
+  font-family: var(--font-display);
+  font-size: 1.25rem;
+  color: var(--color-ink);
+  margin: 0;
+}
+.booking-form-subtitle {
+  font-family: var(--font-body);
+  font-size: 0.875rem;
+  color: var(--color-ink-soft, var(--color-mute));
+  margin: 0;
+}
+
+.booking-field {
+  display: flex;
+  flex-direction: column;
+  gap: var(--spacing-xs);
+}
+.booking-field-row {
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  gap: var(--spacing-md);
+}
+@media (max-width: 480px) {
+  .booking-field-row {
+    grid-template-columns: 1fr;
+  }
+}
+
+.booking-label {
+  font-family: var(--font-display);
+  font-size: 0.75rem;
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+  color: var(--color-ink-soft, var(--color-mute));
+}
+.booking-label--required::after {
+  content: " *";
+  color: var(--color-accent);
+}
+
+.booking-input,
+.booking-textarea {
+  width: 100%;
+  padding: var(--spacing-sm) var(--spacing-md);
+  font-family: var(--font-body);
+  font-size: 0.9375rem;
+  border: 1px solid var(--color-rule);
+  border-radius: var(--radius-sm);
+  background: var(--color-paper, var(--color-cream));
+  color: var(--color-ink);
+  transition: border-color 150ms ease;
+  box-sizing: border-box;
+}
+.booking-input:focus,
+.booking-textarea:focus {
+  outline: none;
+  border-color: var(--color-ink);
+}
+.booking-textarea {
+  resize: vertical;
+  min-height: 6rem;
+}
+
+.booking-submit {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  padding: var(--spacing-md) var(--spacing-xl);
+  font-family: var(--font-display);
+  font-size: 0.9375rem;
+  font-weight: 500;
+  background: var(--color-ink);
+  color: var(--color-paper);
+  border: 1px solid var(--color-ink);
+  border-radius: var(--radius-sm);
+  cursor: pointer;
+  width: 100%;
+  margin-top: var(--spacing-sm);
+  transition: background-color 150ms ease, box-shadow 150ms ease;
+}
+.booking-submit:hover:not(:disabled) {
+  background: var(--color-ink-soft, var(--color-ink));
+}
+.booking-submit:disabled {
+  opacity: 0.5;
+  cursor: not-allowed;
+}
+
+.booking-cancel {
+  display: block;
+  text-align: center;
+  font-family: var(--font-body);
+  font-size: 0.875rem;
+  color: var(--color-mute);
+  cursor: pointer;
+  background: none;
+  border: none;
+  text-decoration: underline;
+  padding: 0;
+  margin-top: var(--spacing-xs);
+}
+.booking-cancel:hover {
+  color: var(--color-ink);
+}
+
+.booking-error {
+  font-family: var(--font-body);
+  font-size: 0.875rem;
+  color: var(--color-error, var(--color-accent));
+  padding: var(--spacing-sm) var(--spacing-md);
+  border: 1px solid var(--color-error, var(--color-accent));
+  border-radius: var(--radius-sm);
+  background: rgba(255, 0, 0, 0.04);
+}
+
+/* ── Slot capacity (CLASS) + full→waitlist ─────────────────────────────────── */
+.time-slot {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 2px;
+  line-height: 1.2;
+}
+.time-slot-time {
+  font-weight: 500;
+}
+.time-slot-capacity {
+  font-size: 0.7rem;
+  letter-spacing: 0.04em;
+  text-transform: uppercase;
+  color: var(--color-mute, var(--color-secondary));
+}
+.time-slot--full {
+  opacity: 0.85;
+  border-style: dashed;
+}
+.time-slot--full .time-slot-capacity {
+  color: var(--color-accent);
+}
+.booking-form-note {
+  font-family: var(--font-body);
+  font-size: 0.875rem;
+  color: var(--color-mute, var(--color-secondary));
+  margin-top: var(--spacing-xs);
+}
+
+/* ── Manage booking page ─────────────────────────────────────────────────────── */
+.manage-booking {
+  display: flex;
+  flex-direction: column;
+  gap: var(--spacing-lg);
+  align-items: flex-start;
+}
+.manage-booking-summary,
+.manage-booking-status {
+  font-family: var(--font-body);
+  font-size: 1.05rem;
+  color: var(--color-ink, var(--color-primary));
+}
+.manage-booking-note {
+  font-family: var(--font-body);
+  font-size: 0.875rem;
+  color: var(--color-mute, var(--color-secondary));
+}
+.manage-booking-link {
+  color: var(--color-ink, var(--color-primary));
+  text-decoration: underline;
+}
+.manage-booking-link:hover {
+  color: var(--color-accent);
+}

package/skills/wix-headless/references/astro/templates/bookings/manage-booking.astro

@@ -0,0 +1,76 @@
+---
+// src/pages/manage-booking.astro — per-booking manage page (view + cancel).
+// Reached from the confirmation page or a shared manage link:
+//   /manage-booking?bookingId=<id>&service=<name>
+//
+// A visitor token can't list/cancel bookings (queryExtendedBookings/cancelBooking
+// are APP/MEMBER identity). The supported visitor path is the ANONYMOUS ACTION
+// TOKEN: the server elevates (app identity) to mint a per-booking token, then the
+// no-auth bookingsGet/CancelBookingAnonymously methods act on it. Minting MUST be
+// server-side; the token is then safe to hand to the browser island.
+import Layout from "../layouts/Layout.astro";
+import ManageBooking from "../components/ManageBooking";
+import { auth } from "@wix/essentials";
+import { bookings } from "@wix/bookings";
+
+const bookingId = Astro.url.searchParams.get("bookingId");
+
+let token: string | null = null;
+let booking: any = null;
+let allowed = { cancel: false, reschedule: false };
+let error: string | null = null;
+
+if (!bookingId) {
+  error = "No booking was specified.";
+} else {
+  try {
+    const tokenRes = await auth.elevate(bookings.getAnonymousActionToken)(bookingId); // APP identity → elevate
+    token = tokenRes.token ?? null;
+    if (token) {
+      const res = await bookings.bookingsGetBookingAnonymously(token); // no auth
+      booking = res.booking ?? null;
+      allowed = {
+        cancel: !!res.allowedAnonymousActions?.cancel,
+        reschedule: !!res.allowedAnonymousActions?.reschedule,
+      };
+    }
+  } catch (err) {
+    console.error("[manage-booking] load failed:", err);
+    error = "We couldn't load this booking — the link may have expired.";
+  }
+}
+
+const serviceName =
+  booking?.bookedEntity?.title ?? Astro.url.searchParams.get("service") ?? "your booking";
+const startDate =
+  (booking?.startDate as string | undefined) ??
+  booking?.bookedEntity?.slot?.startDate ??
+  Astro.url.searchParams.get("startDate") ??
+  null;
+const status = (booking?.status as string | undefined) ?? null;
+const revision = (booking?.revision as string | undefined) ?? "";
+---
+
+<Layout title="Manage your booking">
+  <section class="container-reading px-lg py-4xl">
+    <a href="/services" class="inline-block text-sm text-mute hover:text-ink mb-xl">← All services</a>
+    <hr class="editorial-rule w-16 ml-0" />
+    <h1 class="font-display text-4xl md:text-5xl leading-tight mb-xl">Manage your booking</h1>
+
+    {
+      error ? (
+        <p class="booking-error">{error}</p>
+      ) : (
+        <ManageBooking
+          token={token}
+          revision={revision}
+          serviceName={serviceName}
+          startDate={startDate}
+          status={status}
+          canCancel={allowed.cancel}
+          client:only="react"
+        />
+      )
+    }
+  </section>
+</Layout>

package/skills/wix-headless/references/astro/templates/bookings/services/[slug].astro

@@ -0,0 +1,81 @@
+---
+// src/pages/services/[slug].astro — SSR service detail + client-side booking flow.
+// Two dirs deep inside src/ → import with ../../ (not three ../).
+import Layout from "../../layouts/Layout.astro";
+import SeoTags from "../../components/SeoTags.astro";
+import ServiceBookingFlow from "../../components/ServiceBookingFlow";
+import { services } from "@wix/bookings";
+import { auth } from "@wix/essentials";
+
+const { slug } = Astro.params;
+
+let service: any = null;
+try {
+  // Ambient SSR via @wix/essentials; query BUILDER (object form returns 0).
+  // Fetch the small catalog and match the slug in JS (robust without a
+  // nested-field `mainSlug.name` builder filter).
+  const result = await auth.elevate(services.queryServices)().limit(100).find();
+  service =
+    (result.items ?? []).find(
+      (s: any) => (s.mainSlug?.name ?? s.supportedSlugs?.[0]?.name) === slug,
+    ) ?? null;
+} catch (err) {
+  console.error(`[services/${slug}] detail query failed:`, err);
+}
+
+if (!service) return Astro.redirect("/services", 302);
+
+const formatPrice = (p: any): string | undefined => {
+  if (!p || p.rateType === "NO_FEE") return undefined;
+  if (p.rateType === "FIXED" && p.fixed?.price) {
+    const { value, currency } = p.fixed.price;
+    if (!value) return undefined;
+    return new Intl.NumberFormat("en-US", { style: "currency", currency: currency ?? "USD" }).format(Number(value));
+  }
+  return undefined;
+};
+const price = formatPrice(service.payment);
+const duration = service.schedule?.availabilityConstraints?.sessionDurations?.[0] ?? 60;
+const imageUrl = service.media?.mainMedia?.image?.url ?? service.media?.items?.[0]?.image?.url;
+const serviceName = service.name ?? "Service";
+const seoTags = service.seoData?.tags ?? [];
+---
+
+<!--
+  Width: use `container-reading` (max-width: var(--container-prose) + auto margins),
+  NOT a bare `max-w-<size>` — in this Tailwind v4 setup an un-emitted max-w-<size>
+  key falls back to the spacing scale (e.g. max-w-4xl → ~7rem, one word per line).
+-->
+<Layout title={serviceName} description={service.tagLine ?? service.description}>
+  <SeoTags tags={seoTags} slot="head" />
+  <section class="container-reading px-lg py-4xl">
+    <a href="/services" class="inline-block text-sm text-mute hover:text-ink mb-xl">← All services</a>
+
+    <!-- Optional banner image — only when the service has media (image-less is the
+         common seed case; rendering a fixed placeholder collapses the layout). -->
+    {imageUrl && (
+      <img src={imageUrl} alt={serviceName} class="w-full h-64 object-cover rounded-lg mb-xl" />
+    )}
+
+    <div class="flex flex-col gap-md mb-3xl">
+      <hr class="editorial-rule w-16 ml-0" />
+      <h1 class="font-display text-4xl md:text-5xl leading-tight">{serviceName}</h1>
+      {service.tagLine && <p class="text-lg text-mute leading-relaxed max-w-prose">{service.tagLine}</p>}
+      <div class="flex items-center gap-md text-sm text-mute">
+        <span>{duration} min</span>
+        {price && <span class="text-ink font-medium">{price}</span>}
+      </div>
+      {service.description && <p class="text-ink leading-relaxed max-w-prose">{service.description}</p>}
+    </div>
+
+    <section class="border-t border-rule pt-2xl">
+      <h2 class="font-display text-3xl leading-tight mb-xl">Book this service</h2>
+      <ServiceBookingFlow
+        serviceId={service._id}
+        serviceName={serviceName}
+        serviceType={service.type ?? "APPOINTMENT"}
+        client:only="react"
+      />
+    </section>
+  </section>
+</Layout>

package/skills/wix-headless/references/astro/templates/bookings/services/index.astro

@@ -0,0 +1,65 @@
+---
+// src/pages/services/index.astro — SSR services listing grid (APPOINTMENT or CLASS).
+// One dir deep inside src/pages → ../../ reaches src/. Adapt copy/headings to the
+// brand; keep the SSR data wiring.
+import Layout from "../../layouts/Layout.astro";
+import ServiceCard from "../../components/ServiceCard.astro";
+import { services } from "@wix/bookings";
+import { auth } from "@wix/essentials";
+
+let serviceList: any[] = [];
+try {
+  // Ambient @wix/astro SSR client via @wix/essentials (same pattern as CMS pages).
+  // Do NOT build createClient({ auth: OAuthStrategy({ clientId: import.meta.env.* }) }) —
+  // that env var is client-only and undefined at server render → 500.
+  // queryServices uses the query BUILDER; the object form returns 0 items.
+  const result = await auth.elevate(services.queryServices)().limit(100).find();
+  serviceList = (result.items ?? []).filter((s: any) => !s.hidden);
+} catch (err) {
+  console.error("[services] listing query failed:", err);
+}
+
+const getSlug = (s: any): string => s.mainSlug?.name ?? s.supportedSlugs?.[0]?.name ?? s._id;
+const formatPrice = (s: any): string | undefined => {
+  const p = s.payment;
+  if (!p || p.rateType === "NO_FEE") return undefined;
+  if (p.rateType === "FIXED" && p.fixed?.price) {
+    const { value, currency } = p.fixed.price;
+    if (!value) return undefined;
+    return new Intl.NumberFormat("en-US", { style: "currency", currency: currency ?? "USD" }).format(Number(value));
+  }
+  return undefined;
+};
+const getDuration = (s: any): number => s.schedule?.availabilityConstraints?.sessionDurations?.[0] ?? 60;
+---
+
+<Layout title="Services">
+  <section class="max-w-6xl mx-auto px-lg py-4xl">
+    <header class="flex flex-col gap-md max-w-prose mb-3xl">
+      <hr class="editorial-rule w-16 ml-0" />
+      <h1 class="font-display text-4xl md:text-5xl leading-tight">Our Services</h1>
+      <!-- Optional brand tagline -->
+    </header>
+
+    {
+      serviceList.length === 0 ? (
+        <p class="text-mute">Services coming soon — check back shortly.</p>
+      ) : (
+        <div class="service-grid">
+          {serviceList.map((s) => (
+            <ServiceCard
+              id={s._id}
+              slug={getSlug(s)}
+              name={s.name ?? "Untitled"}
+              tagLine={s.tagLine ?? s.description}
+              durationMinutes={getDuration(s)}
+              price={formatPrice(s)}
+              imageUrl={s.media?.mainMedia?.image?.url ?? s.media?.items?.[0]?.image?.url}
+              type={s.type ?? "APPOINTMENT"}
+            />
+          ))}
+        </div>
+      )
+    }
+  </section>
+</Layout>

package/skills/wix-headless/references/astro/templates/global.css

@@ -1,7 +1,7 @@
 /* ── Composer skeleton: src/styles/global.css ──────────────────────────────
    The fixed bulk below is LITERAL — do not re-author it. Composer's only edit
    is to replace the {{theme}} block with the @theme palette derived from the
-   inlined designTokens (see COMPOSE.md § "1. global.css"). Everything outside
+   inlined designTokens (see compose.mjs). Everything outside
    {{theme}} references the stable token vocabulary via var(--token) / built-in
    utilities and is brand-agnostic; ship it byte-for-byte.
    ─────────────────────────────────────────────────────────────────────────── */
@@ -11,7 +11,7 @@
 @theme {
   /* {{theme}} — Composer substitutes the full palette here from designTokens:
      every --color-*, --font-*, --spacing-* (2xs..4xl), --container-*, and
-     --radius-* line. The required-token set (COMPOSE.md § "Token contract")
+     --radius-* line. The required-token set (enforced by compose.mjs)
      MUST all be present, or components render unstyled. Container scale is
      separate from spacing — never alias --container-3xl to --spacing-3xl. */
 }

package/skills/wix-headless/references/astro/templates/index.astro

@@ -1,6 +1,6 @@
 ---
 // ── Composer skeleton: src/pages/index.astro ──────────────────────────────────
-// Home shell. Substitutions (see COMPOSE.md § "6. index.astro"):
+// Home shell. Substitutions (see compose.mjs):
 //   {{shell.heroHeadline}}, {{shell.heroSub}} — brand-voice hero copy.
 //   {{shell.footerTagline}} is NOT used here.
 //   {{brand.name}} — used in the brand-story copy.