npm - @wix/agent-skills - Versions diffs - 1.26.0 → 1.27.0 - Mend

@wix/agent-skills 1.26.0 → 1.27.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (805) hide show

package/skills/wix-headless-templates/donations/app-astro/layouts/SiteLayout.astro ADDED Viewed

@@ -0,0 +1,45 @@
+---
+// The site chrome for every donations page — THIS file (header/footer/nav) plus the @theme token
+// block in src/styles/global.css are what you brand. Keep the <slot name="seo-tags" /> in <head>
+// and the global.css import. (Deploy is fill-only: if another vertical is already deployed, its
+// SiteLayout won — merge a Donate nav link there instead.)
+import "../styles/global.css";
+interface Props {
+  title: string;
+  description?: string;
+  /** An absolute image URL for social previews (the campaign's cover). */
+  image?: string;
+}
+const { title, description, image } = Astro.props;
+---
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>{title}</title>
+    {description && <meta name="description" content={description} />}
+    <meta property="og:title" content={title} />
+    {description && <meta property="og:description" content={description} />}
+    {image && <meta property="og:image" content={image} />}
+    <slot name="seo-tags" />
+  </head>
+  <body>
+    <header class="sticky top-0 z-40 border-b border-border bg-background/80 backdrop-blur">
+      <div class="mx-auto flex h-16 max-w-6xl items-center justify-between px-6">
+        <a href="/" class="text-base font-bold tracking-tight text-foreground no-underline">Brand Name</a>
+        <nav class="flex items-center gap-6 text-sm">
+          <a href="/donate" class="text-foreground no-underline transition-colors hover:text-muted-foreground">Donate</a>
+        </nav>
+      </div>
+    </header>
+    <main class="mx-auto max-w-6xl px-6 pb-24 pt-10">
+      <slot />
+    </main>
+    <footer class="border-t border-border px-6 py-10 text-center text-sm text-muted-foreground">
+      © Brand Name
+    </footer>
+  </body>
+</html>

package/skills/wix-headless-templates/donations/app-astro/pages/donate/[id].astro ADDED Viewed

@@ -0,0 +1,28 @@
+---
+// Campaign page, keyed by the campaign id (the entity has no slug).
+//
+// Donations has no owner-editable SEO item type in @wix/seo, so this page carries plain
+// <title>/<meta>/og:image from the DTO — no wixMetadata, no <SEO.Tags>; campaign pages don't
+// appear in the Wix SEO panel or sitemap. A missing or archived campaign is a real 404.
+import SiteLayout from "../../layouts/SiteLayout.astro";
+import CampaignPage from "../../components/donations/CampaignPage.astro";
+import { fetchCampaign } from "../../wix/donations/campaigns";
+import type { CampaignDetail } from "../../wix/donations/types";
+const id = Astro.params.id!;
+let campaign: CampaignDetail | null = null;
+try {
+  campaign = await fetchCampaign(id);
+} catch {
+  // Guarded: an unhandled SSR throw truncates the response mid-stream.
+}
+if (!campaign) {
+  return new Response(null, { status: 404 });
+}
+---
+<SiteLayout title={campaign.name} image={campaign.imageUrl || undefined}>
+  <CampaignPage campaign={campaign} />
+</SiteLayout>

package/skills/wix-headless-templates/donations/app-astro/pages/donate/index.astro ADDED Viewed

