@wix/agent-skills 1.21.0 → 1.23.0

package/skills/wix-headless-fast/references/blog/app/wix/blog/blog-feed-store.ts

@@ -1,137 +0,0 @@
-// The blog feed as a framework-free store — the logic behind useBlogFeed, usable from React
-// (useBlogFeed wraps it with useSyncExternalStore), from a static page or Vue/Svelte (subscribe and
-// render), or as the specification for a port. State, actions, subscribe/getState, emit after every
-// change — the same shape as storefront's shop-store.
-//
-// Category and tag filters are applied by Wix (fetchPosts), never to a page already in hand; the
-// two are mutually exclusive — setting one clears the other. A changed filter starts a fresh cursor
-// chain; a late response from a superseded query is dropped. Paging appends by cursor.
-//
-// SSR-friendly: seed with `initialPage` (and `initialCategories`/`initialTags`) and the first,
-// unfiltered page renders at once with no client fetch; a SPA passes nothing and `start()` fetches.
-// One store per mounted feed (a page can hold a feed and a "latest posts" rail): createBlogFeedStore().
-import { fetchPosts } from "./posts";
-import { fetchBlogCategories, fetchBlogTags } from "./taxonomy";
-import type { BlogCategory, BlogTag, PostPage, PostSummary } from "./types";
-
-export interface BlogFeedStoreOptions {
-  initialPage?: PostPage;
-  initialCategories?: BlogCategory[];
-  initialTags?: BlogTag[];
-  pageSize?: number;
-}
-
-/** Everything a feed surface renders from. Read it with getState() or through a subscription. */
-export interface BlogFeedState {
-  /** null while the first load is in flight — render skeletons, not an empty state. */
-  posts: PostSummary[] | null;
-  categories: BlogCategory[];
-  tags: BlogTag[];
-  activeCategoryId: string | null;
-  activeTagId: string | null;
-  /** True when another page exists — render a "load more" control on it. */
-  hasMore: boolean;
-  loadingMore: boolean;
-  error: string | null;
-}
-
-export interface BlogFeedStore {
-  getState(): BlogFeedState;
-  subscribe(listener: () => void): () => void;
-  /** Fetch the taxonomy (unless seeded) and the first page (unless seeded and unfiltered). Call once when mounted. */
-  start(): void;
-  /** Stop reacting; drop late responses. */
-  stop(): void;
-  /** Server-side filter; clears the tag filter. */
-  setActiveCategoryId(id: string | null): void;
-  /** Server-side filter; clears the category filter. */
-  setActiveTagId(id: string | null): void;
-  loadMore(): Promise<void>;
-}
-
-export function createBlogFeedStore({ initialPage, initialCategories, initialTags, pageSize = 20 }: BlogFeedStoreOptions = {}): BlogFeedStore {
-  let posts: PostSummary[] | null = initialPage?.posts ?? null;
-  let cursor: string | null = initialPage?.nextCursor ?? null;
-  let categories: BlogCategory[] = initialCategories ?? [];
-  let tags: BlogTag[] = initialTags ?? [];
-  let activeCategoryId: string | null = null;
-  let activeTagId: string | null = null;
-  let loadingMore = false;
-  let error: string | null = null;
-  let started = false;
-  let generation = 0; // bumped by every filter change and stop(); a response from an older generation is dropped
-  const listeners = new Set<() => void>();
-  let snapshot: BlogFeedState | null = null;
-  const emit = () => { snapshot = null; for (const fn of listeners) fn(); };
-
-  function getState(): BlogFeedState {
-    if (snapshot) return snapshot;
-    snapshot = { posts, categories, tags, activeCategoryId, activeTagId, hasMore: cursor !== null, loadingMore, error };
-    return snapshot;
-  }
-
-  // The first page for the current filter. The unfiltered page may have come from the server —
-  // fetch only when it didn't, or when a filter is active (filters are server-side).
-  function query(): void {
-    if (!started) return;
-    const id = ++generation;
-    loadingMore = false;
-    if (activeCategoryId === null && activeTagId === null && initialPage) {
-      posts = initialPage.posts; cursor = initialPage.nextCursor; error = null;
-      emit();
-      return;
-    }
-    posts = null; cursor = null; error = null;
-    emit();
-    fetchPosts({ limit: pageSize, categoryId: activeCategoryId, tagId: activeTagId })
-      .then((page) => {
-        if (generation !== id) return; // superseded — drop it
-        posts = page.posts; cursor = page.nextCursor;
-        emit();
-      })
-      .catch((e) => {
-        if (generation !== id) return;
-        posts = []; cursor = null;
-        error = e instanceof Error ? e.message : String(e);
-        emit();
-      });
-  }
-
-  return {
-    getState,
-    subscribe(fn) { listeners.add(fn); return () => listeners.delete(fn); },
-    start() {
-      if (started) return;
-      started = true;
-      if (!initialCategories) fetchBlogCategories().then((c) => { if (started) { categories = c; emit(); } });
-      if (!initialTags) fetchBlogTags().then((t) => { if (started) { tags = t; emit(); } });
-      query();
-    },
-    stop() { started = false; generation++; },
-    setActiveCategoryId(id) {
-      if (id === activeCategoryId && activeTagId === null) return;
-      activeCategoryId = id; activeTagId = null;
-      query();
-    },
-    setActiveTagId(id) {
-      if (id === activeTagId && activeCategoryId === null) return;
-      activeTagId = id; activeCategoryId = null;
-      query();
-    },
-    async loadMore() {
-      if (!cursor || loadingMore) return;
-      const id = generation;
-      loadingMore = true; error = null; emit();
-      try {
-        const page = await fetchPosts({ limit: pageSize, cursor });
-        if (generation !== id) return;
-        posts = [...(posts ?? []), ...page.posts]; cursor = page.nextCursor;
-      } catch (e) {
-        if (generation !== id) return;
-        error = e instanceof Error ? e.message : String(e);
-      } finally {
-        if (generation === id) { loadingMore = false; emit(); }
-      }
-    },
-  };
-}

