bsmnt 0.2.10 → 0.3.0

package/src/templates/next-pagebuilder/lib/integrations/sanity/schemas/components/singleton/content-collection.ts

@@ -0,0 +1,45 @@
+import { defineField, defineType } from "sanity"
+import type { SanityStudioIcon } from "@/lib/integrations/sanity/icons"
+import { pageListIcon } from "@/lib/integrations/sanity/icons"
+
+function createContentCollection(config: {
+  name: string
+  title: string
+  icon: SanityStudioIcon
+  label: string
+}) {
+  return defineType({
+    name: config.name,
+    title: config.title,
+    type: "document",
+    icon: config.icon,
+    description: `This component contains all the ${config.label}`,
+    fields: [
+      defineField({
+        name: "subtitle",
+        title: "Subtitle",
+        type: "string",
+        description:
+          "Text displayed between the featured articles and the rest of the collection",
+      }),
+    ],
+    preview: {
+      select: {
+        title: "title",
+      },
+      prepare({ title }) {
+        return {
+          title: title || config.title,
+          subtitle: `${config.title} with search and category filters`,
+        }
+      },
+    },
+  })
+}
+
+export const blogCollection = createContentCollection({
+  name: "blogCollection",
+  title: "Blog Collection",
+  icon: pageListIcon,
+  label: "blog articles",
+})

package/src/templates/next-pagebuilder/lib/integrations/sanity/schemas/content/author.ts

@@ -0,0 +1,70 @@
+import { defineField, defineType } from "sanity"
+import { authorIcon } from "@/lib/integrations/sanity/icons"
+
+export const author = defineType({
+  name: "author",
+  title: "Author",
+  type: "document",
+  icon: authorIcon,
+  fields: [
+    defineField({
+      name: "name",
+      title: "Name",
+      type: "string",
+      validation: (Rule) => Rule.required(),
+    }),
+    defineField({
+      name: "avatar",
+      title: "Avatar",
+      type: "image",
+      options: {
+        hotspot: true,
+      },
+      fields: [
+        {
+          name: "alt",
+          title: "Alt Text",
+          type: "string",
+          description: "Alternative text for screen readers",
+        },
+      ],
+      validation: (Rule) => Rule.required(),
+    }),
+    defineField({
+      name: "role",
+      title: "Role",
+      type: "string",
+      description: "Job title or role (e.g. CEO, Engineering Lead)",
+    }),
+    defineField({
+      name: "description",
+      title: "Description",
+      type: "text",
+      rows: 3,
+      description: "Short bio displayed on blog articles",
+    }),
+    defineField({
+      name: "linkedInUrl",
+      title: "LinkedIn URL",
+      type: "url",
+      validation: (Rule) =>
+        Rule.uri({
+          scheme: ["https"],
+        }),
+    }),
+  ],
+  preview: {
+    select: {
+      title: "name",
+      subtitle: "role",
+      media: "avatar",
+    },
+  },
+  orderings: [
+    {
+      title: "Name A-Z",
+      name: "nameAsc",
+      by: [{ field: "name", direction: "asc" }],
+    },
+  ],
+})

package/src/templates/next-pagebuilder/lib/integrations/sanity/schemas/content/blog-category.ts

@@ -0,0 +1,55 @@
+import { defineField, defineType } from "sanity"
+import { blogCategoryIcon } from "@/lib/integrations/sanity/icons"
+
+export const blogCategory = defineType({
+  name: "blogCategory",
+  title: "Blog Category",
+  type: "document",
+  icon: blogCategoryIcon,
+  fields: [
+    defineField({
+      name: "title",
+      title: "Title",
+      type: "string",
+      description: "Category name (e.g. AI, Product Updates, Engineering)",
+      validation: (Rule) => Rule.required(),
+    }),
+    defineField({
+      name: "slug",
+      title: "Slug",
+      type: "slug",
+      description: "URL-friendly identifier used for filtering",
+      options: {
+        source: "title",
+        maxLength: 96,
+      },
+      validation: (Rule) =>
+        Rule.required().custom((slug) => {
+          if (!slug?.current) return "Required"
+          if (!/^[a-z0-9-]+$/.test(slug.current)) {
+            return "Slug must be lowercase with hyphens only"
+          }
+          return true
+        }),
+    }),
+    defineField({
+      name: "description",
+      title: "Description",
+      type: "text",
+      rows: 2,
+      description: "Brief description of this category",
+    }),
+  ],
+  preview: {
+    select: {
+      title: "title",
+    },
+  },
+  orderings: [
+    {
+      title: "Title A-Z",
+      name: "titleAsc",
+      by: [{ field: "title", direction: "asc" }],
+    },
+  ],
+})