@@ -0,0 +1,51 @@
+---
+// Donate — the campaigns, fetched SERVER-SIDE and rendered as cards; a site with exactly one
+// campaign renders that campaign's page here directly (the Wix widget's default-campaign rule).
+// Keep this frontmatter; the card markup is yours to redesign (GoalProgress is the shipped part).
+import SiteLayout from "../../layouts/SiteLayout.astro";
+import CampaignPage from "../../components/donations/CampaignPage.astro";
+import GoalProgress from "../../components/donations/GoalProgress";
+import { fetchCampaign, fetchCampaigns } from "../../wix/donations/campaigns";
+import type { CampaignDetail, CampaignSummary } from "../../wix/donations/types";
+let campaigns: CampaignSummary[] = [];
+let only: CampaignDetail | null = null;
+try {
+  campaigns = await fetchCampaigns();
+  if (campaigns.length === 1) only = await fetchCampaign(campaigns[0].id);
+} catch {
+  // An unguarded SSR throw truncates the response mid-stream; the page renders its empty state instead.
+}
+---
+<SiteLayout title={only ? only.name : "Donate"} image={only?.imageUrl || undefined}>
+  {only ? (
+    <CampaignPage campaign={only} />
+  ) : (
+    <>
+      <h1 class="mb-8 text-2xl font-semibold tracking-tight">Donate</h1>
+      {campaigns.length === 0 ? (
+        <p class="py-16 text-center text-muted-foreground">No campaigns yet — check back soon.</p>
+      ) : (
+        <div class="grid grid-cols-1 gap-6 sm:grid-cols-2 lg:grid-cols-3">
+          {campaigns.map((c) => (
+            <a href={`/donate/${c.id}`} class="flex h-full flex-col overflow-hidden rounded-lg border border-border bg-background no-underline transition-colors hover:bg-secondary">
+              {c.imageUrl && (
+                <div class="aspect-[16/9] bg-secondary">
+                  <img src={c.imageUrl} alt={c.name} loading="lazy" class="h-full w-full object-cover" />
+                </div>
+              )}
+              <div class="flex flex-1 flex-col gap-4 p-6">
+                <p class="text-base font-semibold text-foreground">{c.name}</p>
+                <GoalProgress goal={c.goal} compact />
+                <p class="mt-auto text-sm font-semibold text-foreground">
+                  {c.acceptsDonations ? "Donate" : c.status === "goalReached" ? "Goal reached" : "Ended"}
+                </p>
+              </div>
+            </a>
+          ))}
+        </div>
+      )}
+    </>
+  )}
+</SiteLayout>

package/skills/wix-headless-templates/donations/app-astro/pages/donate/thank-you.astro ADDED Viewed

@@ -0,0 +1,13 @@
+---
+// Post-checkout thank-you page — the Wix-hosted checkout redirects here with ?orderId= after a
+// completed donation. KEEP THIS ROUTE: the data layer's redirect callbacks point at
+// /donate/thank-you. No SSR fetch: the order read runs as the visitor in the browser, so the island
+// is client:only. Swap its import to YOUR thank-you component if you design one — keep its rules
+// (no order facts without the order; never "paid" unless the order says so).
+import SiteLayout from "../../layouts/SiteLayout.astro";
+import DonationReceipt from "../../components/donations/DonationReceipt";
+---
+<SiteLayout title="Thank you">
+  <DonationReceipt client:only="react" />
+</SiteLayout>

package/skills/wix-headless-templates/donations/project/README.md ADDED Viewed

@@ -0,0 +1,15 @@
+# Wix Astro Blank Template
+**[Live demo](https://h6s-1a31f9730cd85b-headlessstack.wix-site-host.com)**
+Our Astro templates are still in development and subject to change.
+To use a template, follow the [Wix CLI for Headless Quick Start](https://dev.wix.com/docs/go-headless/get-started/quick-starts/wix-managed-headless/quick-start-with-the-wix-cli), and select the desired template during the setup process.
+## Need help?
+For documentation and support, check out:
+- [Wix Headless Documentation](https://dev.wix.com/docs/go-headless)
+- [Wix SDK Documentation](https://dev.wix.com/docs/sdk)
+- [Community on Discord](https://discord.gg/n6TBrSnYTp)

package/skills/wix-headless-templates/donations/project/astro.config.mjs ADDED Viewed

@@ -0,0 +1,22 @@
+import tailwindcss from "@tailwindcss/vite";
+// @ts-check
+import { defineConfig } from 'astro/config';
+import wix from "@wix/astro";
+import wixPages from "@wix/astro-pages";
+import react from "@astrojs/react";
+import wixHostingAdapter from "@wix/astro-wix-hosting-adapter";
+// https://astro.build/config
+export default defineConfig({
+  vite: { plugins: [tailwindcss()] },
+  integrations: [wix(), wixPages(), react()],
+  security: { checkOrigin: false },
+  adapter: wixHostingAdapter(),
+  image: {
+    domains: ["static.wixstatic.com"],
+  },
+  output: "server",
+});