package/skills/wix-headless-fast/references/blog/app/wix/blog/post-store.ts

@@ -1,78 +0,0 @@
-// One post as a framework-free store — the logic behind usePost, usable from React (usePost wraps
-// it), from a static page's post view, from Vue/Svelte, or as the specification for a port. Loads
-// the post by slug (unless seeded) and the FULL taxonomy lists (blog taxonomies are small, fetched
-// once), and resolves the post's category/tag chips from them — never per-id lookups in a render.
-//
-// SSR-friendly: pass the server-fetched PostDetail as `initialPost` (and the taxonomy) and no client
-// fetch happens; a SPA passes only the slug. One store per post surface: createPostStore().
-import { fetchPostBySlug } from "./posts";
-import { fetchBlogCategories, fetchBlogTags } from "./taxonomy";
-import type { BlogCategory, BlogTag, PostDetail } from "./types";
-
-export interface PostStoreOptions {
-  slug: string;
-  initialPost?: PostDetail;
-  initialCategories?: BlogCategory[];
-  initialTags?: BlogTag[];
-}
-
-export interface PostState {
-  /** null while loading (render a skeleton) AND when not found — disambiguate via notFound. */
-  post: PostDetail | null;
-  /** True once the slug definitively resolved to nothing — render a not-found state. */
-  notFound: boolean;
-  /** This post's categories/tags, resolved to full objects (display .label, route by .slug). */
-  categories: BlogCategory[];
-  tags: BlogTag[];
-  error: string | null;
-}
-
-export interface PostStore {
-  getState(): PostState;
-  subscribe(listener: () => void): () => void;
-  /** Fetch the post (unless `initialPost` matches the slug) and the taxonomy (unless seeded). Call once when mounted. */
-  start(): void;
-  stop(): void;
-}
-
-export function createPostStore({ slug, initialPost, initialCategories, initialTags }: PostStoreOptions): PostStore {
-  let post: PostDetail | null = initialPost ?? null;
-  let notFound = false;
-  let allCategories: BlogCategory[] = initialCategories ?? [];
-  let allTags: BlogTag[] = initialTags ?? [];
-  let error: string | null = null;
-  let started = false;
-  const listeners = new Set<() => void>();
-  let snapshot: PostState | null = null;
-  const emit = () => { snapshot = null; for (const fn of listeners) fn(); };
-
-  function getState(): PostState {
-    if (snapshot) return snapshot;
-    snapshot = {
-      post,
-      notFound,
-      categories: post ? allCategories.filter((c) => post!.categoryIds.includes(c.id)) : [],
-      tags: post ? allTags.filter((t) => post!.tagIds.includes(t.id)) : [],
-      error,
-    };
-    return snapshot;
-  }
-
-  return {
-    getState,
-    subscribe(fn) { listeners.add(fn); return () => listeners.delete(fn); },
-    start() {
-      if (started) return;
-      started = true;
-      if (!initialPost || initialPost.slug !== slug) {
-        post = null; notFound = false; emit();
-        fetchPostBySlug(slug)
-          .then((p) => { if (!started) return; if (p) post = p; else notFound = true; emit(); })
-          .catch((e) => { if (started) { error = e instanceof Error ? e.message : String(e); emit(); } });
-      }
-      if (!initialCategories) fetchBlogCategories().then((c) => { if (started) { allCategories = c; emit(); } });
-      if (!initialTags) fetchBlogTags().then((t) => { if (started) { allTags = t; emit(); } });
-    },
-    stop() { started = false; },
-  };
-}