package/src/templates/next-pagebuilder/lib/integrations/sanity/schemas/index.ts

@@ -0,0 +1,96 @@
+/**
+ * Sanity Schema Types
+ *
+ * All schema definitions for Sanity CMS.
+ * Shared schemas live in `schemas/shared`, content documents live in
+ * `schemas/content`, component documents live in `schemas/components`, and
+ * layout documents live in `schemas/layout`.
+ */
+
+import type { SchemaTypeDefinition } from "sanity"
+import {
+  blogCollection,
+  blogContent,
+  description,
+  hero,
+} from "./components"
+import { author } from "./content/author"
+import { blogCategory } from "./content/blog-category"
+import { companyData } from "./layout/company-data"
+import { footer } from "./layout/footer"
+import { navbar } from "./layout/navbar"
+import { externalLink, link, pageReference } from "./shared/link"
+import { metadata } from "./shared/metadata"
+import {
+  navColumn,
+  navItem,
+  navLeafItem,
+  navMegaMenu,
+} from "./shared/nav-objects"
+import { page } from "./shared/page"
+import { pageBuilder } from "./shared/page-builder"
+import { pageFolder } from "./shared/page-folder"
+import { richText } from "./shared/richText"
+
+// Re-export all schemas for convenience
+export {
+  author,
+  blogCategory,
+  blogCollection,
+  blogContent,
+  companyData,
+  description,
+  externalLink,
+  footer,
+  hero,
+  link,
+  metadata,
+  navbar,
+  navColumn,
+  navItem,
+  navLeafItem,
+  navMegaMenu,
+  page,
+  pageBuilder,
+  pageFolder,
+  pageReference,
+  richText,
+}
+
+// Schema collection for Sanity configuration
+export const schema: { types: SchemaTypeDefinition[] } = {
+  types: [
+    // Object types (reusable field types)
+    pageReference,
+    externalLink,
+    link,
+    metadata,
+    pageBuilder,
+    richText,
+
+    // Navigation object types (used by navbar)
+    navLeafItem,
+    navColumn,
+    navMegaMenu,
+    navItem,
+
+    // Component types (reusable document components)
+    blogCollection,
+    blogContent,
+    hero,
+    description,
+
+    // Layout types (singletons for site-wide layout)
+    companyData,
+    navbar,
+    footer,
+
+    // Document types (content pages)
+    page,
+    pageFolder,
+
+    // Content types (reusable content)
+    author,
+    blogCategory,
+  ],
+}

package/src/templates/next-pagebuilder/lib/integrations/sanity/schemas/layout/company-data.ts

@@ -0,0 +1,62 @@
+import { defineArrayMember, defineField, defineType } from "sanity"
+import { socialLinksIcon } from "@/lib/integrations/sanity/icons"
+
+export const companyData = defineType({
+  name: "companyData",
+  title: "Company Data",
+  type: "document",
+  fields: [
+    defineField({
+      name: "socialLinks",
+      title: "Social Links",
+      type: "array",
+      of: [
+        defineArrayMember({
+          type: "object",
+          icon: socialLinksIcon,
+          fields: [
+            defineField({
+              name: "name",
+              title: "Name",
+              type: "string",
+              description: "Platform name (e.g. LinkedIn, TikTok, Bluesky)",
+              validation: (Rule) => Rule.required(),
+            }),
+            defineField({
+              name: "icon",
+              title: "Icon",
+              type: "image",
+              description: "Platform icon (SVG, PNG, WebP, etc.)",
+              validation: (Rule) => Rule.required(),
+            }),
+            defineField({
+              name: "url",
+              title: "URL",
+              type: "url",
+              validation: (Rule) => Rule.required(),
+            }),
+            defineField({
+              name: "label",
+              title: "Label",
+              type: "string",
+              description:
+                "Accessible label for the link (e.g. 'Follow us on LinkedIn')",
+            }),
+          ],
+          preview: {
+            select: {
+              title: "name",
+              subtitle: "url",
+              media: "icon",
+            },
+          },
+        }),
+      ],
+    }),
+  ],
+  preview: {
+    prepare() {
+      return { title: "Company Data" }
+    },
+  },
+})

package/src/templates/next-pagebuilder/lib/integrations/sanity/schemas/layout/footer.ts

