@liiift-studio/sanity-font-manager 2.3.5 → 2.3.7

package/README.md

@@ -266,6 +266,22 @@ import { styleCountField } from '@liiift-studio/sanity-font-manager';
 styleCountField,
 ```
 
+### `stylisticSetField`
+
+A complete `stylisticSet` object field for the `stylisticSets` group. Contains two sub-arrays: `featured` (highlighted words/phrases with per-character backtick syntax, stylistic feature picker, size, and CSS overrides) and `sets` (full catalogue of feature → glyph mappings). Both include the full OpenType feature dropdown (44 named features + all 20 stylistic sets).
+
+```js
+import { stylisticSetField } from '@liiift-studio/sanity-font-manager';
+
+// In your typeface schema fields array:
+stylisticSetField,
+```
+
+Requires the `stylisticSets` group to be declared in your schema's `groups` array:
+```js
+{ name: 'stylisticSets', title: 'Stylistic Sets' }
+```
+
 ---
 
 ## Hook

package/dist/index.js

@@ -50,6 +50,7 @@ __export(index_exports, {
   VariableInstanceReferencesInput: () => VariableInstanceReferencesInput,
   addItalicToFontTitle: () => addItalicToFontTitle,
   createFontObject: () => createFontObject,
+  createStylesField: () => createStylesField,
   determineWeight: () => determineWeight,
   expandAbbreviations: () => expandAbbreviations,
   extractFontMetadata: () => extractFontMetadata,
@@ -6650,6 +6651,230 @@ var stylisticSetField = {
     }
   ]
 };
+
+// src/schema/stylesField.js
+var import_sanity_advanced_reference_array = require("sanity-advanced-reference-array");
+var fontsFilter = async ({ getClient, document, parent }) => {
+  const client = getClient({ apiVersion: "2022-11-09" });
+  const typefaceName = document.title;
+  const fonts = await client.fetch('*[_type == "font" && lower(typefaceName) == lower($typefaceName)]', { typefaceName });
+  const relatedItemsFiltered = fonts.map((f) => f._id).filter(Boolean);
+  const existingItems = parent.map((f) => f._ref).filter(Boolean);
+  return {
+    filter: "!(_id in $existingItems) && (_id in $relatedItemsFiltered)",
+    params: { existingItems, relatedItemsFiltered }
+  };
+};
+var variableFontsFilter = async ({ getClient, document, parent }) => {
+  const client = getClient({ apiVersion: "2022-11-09" });
+  const typefaceName = document.title;
+  const existingItems = parent.map((f) => f._ref).filter(Boolean);
+  const fonts = await client.fetch('*[_type == "font" && typefaceName == $typefaceName && variableFont == true]', { typefaceName });
+  const relatedItemsFiltered = fonts.map((f) => f._id).filter(Boolean);
+  return {
+    filter: "!(_id in $existingItems) && (_id in $relatedItemsFiltered)",
+    params: { existingItems, relatedItemsFiltered }
+  };
+};
+function createStylesField({
+  free = false,
+  displayStyles = true,
+  sortHeaviestFirst = false,
+  buySectionColumns = false,
+  fontSizeMultiplier = false,
+  serif = false,
+  regenerateSubfamilies: regenerateSubfamilies2 = false,
+  subfamilyFontSizeMultiplier = false,
+  subfamilyListOrder = false,
+  subfamilyPreferredStyle = false,
+  subfamilyFontFilter = false,
+  subfamilyPreview = false,
+  pairs = true
+} = {}) {
+  const subfamilyFields = [
+    {
+      title: "Title",
+      name: "title",
+      type: "string"
+    },
+    ...subfamilyFontSizeMultiplier ? [{
+      title: "Subfamily Font Size Multiplier",
+      name: "fontSizeMultiplier",
+      type: "number",
+      initialValue: 1,
+      description: "Adjust font size for this subfamily in the Family Overview (Design Space). Default is 1.0 (100%). Range: 0.5 to 2.0",
+      validation: (Rule) => Rule.min(0.5).max(2).precision(2)
+    }] : [],
+    ...subfamilyListOrder ? [{
+      title: "Use List Order",
+      name: "useListOrder",
+      type: "boolean",
+      initialValue: false,
+      description: "Display fonts in the manual order listed below, bypassing programmatic weight-based sorting in the Family Overview."
+    }] : [],
+    {
+      title: "Fonts",
+      name: "fonts",
+      type: "array",
+      components: { input: import_sanity_advanced_reference_array.AdvancedRefArray },
+      of: [{ type: "reference", weak: true, to: [{ type: "font" }] }],
+      options: {
+        sortable: true,
+        ...subfamilyFontFilter ? { filter: fontsFilter } : {}
+      }
+    },
+    ...subfamilyPreferredStyle ? [{
+      title: "SubFamily Preferred Style",
+      name: "preferredStyle",
+      type: "reference",
+      weak: true,
+      to: [{ type: "font" }],
+      options: {
+        filter: async ({ getClient, document, parent }) => {
+          const client = getClient({ apiVersion: "2022-11-09" });
+          const typefaceName = document.title;
+          const fonts = await client.fetch('*[_type == "font" && typefaceName == $typefaceName && variableFont == false]', { typefaceName });
+          const relatedItemsFiltered = fonts.map((f) => f._id).filter(Boolean);
+          const existingItems = parent.fonts.map((f) => f._ref).filter(Boolean);
+          return {
+            filter: "(_id in $existingItems) && (_id in $relatedItemsFiltered)",
+            params: { existingItems, relatedItemsFiltered }
+          };
+        }
+      }
+    }] : []
+  ];
+  const subfamilyItem = {
+    type: "object",
+    fields: subfamilyFields,
+    ...subfamilyPreview ? {
+      preview: {
+        select: { title: "title", fonts: "fonts" },
+        prepare(props) {
+          const numFonts = Object.keys(props.fonts || {}).length;
+          return { title: props.title, subtitle: `${numFonts} fonts` };
+        }
+      }
+    } : {}
+  };
+  const fields = [
+    ...free ? [{
+      title: "Free Typeface",
+      name: "free",
+      type: "boolean",
+      description: 'This typeface is free to download and use. This will alter the "Buy" button and checkout experience.',
+      initialValue: false
+    }] : [],
+    {
+      title: "Display All Styles",
+      name: "displayStyles",
+      type: "boolean",
+      initialValue: true,
+      hidden: !displayStyles,
+      description: "Show all Font Styles below collections in Buy Section"
+    },
+    ...sortHeaviestFirst ? [{
+      title: "Sort Fonts Heaviest to Lightest",
+      name: "sortHeaviestFirst",
+      type: "boolean",
+      initialValue: false,
+      description: "Sort fonts by weight from heaviest (900) to lightest (100). Default is lightest to heaviest (industry standard)."
+    }] : [],
+    ...buySectionColumns ? [{
+      title: "Multi Column Buy Section",
+      name: "buySectionColumns",
+      type: "boolean",
+      initialValue: true,
+      description: "Choose Single Column or Multi Column for the Buy Section, Default is Multi Column"
+    }] : [],
+    ...fontSizeMultiplier ? [{
+      title: "Style Grid Font Size Multiplier",
+      name: "fontSizeMultiplier",
+      type: "number",
+      initialValue: 1,
+      description: "Adjust font size in the buy section style grid. Default is 1.0 (100%). Range: 0.5 to 2.0",
+      validation: (Rule) => Rule.min(0.5).max(2).precision(2)
+    }] : [],
+    ...serif ? [{
+      title: "Includes Serifs",
+      name: "serif",
+      type: "boolean",
+      initialValue: false,
+      description: "Check if this typeface includes serif letterforms. Used for typeface overview serif/sans filters. Frontend automatically treats non-serif typefaces as sans serif."
+    }] : [],
+    {
+      title: "Fonts",
+      name: "fonts",
+      type: "array",
+      components: { input: import_sanity_advanced_reference_array.AdvancedRefArray },
+      of: [{
+        type: "reference",
+        weak: true,
+        to: [{ type: "font" }],
+        options: { filter: fontsFilter }
+      }],
+      options: { sortable: true }
+    },
+    {
+      title: "Variable Fonts",
+      name: "variableFont",
+      type: "array",
+      components: { input: import_sanity_advanced_reference_array.AdvancedRefArray },
+      of: [{
+        type: "reference",
+        weak: true,
+        to: [{ type: "font" }],
+        options: { filter: variableFontsFilter }
+      }],
+      description: "Variable fonts are automatically included as a bonus when customers purchase all non-variable styles of this typeface.",
+      options: { sortable: true }
+    },
+    ...regenerateSubfamilies2 ? [{
+      title: "Regenerate Subfamilies",
+      name: "regenerateSubfamilies",
+      type: "string",
+      hidden: ({ parent }) => {
+        var _a, _b, _c, _d;
+        return ((_b = (_a = parent == null ? void 0 : parent.styles) == null ? void 0 : _a.subfamilies) == null ? void 0 : _b.length) === 0 || ((_d = (_c = parent == null ? void 0 : parent.styles) == null ? void 0 : _c.fonts) == null ? void 0 : _d.length) === 0;
+      },
+      description: "Regenerates subfamily groups based on the fonts in this typeface.",
+      components: { input: RegenerateSubfamiliesComponent }
+    }] : [],
+    {
+      title: "Sub Families",
+      name: "subfamilies",
+      type: "array",
+      of: [subfamilyItem]
+    },
+    {
+      title: "Collections",
+      name: "collections",
+      type: "array",
+      components: { input: import_sanity_advanced_reference_array.AdvancedRefArray },
+      of: [{ type: "reference", weak: true, to: [{ type: "collection" }] }],
+      options: { sortable: true },
+      validation: (Rule) => Rule.unique()
+    },
+    {
+      title: "Pairs",
+      name: "pairs",
+      type: "array",
+      components: { input: import_sanity_advanced_reference_array.AdvancedRefArray },
+      of: [{ type: "reference", weak: true, to: [{ type: "pair" }] }],
+      options: { sortable: true },
+      validation: (Rule) => Rule.unique(),
+      hidden: !pairs
+    }
+  ];
+  return {
+    title: "Styles",
+    name: "styles",
+    type: "object",
+    group: "styles",
+    fields,
+    options: { collapsible: true }
+  };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   BatchUploadFonts,
@@ -6673,6 +6898,7 @@ var stylisticSetField = {
   VariableInstanceReferencesInput,
   addItalicToFontTitle,
   createFontObject,
+  createStylesField,
   determineWeight,
   expandAbbreviations,
   extractFontMetadata,

package/dist/index.mjs

@@ -6565,6 +6565,230 @@ var stylisticSetField = {
     }
   ]
 };
+
+// src/schema/stylesField.js
+import { AdvancedRefArray } from "sanity-advanced-reference-array";
+var fontsFilter = async ({ getClient, document, parent }) => {
+  const client = getClient({ apiVersion: "2022-11-09" });
+  const typefaceName = document.title;
+  const fonts = await client.fetch('*[_type == "font" && lower(typefaceName) == lower($typefaceName)]', { typefaceName });
+  const relatedItemsFiltered = fonts.map((f) => f._id).filter(Boolean);
+  const existingItems = parent.map((f) => f._ref).filter(Boolean);
+  return {
+    filter: "!(_id in $existingItems) && (_id in $relatedItemsFiltered)",
+    params: { existingItems, relatedItemsFiltered }
+  };
+};
+var variableFontsFilter = async ({ getClient, document, parent }) => {
+  const client = getClient({ apiVersion: "2022-11-09" });
+  const typefaceName = document.title;
+  const existingItems = parent.map((f) => f._ref).filter(Boolean);
+  const fonts = await client.fetch('*[_type == "font" && typefaceName == $typefaceName && variableFont == true]', { typefaceName });
+  const relatedItemsFiltered = fonts.map((f) => f._id).filter(Boolean);
+  return {
+    filter: "!(_id in $existingItems) && (_id in $relatedItemsFiltered)",
+    params: { existingItems, relatedItemsFiltered }
+  };
+};
+function createStylesField({
+  free = false,
+  displayStyles = true,
+  sortHeaviestFirst = false,
+  buySectionColumns = false,
+  fontSizeMultiplier = false,
+  serif = false,
+  regenerateSubfamilies: regenerateSubfamilies2 = false,
+  subfamilyFontSizeMultiplier = false,
+  subfamilyListOrder = false,
+  subfamilyPreferredStyle = false,
+  subfamilyFontFilter = false,
+  subfamilyPreview = false,
+  pairs = true
+} = {}) {
+  const subfamilyFields = [
+    {
+      title: "Title",
+      name: "title",
+      type: "string"
+    },
+    ...subfamilyFontSizeMultiplier ? [{
+      title: "Subfamily Font Size Multiplier",
+      name: "fontSizeMultiplier",
+      type: "number",
+      initialValue: 1,
+      description: "Adjust font size for this subfamily in the Family Overview (Design Space). Default is 1.0 (100%). Range: 0.5 to 2.0",
+      validation: (Rule) => Rule.min(0.5).max(2).precision(2)
+    }] : [],
+    ...subfamilyListOrder ? [{
+      title: "Use List Order",
+      name: "useListOrder",
+      type: "boolean",
+      initialValue: false,
+      description: "Display fonts in the manual order listed below, bypassing programmatic weight-based sorting in the Family Overview."
+    }] : [],
+    {
+      title: "Fonts",
+      name: "fonts",
+      type: "array",
+      components: { input: AdvancedRefArray },
+      of: [{ type: "reference", weak: true, to: [{ type: "font" }] }],
+      options: {
+        sortable: true,
+        ...subfamilyFontFilter ? { filter: fontsFilter } : {}
+      }
+    },
+    ...subfamilyPreferredStyle ? [{
+      title: "SubFamily Preferred Style",
+      name: "preferredStyle",
+      type: "reference",
+      weak: true,
+      to: [{ type: "font" }],
+      options: {
+        filter: async ({ getClient, document, parent }) => {
+          const client = getClient({ apiVersion: "2022-11-09" });
+          const typefaceName = document.title;
+          const fonts = await client.fetch('*[_type == "font" && typefaceName == $typefaceName && variableFont == false]', { typefaceName });
+          const relatedItemsFiltered = fonts.map((f) => f._id).filter(Boolean);
+          const existingItems = parent.fonts.map((f) => f._ref).filter(Boolean);
+          return {
+            filter: "(_id in $existingItems) && (_id in $relatedItemsFiltered)",
+            params: { existingItems, relatedItemsFiltered }
+          };
+        }
+      }
+    }] : []
+  ];
+  const subfamilyItem = {
+    type: "object",
+    fields: subfamilyFields,
+    ...subfamilyPreview ? {
+      preview: {
+        select: { title: "title", fonts: "fonts" },
+        prepare(props) {
+          const numFonts = Object.keys(props.fonts || {}).length;
+          return { title: props.title, subtitle: `${numFonts} fonts` };
+        }
+      }
+    } : {}
+  };
+  const fields = [
+    ...free ? [{
+      title: "Free Typeface",
+      name: "free",
+      type: "boolean",
+      description: 'This typeface is free to download and use. This will alter the "Buy" button and checkout experience.',
+      initialValue: false
+    }] : [],
+    {
+      title: "Display All Styles",
+      name: "displayStyles",
+      type: "boolean",
+      initialValue: true,
+      hidden: !displayStyles,
+      description: "Show all Font Styles below collections in Buy Section"
+    },
+    ...sortHeaviestFirst ? [{
+      title: "Sort Fonts Heaviest to Lightest",
+      name: "sortHeaviestFirst",
+      type: "boolean",
+      initialValue: false,
+      description: "Sort fonts by weight from heaviest (900) to lightest (100). Default is lightest to heaviest (industry standard)."
+    }] : [],
+    ...buySectionColumns ? [{
+      title: "Multi Column Buy Section",
+      name: "buySectionColumns",
+      type: "boolean",
+      initialValue: true,
+      description: "Choose Single Column or Multi Column for the Buy Section, Default is Multi Column"
+    }] : [],
+    ...fontSizeMultiplier ? [{
+      title: "Style Grid Font Size Multiplier",
+      name: "fontSizeMultiplier",
+      type: "number",
+      initialValue: 1,
+      description: "Adjust font size in the buy section style grid. Default is 1.0 (100%). Range: 0.5 to 2.0",
+      validation: (Rule) => Rule.min(0.5).max(2).precision(2)
+    }] : [],
+    ...serif ? [{
+      title: "Includes Serifs",
+      name: "serif",
+      type: "boolean",
+      initialValue: false,
+      description: "Check if this typeface includes serif letterforms. Used for typeface overview serif/sans filters. Frontend automatically treats non-serif typefaces as sans serif."
+    }] : [],
+    {
+      title: "Fonts",
+      name: "fonts",
+      type: "array",
+      components: { input: AdvancedRefArray },
+      of: [{
+        type: "reference",
+        weak: true,
+        to: [{ type: "font" }],
+        options: { filter: fontsFilter }
+      }],
+      options: { sortable: true }
+    },
+    {
+      title: "Variable Fonts",
+      name: "variableFont",
+      type: "array",
+      components: { input: AdvancedRefArray },
+      of: [{
+        type: "reference",
+        weak: true,
+        to: [{ type: "font" }],
+        options: { filter: variableFontsFilter }
+      }],
+      description: "Variable fonts are automatically included as a bonus when customers purchase all non-variable styles of this typeface.",
+      options: { sortable: true }
+    },
+    ...regenerateSubfamilies2 ? [{
+      title: "Regenerate Subfamilies",
+      name: "regenerateSubfamilies",
+      type: "string",
+      hidden: ({ parent }) => {
+        var _a, _b, _c, _d;
+        return ((_b = (_a = parent == null ? void 0 : parent.styles) == null ? void 0 : _a.subfamilies) == null ? void 0 : _b.length) === 0 || ((_d = (_c = parent == null ? void 0 : parent.styles) == null ? void 0 : _c.fonts) == null ? void 0 : _d.length) === 0;
+      },
+      description: "Regenerates subfamily groups based on the fonts in this typeface.",
+      components: { input: RegenerateSubfamiliesComponent }
+    }] : [],
+    {
+      title: "Sub Families",
+      name: "subfamilies",
+      type: "array",
+      of: [subfamilyItem]
+    },
+    {
+      title: "Collections",
+      name: "collections",
+      type: "array",
+      components: { input: AdvancedRefArray },
+      of: [{ type: "reference", weak: true, to: [{ type: "collection" }] }],
+      options: { sortable: true },
+      validation: (Rule) => Rule.unique()
+    },
+    {
+      title: "Pairs",
+      name: "pairs",
+      type: "array",
+      components: { input: AdvancedRefArray },
+      of: [{ type: "reference", weak: true, to: [{ type: "pair" }] }],
+      options: { sortable: true },
+      validation: (Rule) => Rule.unique(),
+      hidden: !pairs
+    }
+  ];
+  return {
+    title: "Styles",
+    name: "styles",
+    type: "object",
+    group: "styles",
+    fields,
+    options: { collapsible: true }
+  };
+}
 export {
   BatchUploadFonts,
   FontScriptUploaderComponent,
@@ -6587,6 +6811,7 @@ export {
   VariableInstanceReferencesInput,
   addItalicToFontTitle,
   createFontObject,
+  createStylesField,
   determineWeight,
   expandAbbreviations,
   extractFontMetadata,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@liiift-studio/sanity-font-manager",
-	"version": "2.3.5",
+	"version": "2.3.7",
 	"description": "Sanity Studio plugin — full font management suite with batch upload, format conversion, metadata extraction, CSS generation, collection/pair generation, and script variant support. Supports Sanity v3, v4, and v5.",
 	"license": "MIT",
 	"author": "Liiift Studio",
@@ -59,7 +59,13 @@
 		"@sanity/icons": ">=3",
 		"@sanity/ui": ">=3",
 		"react": ">=18",
-		"sanity": ">=3"
+		"sanity": ">=3",
+		"sanity-advanced-reference-array": ">=1"
+	},
+	"peerDependenciesMeta": {
+		"sanity-advanced-reference-array": {
+			"optional": true
+		}
 	},
 	"devDependencies": {
 		"@sanity/icons": "^3",

package/src/index.js

@@ -57,6 +57,7 @@ export { sanitizeForSanityId } from './utils/sanitizeForSanityId.js';
 export { openTypeField } from './schema/openTypeField.js';
 export { styleCountField } from './schema/styleCountField.js';
 export { stylisticSetField } from './schema/stylisticSetField.js';
+export { createStylesField } from './schema/stylesField.js';
 
 // Keyword utilities
 export {

package/src/schema/stylesField.js

@@ -0,0 +1,250 @@
+// Sanity schema factory function for the Styles object field — call createStylesField(options) to generate the field definition for a typeface document
+import { AdvancedRefArray } from 'sanity-advanced-reference-array';
+import { RegenerateSubfamiliesComponent } from '../components/RegenerateSubfamiliesComponent.jsx';
+
+// Shared GROQ filter — returns fonts from the same typeface, excluding items already in the array
+const fontsFilter = async ({ getClient, document, parent }) => {
+	const client = getClient({ apiVersion: '2022-11-09' });
+	const typefaceName = document.title;
+	const fonts = await client.fetch('*[_type == "font" && lower(typefaceName) == lower($typefaceName)]', { typefaceName });
+	const relatedItemsFiltered = fonts.map(f => f._id).filter(Boolean);
+	const existingItems = parent.map(f => f._ref).filter(Boolean);
+	return {
+		filter: '!(_id in $existingItems) && (_id in $relatedItemsFiltered)',
+		params: { existingItems, relatedItemsFiltered },
+	};
+};
+
+// Shared GROQ filter — returns variable fonts from the same typeface, excluding items already in the array
+const variableFontsFilter = async ({ getClient, document, parent }) => {
+	const client = getClient({ apiVersion: '2022-11-09' });
+	const typefaceName = document.title;
+	const existingItems = parent.map(f => f._ref).filter(Boolean);
+	const fonts = await client.fetch('*[_type == "font" && typefaceName == $typefaceName && variableFont == true]', { typefaceName });
+	const relatedItemsFiltered = fonts.map(f => f._id).filter(Boolean);
+	return {
+		filter: '!(_id in $existingItems) && (_id in $relatedItemsFiltered)',
+		params: { existingItems, relatedItemsFiltered },
+	};
+};
+
+/**
+ * Generates the Styles object field for a typeface document with configurable per-site options.
+ * @param {Object} options
+ * @param {boolean} [options.free=false] - Add a "Free Typeface" boolean field
+ * @param {boolean} [options.displayStyles=true] - Show the "Display All Styles" toggle to editors (false = hidden)
+ * @param {boolean} [options.sortHeaviestFirst=false] - Add sort order toggle (heaviest to lightest)
+ * @param {boolean} [options.buySectionColumns=false] - Add multi-column buy section toggle
+ * @param {boolean} [options.fontSizeMultiplier=false] - Add style grid font size multiplier
+ * @param {boolean} [options.serif=false] - Add serif/sans classification flag
+ * @param {boolean} [options.regenerateSubfamilies=false] - Add the RegenerateSubfamilies action field
+ * @param {boolean} [options.subfamilyFontSizeMultiplier=false] - Add per-subfamily font size multiplier
+ * @param {boolean} [options.subfamilyListOrder=false] - Add per-subfamily manual order toggle
+ * @param {boolean} [options.subfamilyPreferredStyle=false] - Add per-subfamily preferred style reference
+ * @param {boolean} [options.subfamilyFontFilter=false] - Filter subfamily font picker to typeface fonts only
+ * @param {boolean} [options.subfamilyPreview=false] - Add preview to subfamily array items showing font count
+ * @param {boolean} [options.pairs=true] - Show the pairs array to editors (false = hidden)
+ */
+export function createStylesField({
+	free = false,
+	displayStyles = true,
+	sortHeaviestFirst = false,
+	buySectionColumns = false,
+	fontSizeMultiplier = false,
+	serif = false,
+	regenerateSubfamilies = false,
+	subfamilyFontSizeMultiplier = false,
+	subfamilyListOrder = false,
+	subfamilyPreferredStyle = false,
+	subfamilyFontFilter = false,
+	subfamilyPreview = false,
+	pairs = true,
+} = {}) {
+
+	// Build the subfamily object item fields conditionally
+	const subfamilyFields = [
+		{
+			title: 'Title',
+			name: 'title',
+			type: 'string',
+		},
+		...(subfamilyFontSizeMultiplier ? [{
+			title: 'Subfamily Font Size Multiplier',
+			name: 'fontSizeMultiplier',
+			type: 'number',
+			initialValue: 1.0,
+			description: 'Adjust font size for this subfamily in the Family Overview (Design Space). Default is 1.0 (100%). Range: 0.5 to 2.0',
+			validation: Rule => Rule.min(0.5).max(2.0).precision(2),
+		}] : []),
+		...(subfamilyListOrder ? [{
+			title: 'Use List Order',
+			name: 'useListOrder',
+			type: 'boolean',
+			initialValue: false,
+			description: 'Display fonts in the manual order listed below, bypassing programmatic weight-based sorting in the Family Overview.',
+		}] : []),
+		{
+			title: 'Fonts',
+			name: 'fonts',
+			type: 'array',
+			components: { input: AdvancedRefArray },
+			of: [{ type: 'reference', weak: true, to: [{ type: 'font' }] }],
+			options: {
+				sortable: true,
+				...(subfamilyFontFilter ? { filter: fontsFilter } : {}),
+			},
+		},
+		...(subfamilyPreferredStyle ? [{
+			title: 'SubFamily Preferred Style',
+			name: 'preferredStyle',
+			type: 'reference',
+			weak: true,
+			to: [{ type: 'font' }],
+			options: {
+				filter: async ({ getClient, document, parent }) => {
+					const client = getClient({ apiVersion: '2022-11-09' });
+					const typefaceName = document.title;
+					const fonts = await client.fetch('*[_type == "font" && typefaceName == $typefaceName && variableFont == false]', { typefaceName });
+					const relatedItemsFiltered = fonts.map(f => f._id).filter(Boolean);
+					const existingItems = parent.fonts.map(f => f._ref).filter(Boolean);
+					return {
+						filter: '(_id in $existingItems) && (_id in $relatedItemsFiltered)',
+						params: { existingItems, relatedItemsFiltered },
+					};
+				},
+			},
+		}] : []),
+	];
+
+	const subfamilyItem = {
+		type: 'object',
+		fields: subfamilyFields,
+		...(subfamilyPreview ? {
+			preview: {
+				select: { title: 'title', fonts: 'fonts' },
+				prepare(props) {
+					const numFonts = Object.keys(props.fonts || {}).length;
+					return { title: props.title, subtitle: `${numFonts} fonts` };
+				},
+			},
+		} : {}),
+	};
+
+	const fields = [
+		...(free ? [{
+			title: 'Free Typeface',
+			name: 'free',
+			type: 'boolean',
+			description: 'This typeface is free to download and use. This will alter the "Buy" button and checkout experience.',
+			initialValue: false,
+		}] : []),
+		{
+			title: 'Display All Styles',
+			name: 'displayStyles',
+			type: 'boolean',
+			initialValue: true,
+			hidden: !displayStyles,
+			description: 'Show all Font Styles below collections in Buy Section',
+		},
+		...(sortHeaviestFirst ? [{
+			title: 'Sort Fonts Heaviest to Lightest',
+			name: 'sortHeaviestFirst',
+			type: 'boolean',
+			initialValue: false,
+			description: 'Sort fonts by weight from heaviest (900) to lightest (100). Default is lightest to heaviest (industry standard).',
+		}] : []),
+		...(buySectionColumns ? [{
+			title: 'Multi Column Buy Section',
+			name: 'buySectionColumns',
+			type: 'boolean',
+			initialValue: true,
+			description: 'Choose Single Column or Multi Column for the Buy Section, Default is Multi Column',
+		}] : []),
+		...(fontSizeMultiplier ? [{
+			title: 'Style Grid Font Size Multiplier',
+			name: 'fontSizeMultiplier',
+			type: 'number',
+			initialValue: 1.0,
+			description: 'Adjust font size in the buy section style grid. Default is 1.0 (100%). Range: 0.5 to 2.0',
+			validation: Rule => Rule.min(0.5).max(2.0).precision(2),
+		}] : []),
+		...(serif ? [{
+			title: 'Includes Serifs',
+			name: 'serif',
+			type: 'boolean',
+			initialValue: false,
+			description: 'Check if this typeface includes serif letterforms. Used for typeface overview serif/sans filters. Frontend automatically treats non-serif typefaces as sans serif.',
+		}] : []),
+		{
+			title: 'Fonts',
+			name: 'fonts',
+			type: 'array',
+			components: { input: AdvancedRefArray },
+			of: [{
+				type: 'reference',
+				weak: true,
+				to: [{ type: 'font' }],
+				options: { filter: fontsFilter },
+			}],
+			options: { sortable: true },
+		},
+		{
+			title: 'Variable Fonts',
+			name: 'variableFont',
+			type: 'array',
+			components: { input: AdvancedRefArray },
+			of: [{
+				type: 'reference',
+				weak: true,
+				to: [{ type: 'font' }],
+				options: { filter: variableFontsFilter },
+			}],
+			description: 'Variable fonts are automatically included as a bonus when customers purchase all non-variable styles of this typeface.',
+			options: { sortable: true },
+		},
+		...(regenerateSubfamilies ? [{
+			title: 'Regenerate Subfamilies',
+			name: 'regenerateSubfamilies',
+			type: 'string',
+			hidden: ({ parent }) => {
+				return parent?.styles?.subfamilies?.length === 0 || parent?.styles?.fonts?.length === 0;
+			},
+			description: 'Regenerates subfamily groups based on the fonts in this typeface.',
+			components: { input: RegenerateSubfamiliesComponent },
+		}] : []),
+		{
+			title: 'Sub Families',
+			name: 'subfamilies',
+			type: 'array',
+			of: [subfamilyItem],
+		},
+		{
+			title: 'Collections',
+			name: 'collections',
+			type: 'array',
+			components: { input: AdvancedRefArray },
+			of: [{ type: 'reference', weak: true, to: [{ type: 'collection' }] }],
+			options: { sortable: true },
+			validation: Rule => Rule.unique(),
+		},
+		{
+			title: 'Pairs',
+			name: 'pairs',
+			type: 'array',
+			components: { input: AdvancedRefArray },
+			of: [{ type: 'reference', weak: true, to: [{ type: 'pair' }] }],
+			options: { sortable: true },
+			validation: Rule => Rule.unique(),
+			hidden: !pairs,
+		},
+	];
+
+	return {
+		title: 'Styles',
+		name: 'styles',
+		type: 'object',
+		group: 'styles',
+		fields,
+		options: { collapsible: true },
+	};
+}