package/skills/wix-headless-fast/references/blog/app/wix/blog/posts-core.ts

@@ -1,117 +0,0 @@
-// Post rules and DTO mapping — transport-agnostic, imported by BOTH transports: ./posts.ts (the
-// SDK, managed Astro and React) and the REST twin in references/blog/rest/posts.ts (fetch, a static
-// site or a port to another language). Every rule about dates, covers, the feed's sort and filters,
-// and the body fieldsets lives HERE, once. A raw post may come from the SDK (`_id`, media as a
-// `wix:image://` string, dates as Date) or from REST (`id`, media as an { id, url } object, dates
-// as ISO strings); the mappers accept both and produce the same DTO. Imports are type-only so a
-// strip to JS emits no imports.
-import type { PostDetail, PostSummary } from "./types";
-
-/** A raw Blog V3 entity as either transport returns it. */
-export type Raw = Record<string, any>;
-/** Media value + size → https URL. Injected: the SDK transport scales through @wix/sdk, REST through the URL form. */
-export type ImgSrc = (value: any, width: number, height: number) => string;
-
-/** The Wix Blog app id (Astro item-page routing; comments use it as appId). */
-export const BLOG_APP_ID = "14bcded7-0066-7c35-14d7-466cb3f09103";
-
-/** The body fieldsets — without them richContent and contentText come back undefined. */
-export const DETAIL_FIELDSETS = ["RICH_CONTENT", "CONTENT_TEXT"] as const;
-
-/** The feed's order: newest first; Wix places pinned posts first on its own. */
-export const FEED_SORT = [{ fieldName: "firstPublishedDate", order: "DESC" }] as const;
-
-/** Cover size every card and post header gets — 16:9, one scaled URL per post. */
-export const COVER_WIDTH = 1200;
-export const COVER_HEIGHT = 675;
-
-export const rawId = (raw: Raw | undefined | null): string => raw?._id ?? raw?.id ?? "";
-
-/**
- * A media value in the form imgSrc scales. The SDK hands over the `wix:image://v1/<file>/<name>#…`
- * string; REST hands over the Image object { id, url, width, height, filename }. Rebuilding the
- * wix:image form from the object makes both transports scale to the SAME URL — passing the object's
- * `url` through would skip scaling and the two paths would disagree on coverUrl.
- */
-export function mediaValue(value: unknown): string {
-  if (!value) return "";
-  if (typeof value === "string") return value;
-  const o = value as Raw;
-  if (o.id && !String(o.id).startsWith("http")) {
-    const size = o.width && o.height ? `#originWidth=${o.width}&originHeight=${o.height}` : "";
-    return `wix:image://v1/${o.id}/${o.filename ?? ""}${size}`;
-  }
-  return o.url ?? o.image ?? "";
-}
-
-/** Display date + ISO date from either a Date (SDK) or an ISO string (REST); both "" when missing or invalid. */
-export function dateParts(value: unknown): { dateLabel: string; dateISO: string } {
-  if (!value) return { dateLabel: "", dateISO: "" };
-  const d = value instanceof Date ? value : new Date(String(value));
-  if (Number.isNaN(d.getTime())) return { dateLabel: "", dateISO: "" };
-  return {
-    dateLabel: d.toLocaleDateString(undefined, { year: "numeric", month: "short", day: "numeric" }),
-    dateISO: d.toISOString(),
-  };
-}
-
-/** "Aug 27, 2026 · 4 min read" — the card's and header's meta line; either half alone, "" when neither is known. */
-export function postMetaLine(post: Pick<PostSummary, "dateLabel" | "minutesToRead">): string {
-  return [post.dateLabel, post.minutesToRead > 0 ? `${post.minutesToRead} min read` : ""].filter(Boolean).join(" · ");
-}
-
-export function toSummary(raw: Raw, imgSrc: ImgSrc): PostSummary {
-  return {
-    id: rawId(raw),
-    slug: raw.slug ?? "",
-    title: raw.title ?? "",
-    excerpt: raw.excerpt ?? "",
-    ...dateParts(raw.firstPublishedDate),
-    minutesToRead: raw.minutesToRead ?? 0,
-    featured: raw.featured === true,
-    pinned: raw.pinned === true,
-    // The cover lives at media.wixMedia.image — a media string (SDK) or an Image object (REST).
-    coverUrl: imgSrc(mediaValue(raw.media?.wixMedia?.image), COVER_WIDTH, COVER_HEIGHT),
-    categoryIds: raw.categoryIds ?? [],
-    tagIds: raw.tagIds ?? [],
-  };
-}
-
-export function toDetail(raw: Raw, imgSrc: ImgSrc): PostDetail {
-  return {
-    ...toSummary(raw, imgSrc),
-    richContent: raw.richContent ?? null,
-    // contentText is plain text — split on newlines for the fallback body.
-    paragraphs: String(raw.contentText ?? "")
-      .split("\n")
-      .map((s: string) => s.trim())
-      .filter(Boolean),
-  };
-}
-
-export interface FetchPostsOptions {
-  limit?: number;
-  /** `nextCursor` from a previous page. */
-  cursor?: string | null;
-  /** Server-side filters (first page only — the cursor carries them on later pages). */
-  categoryId?: string | null;
-  tagId?: string | null;
-}
-
-/**
- * The feed query as one object — the REST body's `query`, and the rule the SDK builder in ./posts.ts
- * spells with .descending()/.hasSome()/.skipTo(). A cursor encodes the original filter+sort, so a
- * cursor request carries ONLY cursorPaging; the first page carries the sort and the filters.
- */
-export function feedQuery({ limit = 20, cursor, categoryId, tagId }: FetchPostsOptions = {}): Raw {
-  if (cursor) return { cursorPaging: { limit, cursor } };
-  const filter: Raw = {};
-  if (categoryId) filter.categoryIds = { $hasSome: [categoryId] };
-  if (tagId) filter.tagIds = { $hasSome: [tagId] };
-  return { ...(Object.keys(filter).length ? { filter } : {}), sort: FEED_SORT, cursorPaging: { limit } };
-}
-
-/** The by-slug query (REST body's `query`): exact slug, one row. */
-export function slugQuery(slug: string): Raw {
-  return { filter: { slug: { $eq: slug } }, cursorPaging: { limit: 1 } };
-}