@@ -0,0 +1,79 @@
+import { defineField, defineType } from "sanity"
+
+export const footer = defineType({
+  name: "footer",
+  title: "Footer",
+  type: "document",
+  fields: [
+    defineField({
+      name: "links",
+      title: "Links",
+      description: "Navigation columns (e.g. Products, Solutions, Resources)",
+      type: "array",
+      of: [
+        {
+          type: "object",
+          fields: [
+            defineField({
+              name: "title",
+              title: "Title",
+              type: "string",
+              validation: (Rule) => Rule.required(),
+            }),
+            defineField({
+              name: "items",
+              title: "Items",
+              type: "array",
+              of: [
+                {
+                  type: "object",
+                  fields: [
+                    defineField({
+                      name: "label",
+                      title: "Label",
+                      type: "string",
+                      validation: (Rule) => Rule.required(),
+                    }),
+                    defineField({
+                      name: "href",
+                      title: "Path",
+                      type: "string",
+                      description: "Relative path (e.g. /products, /about)",
+                      validation: (Rule) =>
+                        Rule.required().custom((value) => {
+                          if (
+                            typeof value === "string" &&
+                            !value.startsWith("/")
+                          ) {
+                            return "Path must start with /"
+                          }
+                          return true
+                        }),
+                    }),
+                  ],
+                  preview: {
+                    select: { title: "label", subtitle: "href" },
+                  },
+                },
+              ],
+            }),
+          ],
+          preview: {
+            select: { title: "title", items: "items" },
+            prepare({ title, items }) {
+              return {
+                title,
+                subtitle: `${items?.length ?? 0} items`,
+              }
+            },
+          },
+        },
+      ],
+    }),
+  ],
+  preview: {
+    prepare() {
+      return { title: "Footer" }
+    },
+  },
+})

package/src/templates/next-pagebuilder/lib/integrations/sanity/schemas/layout/navbar.ts

@@ -0,0 +1,74 @@
+import { defineArrayMember, defineField, defineType } from "sanity"
+
+import { logoField } from "@/lib/integrations/sanity/schemas/shared/logo-field"
+
+export const navbar = defineType({
+  name: "navbar",
+  title: "Navbar",
+  type: "document",
+  fields: [
+    logoField,
+    defineField({
+      name: "navigationItems",
+      title: "Navigation Items",
+      type: "array",
+      of: [defineArrayMember({ type: "navItem" })],
+      description: "Top-level navigation items -- direct links or menu triggers",
+    }),
+    defineField({
+      name: "ctaButtons",
+      title: "CTA Buttons",
+      type: "array",
+      of: [
+        {
+          type: "object",
+          fields: [
+            defineField({
+              name: "label",
+              title: "Label",
+              type: "string",
+              validation: (Rule) => Rule.required(),
+            }),
+            defineField({
+              name: "link",
+              title: "Link",
+              type: "link",
+              validation: (Rule) => Rule.required(),
+            }),
+            defineField({
+              name: "variant",
+              title: "Variant",
+              type: "string",
+              options: {
+                list: [
+                  { title: "Primary", value: "primary" },
+                  { title: "Secondary", value: "secondary" },
+                ],
+              },
+              initialValue: "primary",
+              validation: (Rule) => Rule.required(),
+            }),
+          ],
+          preview: {
+            select: {
+              title: "label",
+              variant: "variant",
+            },
+            prepare({ title, variant }) {
+              return {
+                title,
+                subtitle: variant || "primary",
+              }
+            },
+          },
+        },
+      ],
+      description: "Action buttons on the right side of the navbar",
+    }),
+  ],
+  preview: {
+    prepare() {
+      return { title: "Navbar" }
+    },
+  },
+})

package/src/templates/next-pagebuilder/lib/integrations/sanity/schemas/shared/link.ts

