bsmnt 0.4.3 → 0.6.0

package/src/modules/features/cms/sanity/files/lib/integrations/sanity/components/disable-draft-mode.tsx

@@ -2,14 +2,14 @@
 
 import Link from "next/link";
 import { usePathname } from "next/navigation";
-import { useDraftModeEnvironment } from "next-sanity/hooks";
+import { useIsPresentationTool } from "next-sanity/hooks";
 
 export function DisableDraftMode() {
-	const environment = useDraftModeEnvironment();
+	const isPresentationTool = useIsPresentationTool();
 	const pathname = usePathname();
 
 	// Only show the disable draft mode button when outside of Presentation Tool
-	if (environment !== "live" && environment !== "unknown") {
+	if (isPresentationTool) {
 		return null;
 	}
 

package/src/modules/features/cms/sanity/files/lib/integrations/sanity/queries.ts

@@ -64,3 +64,17 @@ export const ARTICLE_BY_ID_QUERY = defineQuery(`
     _updatedAt
   }
 `);
+
+// Site-wide structured data (JSON-LD Organization + WebSite identity)
+export const STRUCTURED_DATA_QUERY = defineQuery(`
+  *[_type == "structuredData"][0]{
+    name,
+    legalName,
+    description,
+    url,
+    "logo": logo.asset->url,
+    sameAs,
+    contactPoint,
+    address
+  }
+`);

package/src/modules/features/cms/sanity/files/lib/integrations/sanity/sanity.config.ts

@@ -16,6 +16,10 @@ import { apiVersion, dataset, previewURL, projectId } from "./env";
 import { schema } from "./schemas";
 import { structure } from "./structure";
 
+// Document types pinned to a single editable document.
+const SINGLETON_TYPES = new Set(["structuredData"]);
+const SINGLETON_ACTIONS = new Set(["publish", "discardChanges", "restore"]);
+
 // Helper function for URL resolution
 function resolveHref(documentType?: string, slug?: string): string | undefined {
 	switch (documentType) {
@@ -77,15 +81,27 @@ export default defineConfig({
 		media(),
 	],
 	document: {
-		actions: (prev) => {
+		actions: (prev, context) => {
 			const isProd = process.env.NODE_ENV === "production";
-			if (!isProd) return prev;
 
-			return prev.map((action) =>
+			// Singletons can't be created or deleted from the document pane.
+			const filtered = SINGLETON_TYPES.has(context.schemaType)
+				? prev.filter(
+						(action) =>
+							action.action !== undefined &&
+							SINGLETON_ACTIONS.has(action.action),
+					)
+				: prev;
+
+			if (!isProd) return filtered;
+
+			return filtered.map((action) =>
 				action.action === "publish"
 					? createConfirmPublishAction(action)
 					: action,
 			);
 		},
+		newDocumentOptions: (prev) =>
+			prev.filter((option) => !SINGLETON_TYPES.has(option.templateId)),
 	},
 });

package/src/modules/features/cms/sanity/files/lib/integrations/sanity/sanity.types.ts

@@ -130,6 +130,7 @@ export type Metadata = {
 		_type: "image";
 	};
 	noIndex?: boolean;
+	jsonLd?: Array<{ _key: string; _type: string; [key: string]: unknown }>;
 };
 
 export type RichText = Array<

package/src/modules/features/cms/sanity/files/lib/integrations/sanity/schemas/article.ts

@@ -1,13 +1,6 @@
 import { defineField, defineType } from "sanity";
 
 const articleFields = [
-	defineField({
-		name: "title",
-		title: "Title",
-		type: "string",
-		description: "The title of the article",
-		validation: (Rule) => Rule.required(),
-	}),
 	defineField({
 		name: "excerpt",
 		title: "Excerpt",
@@ -66,6 +59,13 @@ export const article = defineType({
 	title: "Article",
 	type: "document",
 	fields: [
+		defineField({
+			name: "title",
+			title: "Title",
+			type: "string",
+			description: "The title of the article",
+			validation: (Rule) => Rule.required(),
+		}),
 		defineField({
 			name: "slug",
 			title: "Slug",

package/src/modules/features/cms/sanity/files/lib/integrations/sanity/schemas/index.ts

@@ -13,9 +13,34 @@ import { link } from "./link";
 import { metadata } from "./metadata";
 import { navigation } from "./navigation";
 import { richText } from "./richText";
+import { structuredData } from "./structured-data";
+import {
+	customJsonLd,
+	eventJsonLd,
+	faqJsonLd,
+	itemListJsonLd,
+	jobPostingJsonLd,
+	softwareApplicationJsonLd,
+	videoJsonLd,
+} from "./structured-data-blocks";
 
 // Re-export all schemas for convenience
-export { article, example, link, metadata, navigation, richText };
+export {
+	article,
+	customJsonLd,
+	eventJsonLd,
+	example,
+	faqJsonLd,
+	itemListJsonLd,
+	jobPostingJsonLd,
+	link,
+	metadata,
+	navigation,
+	richText,
+	softwareApplicationJsonLd,
+	structuredData,
+	videoJsonLd,
+};
 
 // Schema collection for Sanity configuration
 export const schema: { types: SchemaTypeDefinition[] } = {
@@ -25,11 +50,21 @@ export const schema: { types: SchemaTypeDefinition[] } = {
 		metadata,
 		richText,
 
+		// Page-level JSON-LD blocks (selectable in metadata)
+		faqJsonLd,
+		eventJsonLd,
+		videoJsonLd,
+		jobPostingJsonLd,
+		softwareApplicationJsonLd,
+		itemListJsonLd,
+		customJsonLd,
+
 		// Document types (content pages)
 		article,
 		example,
 
 		// Singleton types (one-off content)
 		navigation,
+		structuredData,
 	],
 };

package/src/modules/features/cms/sanity/files/lib/integrations/sanity/schemas/metadata.ts

@@ -1,4 +1,5 @@
-import { defineField, defineType } from "sanity";
+import { defineArrayMember, defineField, defineType } from "sanity";
+import { pageJsonLdMembers } from "./structured-data-blocks";
 
 export const metadata = defineType({
 	name: "metadata",
@@ -64,5 +65,15 @@ export const metadata = defineType({
 			description: "Prevent search engines from indexing this page",
 			initialValue: false,
 		}),
+		defineField({
+			name: "jsonLd",
+			title: "Structured Data (JSON-LD)",
+			type: "array",
+			description:
+				"Page-level schema.org structured data emitted as JSON-LD. Pick a predefined type, or add a Custom JSON-LD block for anything not listed.",
+			of: pageJsonLdMembers.map((member) =>
+				defineArrayMember({ type: member.name }),
+			),
+		}),
 	],
 });

package/src/modules/features/cms/sanity/files/lib/integrations/sanity/schemas/structured-data-blocks.ts

@@ -0,0 +1,416 @@
+import { defineArrayMember, defineField, defineType } from "sanity";
+
+/**
+ * Editor-selectable JSON-LD blocks (predefined schema.org types + a raw
+ * `customJsonLd` escape hatch), each emitted as its own script tag.
+ */
+
+export const faqJsonLd = defineType({
+	name: "faqJsonLd",
+	title: "FAQ",
+	type: "object",
+	fields: [
+		defineField({
+			name: "questions",
+			title: "Questions",
+			type: "array",
+			validation: (Rule) => Rule.min(1),
+			of: [
+				defineArrayMember({
+					type: "object",
+					fields: [
+						defineField({
+							name: "question",
+							title: "Question",
+							type: "string",
+							validation: (Rule) => Rule.required(),
+						}),
+						defineField({
+							name: "answer",
+							title: "Answer",
+							type: "text",
+							rows: 3,
+							validation: (Rule) => Rule.required(),
+						}),
+					],
+					preview: {
+						select: { title: "question", subtitle: "answer" },
+					},
+				}),
+			],
+		}),
+	],
+	preview: {
+		select: { questions: "questions" },
+		prepare: ({ questions }) => ({
+			title: "FAQ",
+			subtitle: `${Array.isArray(questions) ? questions.length : 0} question(s)`,
+		}),
+	},
+});
+
+export const jobPostingJsonLd = defineType({
+	name: "jobPostingJsonLd",
+	title: "Job Posting",
+	type: "object",
+	fields: [
+		defineField({
+			name: "title",
+			title: "Job Title",
+			type: "string",
+			validation: (Rule) => Rule.required(),
+		}),
+		defineField({
+			name: "description",
+			title: "Description",
+			type: "text",
+			rows: 4,
+			validation: (Rule) => Rule.required(),
+		}),
+		defineField({
+			name: "datePosted",
+			title: "Date Posted",
+			type: "datetime",
+			validation: (Rule) => Rule.required(),
+		}),
+		defineField({
+			name: "validThrough",
+			title: "Valid Through",
+			type: "datetime",
+			description: "When the posting expires.",
+		}),
+		defineField({
+			name: "employmentType",
+			title: "Employment Type",
+			type: "string",
+			options: {
+				list: [
+					{ title: "Full-time", value: "FULL_TIME" },
+					{ title: "Part-time", value: "PART_TIME" },
+					{ title: "Contractor", value: "CONTRACTOR" },
+					{ title: "Temporary", value: "TEMPORARY" },
+					{ title: "Intern", value: "INTERN" },
+					{ title: "Volunteer", value: "VOLUNTEER" },
+					{ title: "Per diem", value: "PER_DIEM" },
+					{ title: "Other", value: "OTHER" },
+				],
+			},
+		}),
+		defineField({
+			name: "organizationName",
+			title: "Hiring Organization",
+			type: "string",
+		}),
+		defineField({
+			name: "organizationUrl",
+			title: "Organization URL",
+			type: "url",
+		}),
+		defineField({
+			name: "remote",
+			title: "Remote / Telecommute",
+			type: "boolean",
+			initialValue: false,
+		}),
+		defineField({ name: "locality", title: "City", type: "string" }),
+		defineField({ name: "region", title: "Region / State", type: "string" }),
+		defineField({ name: "country", title: "Country", type: "string" }),
+	],
+	preview: {
+		select: { title: "title", subtitle: "organizationName" },
+		prepare: ({ title, subtitle }) => ({
+			title: title || "Job Posting",
+			subtitle: subtitle ? `Job · ${subtitle}` : "Job Posting",
+		}),
+	},
+});
+
+export const softwareApplicationJsonLd = defineType({
+	name: "softwareApplicationJsonLd",
+	title: "Software Application",
+	type: "object",
+	fields: [
+		defineField({
+			name: "name",
+			title: "Name",
+			type: "string",
+			validation: (Rule) => Rule.required(),
+		}),
+		defineField({
+			name: "description",
+			title: "Description",
+			type: "text",
+			rows: 2,
+		}),
+		defineField({
+			name: "applicationCategory",
+			title: "Application Category",
+			type: "string",
+			options: {
+				list: [
+					{ title: "Web application", value: "WebApplication" },
+					{ title: "Mobile application", value: "MobileApplication" },
+					{ title: "Developer tool", value: "DeveloperApplication" },
+					{ title: "Business application", value: "BusinessApplication" },
+					{ title: "Design application", value: "DesignApplication" },
+					{ title: "Game", value: "GameApplication" },
+				],
+			},
+		}),
+		defineField({
+			name: "operatingSystem",
+			title: "Operating System",
+			type: "string",
+			description: "e.g. 'Web', 'macOS, Windows', 'iOS, Android'.",
+		}),
+		defineField({
+			name: "price",
+			title: "Price",
+			type: "number",
+			description: "Use 0 for free apps. Enables the rich result.",
+		}),
+		defineField({
+			name: "currency",
+			title: "Currency",
+			type: "string",
+			description: "ISO 4217 code, e.g. USD, EUR.",
+			initialValue: "USD",
+		}),
+		defineField({ name: "url", title: "URL", type: "url" }),
+		defineField({ name: "image", title: "Screenshot / Icon", type: "image" }),
+	],
+	preview: {
+		select: { title: "name", subtitle: "applicationCategory" },
+		prepare: ({ title, subtitle }) => ({
+			title: title || "Software Application",
+			subtitle: subtitle ? `App · ${subtitle}` : "Software Application",
+		}),
+	},
+});
+
+export const itemListJsonLd = defineType({
+	name: "itemListJsonLd",
+	title: "Item List / Carousel",
+	type: "object",
+	description:
+		"An ordered list of links (e.g. a carousel of articles or products). Each item points to a page on your site.",
+	fields: [
+		defineField({
+			name: "name",
+			title: "List Name",
+			type: "string",
+			description: "Optional title for the list.",
+		}),
+		defineField({
+			name: "items",
+			title: "Items",
+			type: "array",
+			validation: (Rule) => Rule.min(1),
+			of: [
+				defineArrayMember({
+					type: "object",
+					fields: [
+						defineField({
+							name: "name",
+							title: "Name",
+							type: "string",
+							validation: (Rule) => Rule.required(),
+						}),
+						defineField({
+							name: "url",
+							title: "URL",
+							type: "url",
+							validation: (Rule) => Rule.required(),
+						}),
+					],
+					preview: {
+						select: { title: "name", subtitle: "url" },
+					},
+				}),
+			],
+		}),
+	],
+	preview: {
+		select: { title: "name", items: "items" },
+		prepare: ({ title, items }) => ({
+			title: title || "Item List / Carousel",
+			subtitle: `${Array.isArray(items) ? items.length : 0} item(s)`,
+		}),
+	},
+});
+
+export const eventJsonLd = defineType({
+	name: "eventJsonLd",
+	title: "Event",
+	type: "object",
+	fields: [
+		defineField({
+			name: "name",
+			title: "Name",
+			type: "string",
+			validation: (Rule) => Rule.required(),
+		}),
+		defineField({
+			name: "description",
+			title: "Description",
+			type: "text",
+			rows: 2,
+		}),
+		defineField({
+			name: "startDate",
+			title: "Start Date",
+			type: "datetime",
+			validation: (Rule) => Rule.required(),
+		}),
+		defineField({ name: "endDate", title: "End Date", type: "datetime" }),
+		defineField({
+			name: "locationName",
+			title: "Location Name",
+			type: "string",
+			description: "Venue name, or leave blank for online events.",
+		}),
+		defineField({
+			name: "locationAddress",
+			title: "Location Address",
+			type: "string",
+		}),
+		defineField({ name: "url", title: "Event URL", type: "url" }),
+		defineField({ name: "image", title: "Image", type: "image" }),
+	],
+	preview: {
+		select: { title: "name", subtitle: "startDate" },
+		prepare: ({ title, subtitle }) => ({
+			title: title || "Event",
+			subtitle: subtitle ? `Event · ${subtitle}` : "Event",
+		}),
+	},
+});
+
+export const videoJsonLd = defineType({
+	name: "videoJsonLd",
+	title: "Video",
+	type: "object",
+	fields: [
+		defineField({
+			name: "name",
+			title: "Name",
+			type: "string",
+			validation: (Rule) => Rule.required(),
+		}),
+		defineField({
+			name: "description",
+			title: "Description",
+			type: "text",
+			rows: 2,
+			validation: (Rule) => Rule.required(),
+		}),
+		defineField({
+			name: "thumbnail",
+			title: "Thumbnail",
+			type: "image",
+			validation: (Rule) => Rule.required(),
+		}),
+		defineField({
+			name: "uploadDate",
+			title: "Upload Date",
+			type: "datetime",
+			validation: (Rule) => Rule.required(),
+		}),
+		defineField({
+			name: "contentUrl",
+			title: "Content URL",
+			type: "url",
+			description: "Direct link to the video file (.mp4, etc.).",
+		}),
+		defineField({
+			name: "embedUrl",
+			title: "Embed URL",
+			type: "url",
+			description: "Player embed URL (YouTube, Vimeo, etc.).",
+		}),
+	],
+	preview: {
+		select: { title: "name" },
+		prepare: ({ title }) => ({
+			title: title || "Video",
+			subtitle: "Video",
+		}),
+	},
+});
+
+export const customJsonLd = defineType({
+	name: "customJsonLd",
+	title: "Custom JSON-LD",
+	type: "object",
+	description:
+		"Optional JSON-LD block for advanced rich results (FAQ, Product, HowTo, etc.). Emits its own <script> tag. Validate snippets with https://search.google.com/test/rich-results — invalid blocks are skipped at render time.",
+	fields: [
+		defineField({
+			name: "label",
+			title: "Internal Label",
+			type: "string",
+			description:
+				"For your reference only (e.g. 'FAQ – pricing tiers'). Not emitted.",
+			validation: (Rule) => Rule.required(),
+		}),
+		defineField({
+			name: "json",
+			title: "JSON-LD",
+			type: "text",
+			rows: 10,
+			description:
+				"Paste a single schema.org JSON-LD object. Omit the <script> wrapper. Must include an @type (@context is added automatically if omitted).",
+			validation: (Rule) =>
+				Rule.required().custom((value) => {
+					if (typeof value !== "string" || value.trim() === "") {
+						return "JSON-LD is required";
+					}
+					try {
+						const parsed = JSON.parse(value);
+						if (Array.isArray(parsed)) {
+							return "Use one block per entry (split arrays into multiple blocks).";
+						}
+						if (typeof parsed !== "object" || parsed === null) {
+							return "Must be a JSON object.";
+						}
+						if (!("@type" in parsed)) {
+							return 'Must include an @type (e.g. "@type": "FAQPage").';
+						}
+						return true;
+					} catch {
+						return "Invalid JSON. Use https://jsonlint.com to debug.";
+					}
+				}),
+		}),
+	],
+	preview: {
+		select: { title: "label", subtitle: "json" },
+		prepare: ({ title, subtitle }) => {
+			let type: string | undefined;
+			if (typeof subtitle === "string") {
+				try {
+					const parsed = JSON.parse(subtitle);
+					if (parsed && typeof parsed === "object" && "@type" in parsed) {
+						type = String(parsed["@type"]);
+					}
+				} catch {
+					// ignore — render-time skips invalid blocks
+				}
+			}
+			return {
+				title: title || "Custom JSON-LD",
+				subtitle: type ? `@type: ${type}` : "JSON-LD",
+			};
+		},
+	},
+});
+
+export const pageJsonLdMembers = [
+	faqJsonLd,
+	eventJsonLd,
+	videoJsonLd,
+	jobPostingJsonLd,
+	softwareApplicationJsonLd,
+	itemListJsonLd,
+	customJsonLd,
+] as const;