package/skills/wix-headless-fast/references/blog/app/wix/blog/posts.ts

@@ -1,52 +0,0 @@
-// Post reads (Wix Blog V3) over the SDK — the only file that touches raw post entities on this
-// transport. Everything it returns is a plain DTO from ./types. The rules and mappers live in
-// ./posts-core (shared with the REST twin in references/blog/rest/); this file is the transport
-// only. Copy as-is; extend by adding functions, not by editing these. Blog posts are NOT CMS
-// collections — always @wix/blog, never @wix/data.
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/blog/posts-stats/query-posts.md
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/blog/posts-stats/get-post-by-slug.md
-import { posts as postsModule } from "@wix/blog";
-import { wixModule } from "../sdk";
-import { imgSrc } from "../media";
-import { BLOG_APP_ID, DETAIL_FIELDSETS, postMetaLine, toDetail, toSummary, type FetchPostsOptions, type Raw } from "./posts-core";
-import type { PostDetail, PostPage } from "./types";
-
-export { BLOG_APP_ID, postMetaLine, type FetchPostsOptions };
-
-const posts = wixModule(postsModule);
-
-/**
- * One page of published posts, newest first (pinned posts lead). Only published posts come
- * back to a visitor token — a "missing" post usually wasn't published, not a query bug.
- * The builder below spells posts-core's feedQuery: sort + filters on the first page, the cursor alone after.
- */
-export async function fetchPosts({ limit = 20, cursor, categoryId, tagId }: FetchPostsOptions = {}): Promise<PostPage> {
-  let q = posts.queryPosts().limit(limit);
-  if (cursor) {
-    // A cursor encodes the original filter+sort — re-sending them alongside it is rejected.
-    q = q.skipTo(cursor);
-  } else {
-    q = q.descending("firstPublishedDate");
-    if (categoryId) q = q.hasSome("categoryIds", [categoryId]);
-    if (tagId) q = q.hasSome("tagIds", [tagId]);
-  }
-  const res = await q.find();
-  return {
-    posts: (res.items ?? []).map((p: Raw) => toSummary(p, imgSrc)),
-    nextCursor: res.hasNext() ? (res.cursors?.next ?? null) : null,
-  };
-}
-
-/**
- * Fetch one post by its URL slug with the full body (RICH_CONTENT + CONTENT_TEXT fieldsets —
- * without them the body fields come back undefined). Null when not found.
- */
-export async function fetchPostBySlug(slug: string): Promise<PostDetail | null> {
-  const res = await posts
-    .queryPosts({ fieldsets: [...DETAIL_FIELDSETS] as any })
-    .eq("slug", slug)
-    .limit(1)
-    .find();
-  const raw = res.items?.[0];
-  return raw ? toDetail(raw as Raw, imgSrc) : null;
-}