@@ -0,0 +1,125 @@
+import { defineArrayMember, defineField, defineType } from "sanity"
+
+/**
+ * Page Reference -- internal link to a Sanity page document.
+ */
+export const pageReference = defineType({
+  name: "pageReference",
+  title: "Page",
+  type: "object",
+  fields: [
+    defineField({
+      name: "page",
+      title: "Page",
+      type: "reference",
+      to: [{ type: "page" }],
+      validation: (Rule) => Rule.required(),
+    }),
+    defineField({
+      name: "openInNewTab",
+      title: "Open in New Tab",
+      type: "boolean",
+      initialValue: false,
+    }),
+  ],
+  preview: {
+    select: {
+      text: "text",
+      pageTitle: "page.title",
+    },
+    prepare({ text, pageTitle }) {
+      return {
+        title: text || pageTitle || "Untitled",
+        subtitle: pageTitle ? `Page: ${pageTitle}` : "Page Reference",
+      }
+    },
+  },
+})
+
+/**
+ * External Link -- URL pointing outside the site (or to pages not yet in Sanity).
+ */
+export const externalLink = defineType({
+  name: "externalLink",
+  title: "URL",
+  type: "object",
+  fields: [
+    defineField({
+      name: "href",
+      title: "URL",
+      type: "url",
+      validation: (Rule) =>
+        Rule.required().uri({
+          scheme: ["http", "https", "mailto", "tel"],
+          allowRelative: true,
+        }),
+    }),
+    defineField({
+      name: "openInNewTab",
+      title: "Open in New Tab",
+      type: "boolean",
+      initialValue: false,
+    }),
+  ],
+  preview: {
+    select: {
+      text: "text",
+      href: "href",
+    },
+    prepare({ text, href }) {
+      return {
+        title: text || href || "Untitled",
+        subtitle: href ? `URL: ${href}` : "External Link",
+      }
+    },
+  },
+})
+
+/**
+ * Link -- array-of-one wrapper that accepts either a page reference or external URL.
+ * Editors click "Add" and pick which type they need.
+ */
+export const link = defineType({
+  name: "link",
+  title: "Link",
+  type: "array",
+  of: [
+    defineArrayMember({ type: "pageReference" }),
+    defineArrayMember({ type: "externalLink" }),
+  ],
+  validation: (Rule) => Rule.max(1),
+})
+
+/**
+ * Annotations for Portable Text -- both link types as separate mark annotations.
+ */
+export const linkAnnotations = [
+  defineArrayMember({ type: "pageReference" }),
+  defineArrayMember({ type: "externalLink" }),
+]
+
+// Helper field exports for easy reuse
+export const linkField = defineField({
+  name: "link",
+  title: "Link",
+  type: "link",
+})
+
+type LinkFieldOptions = {
+  name?: string
+  title?: string
+  required?: boolean
+}
+
+export function extendedLinkField({
+  name = "link",
+  title = "Link",
+  required = false,
+}: LinkFieldOptions = {}) {
+  return defineField({
+    name,
+    title,
+    type: "link",
+    validation: required ? (Rule) => Rule.required().min(1) : undefined,
+  })
+}

package/src/templates/next-pagebuilder/lib/integrations/sanity/schemas/shared/logo-field.ts

@@ -0,0 +1,9 @@
+import { defineField } from "sanity"
+
+export const logoField = defineField({
+  name: "logo",
+  title: "Logo",
+  type: "image",
+  options: { hotspot: true },
+  validation: (Rule) => Rule.required(),
+})

package/src/templates/next-pagebuilder/lib/integrations/sanity/schemas/shared/metadata.ts

@@ -0,0 +1,68 @@
+import { defineField, defineType } from "sanity"
+
+export const metadata = defineType({
+  name: "metadata",
+  title: "SEO & Metadata",
+  type: "object",
+  options: {
+    collapsible: true,
+    collapsed: true,
+  },
+  fields: [
+    defineField({
+      name: "metaTitle",
+      title: "Meta Title",
+      type: "string",
+      description: "Title used by search engines",
+      validation: (Rule) =>
+        Rule.max(60).warning(
+          "Title should be under 60 characters for optimal SEO"
+        ),
+    }),
+    defineField({
+      name: "metaDescription",
+      title: "Meta Description",
+      type: "text",
+      rows: 3,
+      description: "Description used by search engines",
+      validation: (Rule) =>
+        Rule.max(160).warning(
+          "Description should be under 160 characters for optimal SEO"
+        ),
+    }),
+    defineField({
+      name: "image",
+      title: "OG Image",
+      type: "image",
+      description: "Image for social sharing previews (1200x630px recommended)",
+      options: {
+        hotspot: true,
+      },
+    }),
+    defineField({
+      name: "index",
+      title: "Index",
+      type: "boolean",
+      description: "Allow search engines to index this page",
+      initialValue: true,
+    }),
+    defineField({
+      name: "title",
+      title: "Legacy Meta Title",
+      type: "string",
+      hidden: true,
+    }),
+    defineField({
+      name: "description",
+      title: "Legacy Meta Description",
+      type: "text",
+      hidden: true,
+    }),
+    defineField({
+      name: "noIndex",
+      title: "Legacy No Index",
+      type: "boolean",
+      hidden: true,
+    }),
+  ],
+})