@liiift-studio/sanity-font-manager 2.7.1 → 2.9.0

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@liiift-studio/sanity-font-manager",
-	"version": "2.7.1",
+	"version": "2.9.0",
 	"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",
@@ -50,7 +50,9 @@
 		"link:all": "npm link && cd ../../../sites/darden/sanity && npm link @liiift-studio/sanity-font-manager && cd ../../tdf/sanity && npm link @liiift-studio/sanity-font-manager && cd ../../mckl/cms && npm link @liiift-studio/sanity-font-manager"
 	},
 	"dependencies": {
+		"@liiift-studio/cedars-engine": "^1.0.0",
 		"base-64": "^1.0.0",
+		"lib-font": "^3.0.1",
 		"nanoid": "^5.0.0",
 		"slugify": "^1.6.6"
 	},

package/src/index.js

@@ -110,6 +110,10 @@ export { openTypeField, createOpenTypeField } from './schema/openTypeField.js';
 export { styleCountField } from './schema/styleCountField.js';
 export { stylisticSetField } from './schema/stylisticSetField.js';
 export { createStylesField } from './schema/stylesField.js';
+export { cedarsProfileField, createCedarsProfileField } from './schema/cedarsProfileField.js';
+
+// CEDARS+ profile computation (auto-tags typefaces on upload)
+export { computeCedarsProfile } from './utils/computeCedarsProfile.js';
 
 // Keyword utilities
 export {

package/src/schema/cedarsProfileField.js

@@ -0,0 +1,82 @@
+// Sanity schema field for the auto-computed CEDARS+ typographic profile.
+// Read-only; populated on font upload by computeCedarsProfile (see utils).
+
+// The six CEDARS axes, in canonical order — shared by the scores and labels groups.
+const AXES = ['contrast', 'energy', 'details', 'axis', 'rhythm', 'structure'];
+
+// Build a title-cased label from an axis key (e.g. 'contrast' -> 'Contrast').
+function titleCase(key) {
+	return key.charAt(0).toUpperCase() + key.slice(1);
+}
+
+// Number sub-fields (0..100) for each axis, used by the scores group.
+const scoreFields = AXES.map((key) => ({
+	title: titleCase(key),
+	name: key,
+	type: 'number',
+}));
+
+// String sub-fields (human-readable descriptor) for each axis, used by the labels group.
+const labelFields = AXES.map((key) => ({
+	title: titleCase(key),
+	name: key,
+	type: 'string',
+}));
+
+// The CEDARS+ profile field definition. Attach to a `font` document schema.
+export const cedarsProfileField = {
+	title: 'CEDARS+ Profile',
+	name: 'cedarsPlus',
+	type: 'object',
+	description:
+		'Auto-computed typographic profile from the font outlines — Contrast, Energy, Details, Axis, Rhythm, Structure (0–100 each). Read-only; set on upload.',
+	readOnly: true,
+	options: { collapsible: true, collapsed: true },
+	fields: [
+		{
+			title: 'Scores',
+			name: 'scores',
+			type: 'object',
+			options: { collapsible: true, collapsed: false },
+			fields: scoreFields,
+		},
+		{
+			title: 'Labels',
+			name: 'labels',
+			type: 'object',
+			options: { collapsible: true, collapsed: true },
+			fields: labelFields,
+		},
+		{
+			title: '+ Descriptors',
+			name: 'plus',
+			type: 'object',
+			options: { collapsible: true, collapsed: true },
+			fields: [
+				{ title: 'x-height / cap-height', name: 'xHeightRatio', type: 'number' },
+				{ title: 'cap-height / em', name: 'capHeightRatio', type: 'number' },
+				{ title: 'Monospaced', name: 'isMonospaced', type: 'boolean' },
+			],
+		},
+		{
+			// Normalized [C,E,D,A,R,S] 0..1 vector — kept for similarity search / export.
+			title: 'Vector',
+			name: 'vector',
+			type: 'array',
+			of: [{ type: 'number' }],
+		},
+	],
+};
+
+/**
+ * Factory to create a customised CEDARS+ profile field.
+ * @param {object} [options]
+ * @param {boolean} [options.readOnly=true] - Whether the field is read-only in the Studio.
+ * @param {string} [options.group] - Optional field group to assign the field to.
+ * @returns {object} Sanity field definition
+ */
+export function createCedarsProfileField({ readOnly = true, group } = {}) {
+	const field = { ...cedarsProfileField, readOnly };
+	if (group) field.group = group;
+	return field;
+}

package/src/utils/computeCedarsProfile.js

@@ -0,0 +1,19 @@
+// Computes a font's CEDARS+ profile from its raw bytes, shaped for the Sanity
+// `cedarsPlus` field. Thin wrapper around @liiift-studio/cedars-engine.
+import { analyzeFont } from '@liiift-studio/cedars-engine';
+
+/**
+ * Compute the CEDARS+ profile (Contrast, Energy, Details, Axis, Rhythm, Structure)
+ * for a font from its raw outline geometry.
+ * @param {ArrayBuffer} buffer - The font file bytes (OTF/TTF/WOFF).
+ * @returns {{ scores: object, labels: object, plus: object, vector: number[] }}
+ */
+export function computeCedarsProfile(buffer) {
+	const profile = analyzeFont(buffer);
+	return {
+		scores: profile.scores,
+		labels: profile.labels,
+		plus: profile.plus,
+		vector: profile.vector,
+	};
+}

package/src/utils/generateFontData.js

@@ -1,6 +1,7 @@
 // Extracts metadata, metrics, glyph count, OpenType features, and variable axes from a font and optionally patches the Sanity font document
 
 import { parseFont } from './parseFont';
+import { computeCedarsProfile } from './computeCedarsProfile';
 import {
 	getFontMetadata,
 	getFontMetrics,
@@ -43,10 +44,12 @@ export default async function generateFontData({ fileInput, url, fontKit, fontId
 	}
 
 	let font = fontKit;
+	// Hoisted so the CEDARS+ step below can reuse the raw bytes when we fetched them.
+	let fontBuffer = null;
 	if (!fontKit || fontKit == null) {
-		let buffer = await fetch(srcUrl);
-		buffer = await buffer.arrayBuffer();
-		font = await parseFont(buffer, `${fontId}.ttf`);
+		const res = await fetch(srcUrl);
+		fontBuffer = await res.arrayBuffer();
+		font = await parseFont(fontBuffer, `${fontId}.ttf`);
 	}
 
 	const variableAxes = getVariationAxes(font);
@@ -81,6 +84,19 @@ export default async function generateFontData({ fileInput, url, fontKit, fontId
 		variableFont = true;
 	}
 
+	// CEDARS+ profile — best-effort enrichment. Wrapped so a failure here can never
+	// block the font upload; the raw bytes are fetched only if we don't already have them.
+	let cedarsPlus = null;
+	try {
+		if (!fontBuffer) {
+			const res = await fetch(srcUrl);
+			fontBuffer = await res.arrayBuffer();
+		}
+		cedarsPlus = computeCedarsProfile(fontBuffer);
+	} catch (err) {
+		console.warn('CEDARS profile computation failed:', err?.message || err);
+	}
+
 	let patch = {
 		metrics: metrics,
 		metaData: metaData,
@@ -90,6 +106,7 @@ export default async function generateFontData({ fileInput, url, fontKit, fontId
 		glyphCount: glyphCount,
 		opentypeFeatures: { chars: opentypeFeatures },
 		characterSet: { chars: characterSet },
+		...(cedarsPlus ? { cedarsPlus } : {}),
 	};
 
 	console.log('Font data patch:', Object.keys(patch));