package/skills/wix-headless-fast/references/blog/app/wix/blog/taxonomy-core.ts

@@ -1,47 +0,0 @@
-// Category + tag rules and DTO mapping — transport-agnostic, imported by both ./taxonomy.ts (SDK)
-// and the REST twin in references/blog/rest/taxonomy.ts (fetch). Raw entities may carry `_id`
-// (SDK) or `id` (REST). Has its own rawId/mediaValue (copies of posts-core's) so it stands alone
-// when stripped; imports are type-only.
-import type { BlogCategory, BlogTag } from "./types";
-import type { ImgSrc, Raw } from "./posts-core";
-
-/** Menu order — displayPosition ascending; -1 (unplaced) sorts first, which is also what the SDK path shows. */
-export const CATEGORY_SORT = [{ fieldName: "displayPosition", order: "ASC" }] as const;
-/** Most-published-posts first. */
-export const TAG_SORT = [{ fieldName: "publishedPostCount", order: "DESC" }] as const;
-/** Blog taxonomies are small — one read of up to 100 is the whole list. */
-export const TAXONOMY_LIMIT = 100;
-
-const rawId = (raw: Raw | undefined | null): string => raw?._id ?? raw?.id ?? "";
-
-// A copy of posts-core's mediaValue: the REST Image object → the wix:image form imgSrc scales.
-function mediaValue(value: unknown): string {
-  if (!value) return "";
-  if (typeof value === "string") return value;
-  const o = value as Raw;
-  if (o.id && !String(o.id).startsWith("http")) {
-    const size = o.width && o.height ? `#originWidth=${o.width}&originHeight=${o.height}` : "";
-    return `wix:image://v1/${o.id}/${o.filename ?? ""}${size}`;
-  }
-  return o.url ?? o.image ?? "";
-}
-
-export function toCategory(raw: Raw, imgSrc: ImgSrc): BlogCategory {
-  return {
-    id: rawId(raw),
-    slug: raw.slug ?? "",
-    label: raw.label ?? "", // the API's display name is `label`, never `name`
-    description: raw.description ?? "",
-    postCount: raw.postCount ?? 0,
-    coverUrl: imgSrc(mediaValue(raw.coverImage), 1200, 675),
-  };
-}
-
-export function toTag(raw: Raw): BlogTag {
-  return {
-    id: rawId(raw),
-    slug: raw.slug ?? "",
-    label: raw.label ?? "",
-    postCount: raw.publishedPostCount ?? 0, // PUBLISHED posts — postCount also counts drafts
-  };
-}

package/skills/wix-headless-fast/references/blog/app/wix/blog/taxonomy.ts

@@ -1,58 +0,0 @@
-// Category + tag reads (Wix Blog V3) over the SDK — the only file that touches raw taxonomy
-// entities on this transport. Everything it returns is a plain DTO from ./types. The mappers live
-// in ./taxonomy-core (shared with the REST twin in references/blog/rest/); this file is the
-// transport only. Copy as-is; extend by adding functions.
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/blog/category/query-categories.md
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/blog/tags/query-tags.md
-import { categories as categoriesModule, tags as tagsModule } from "@wix/blog";
-import { wixModule } from "../sdk";
-import { imgSrc } from "../media";
-import { TAXONOMY_LIMIT, toCategory, toTag } from "./taxonomy-core";
-import type { Raw } from "./posts-core";
-import type { BlogCategory, BlogTag } from "./types";
-
-const categories = wixModule(categoriesModule);
-const tags = wixModule(tagsModule);
-
-/** Categories in menu order (displayPosition) — non-fatal (empty array on failure). */
-export async function fetchBlogCategories(): Promise<BlogCategory[]> {
-  try {
-    const res = await categories.queryCategories().ascending("displayPosition").limit(TAXONOMY_LIMIT).find();
-    return (res.items ?? []).map((c: Raw) => toCategory(c, imgSrc)).filter((c) => c.id);
-  } catch {
-    return [];
-  }
-}
-
-/** Tags, most-published-posts first — non-fatal (empty array on failure). */
-export async function fetchBlogTags(): Promise<BlogTag[]> {
-  try {
-    const res = await tags.queryTags().descending("publishedPostCount").limit(TAXONOMY_LIMIT).find();
-    return (res.items ?? []).map((t: Raw) => toTag(t)).filter((t) => t.id);
-  } catch {
-    return [];
-  }
-}
-
-// The two by-slug getters return DIFFERENT envelopes upstream ({ category } vs { tag } here;
-// getTag(id) even returns the tag bare) — the mapping below absorbs that asymmetry once.
-
-/** One category by its URL slug. Null when not found. */
-export async function fetchCategoryBySlug(slug: string): Promise<BlogCategory | null> {
-  try {
-    const res = await categories.getCategoryBySlug(slug);
-    return res.category ? toCategory(res.category as Raw, imgSrc) : null;
-  } catch {
-    return null;
-  }
-}
-
-/** One tag by its URL slug. Null when not found. */
-export async function fetchTagBySlug(slug: string): Promise<BlogTag | null> {
-  try {
-    const res = await tags.getTagBySlug(slug);
-    return res.tag ? toTag(res.tag as Raw) : null;
-  } catch {
-    return null;
-  }
-}

package/skills/wix-headless-fast/references/blog/app/wix/blog/types.ts

@@ -1,62 +0,0 @@
-// Blog DTOs — the serializable shapes every hook, component, and page consumes.
-// Plain JSON: safe as Astro island props or across server/client boundaries. Cover images are
-// resolved https URLs; dates are pre-formatted display strings plus an ISO value for <time>.
-
-/** A post as a feed/grid tile needs it. */
-export interface PostSummary {
-  id: string;
-  slug: string;
-  title: string;
-  /** Short summary (≤500 chars) — the card body. May be "". */
-  excerpt: string;
-  /** Display-ready publish date, e.g. "Aug 26, 2026" ("" when missing). */
-  dateLabel: string;
-  /** ISO publish date for <time datetime> ("" when missing). */
-  dateISO: string;
-  /** Estimated reading time in minutes (0 when unknown). */
-  minutesToRead: number;
-  featured: boolean;
-  /** Pinned posts lead the default feed order. */
-  pinned: boolean;
-  /** Resolved https cover URL ("" when the post has no cover). */
-  coverUrl: string;
-  categoryIds: string[];
-  tagIds: string[];
-}
-
-/** A post as the post page needs it. */
-export interface PostDetail extends PostSummary {
-  /**
-   * Ricos rich-content document (plain JSON) — the real post body. Render it ONLY through
-   * the shipped RichContent component (@wix/ricos viewer); it is not HTML and not text.
-   */
-  richContent: Record<string, unknown> | null;
-  /** Plain-text body split into paragraphs — the honest fallback when richContent is null. */
-  paragraphs: string[];
-}
-
-export interface BlogCategory {
-  id: string;
-  slug: string;
-  /** Display name (the API calls it `label`, never `name`). */
-  label: string;
-  description: string;
-  /** Number of posts in the category (hide empty categories with it). */
-  postCount: number;
-  /** Resolved https cover URL ("" when none). */
-  coverUrl: string;
-}
-
-export interface BlogTag {
-  id: string;
-  slug: string;
-  label: string;
-  /** Number of PUBLISHED posts with this tag. */
-  postCount: number;
-}
-
-/** One feed page; pass `nextCursor` back to fetch the next (null → no more). */
-export interface PostPage {
-  posts: PostSummary[];
-  nextCursor: string | null;
-}

package/skills/wix-headless-fast/references/blog/app-astro/layouts/SiteLayout.astro

@@ -1,40 +0,0 @@
----
-// The site chrome for every blog 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. (If another vertical is also deployed, its SiteLayout
-// won; merge a Blog nav link there instead.)
-import "../styles/global.css";
-
-interface Props {
-  title: string;
-  description?: string;
-}
-const { title, description } = 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} />}
-    <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="/blog" class="text-foreground no-underline transition-colors hover:text-muted-foreground">Blog</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>