Skip to content

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

6.0 KB
Raw Blame
import type { SemanticNode, SemanticNodeKind } from "@reactive-resume/resume/stylesheet/types";

export type StandardFieldRole = "primary-text" | "secondary-text" | "structured-link";
export type StandardFieldDefinition = Readonly<Record<string, readonly StandardFieldRole[]>>;

export const STANDARD_FIELD_REGISTRY = {
	summary: { content: [] },
	profiles: { network: ["primary-text"], username: ["secondary-text", "structured-link"] },
	experience: {
		company: ["primary-text"],
		position: ["secondary-text"],
		location: ["secondary-text"],
		period: ["secondary-text"],
		description: [],
	},
	"experience-role": { position: ["primary-text"], period: ["secondary-text"], description: [] },
	education: {
		school: ["primary-text"],
		area: ["secondary-text"],
		degree: ["secondary-text"],
		grade: ["secondary-text"],
		location: ["secondary-text"],
		period: ["secondary-text"],
		description: [],
	},
	projects: { name: ["primary-text"], period: ["secondary-text"], description: [] },
	skills: { name: ["primary-text"], proficiency: ["secondary-text"], keywords: ["secondary-text"] },
	languages: { language: ["primary-text"], fluency: ["secondary-text"] },
	interests: { name: ["primary-text"], keywords: ["secondary-text"] },
	awards: { title: ["primary-text"], date: ["secondary-text"], awarder: ["secondary-text"], description: [] },
	certifications: { title: ["primary-text"], date: ["secondary-text"], issuer: ["secondary-text"], description: [] },
	publications: { title: ["primary-text"], date: ["secondary-text"], publisher: ["secondary-text"], description: [] },
	volunteer: {
		organization: ["primary-text"],
		location: ["secondary-text"],
		period: ["secondary-text"],
		description: [],
	},
	references: {
		name: ["primary-text"],
		position: ["secondary-text"],
		phone: ["secondary-text"],
		description: [],
	},
	"cover-letter": { recipient: [], content: [] },
} as const satisfies Readonly<Record<string, StandardFieldDefinition>>;

export const STANDARD_ROLE_REGISTRY = [
	"primary-text",
	"secondary-text",
	"structured-link",
	"decoration",
	"section-title",
	"picture",
	"experience-role",
	"nested-role",
	"active",
	"inactive",
] as const;

export type PrimitiveBinding = {
	type: "primitive";
	primitive: "Document" | "Page" | "View" | "Text" | "Link" | "Image" | "Svg";
	source: "existing" | "synthetic";
};

type AliasBinding = {
	type: "alias";
	canonicalKind: SemanticNodeKind;
	canonicalNodeKey: string;
	token: string;
};

type SemanticBinding = PrimitiveBinding | AliasBinding;
type SemanticBindingContext = {
	parent: SemanticNode | undefined;
};
export type SemanticBindingRegistry = Readonly<
	Partial<
		Record<
			SemanticNodeKind,
			SemanticBinding | ((node: SemanticNode, context: SemanticBindingContext) => SemanticBinding | undefined)
		>
	>
>;

export type BindingInventory = {
	bindings: Readonly<Record<string, SemanticBinding>>;
};

const existing = (primitive: PrimitiveBinding["primitive"]): PrimitiveBinding => ({
	type: "primitive",
	primitive,
	source: "existing",
});

export const SHARED_BINDING_REGISTRY = {
	resume: existing("Document"),
	page: existing("Page"),
	region: existing("View"),
	header: existing("View"),
	picture: existing("Image"),
	name: existing("Text"),
	headline: existing("Text"),
	"contact-list": existing("View"),
	"contact-item": (node) => existing(node.roles.includes("structured-link") ? "Link" : "View"),
	section: existing("View"),
	"section-heading": (node) => existing(node.children.some((child) => child.kind === "icon") ? "View" : "Text"),
	"section-items": existing("View"),
	item: existing("View"),
	"item-header": existing("View"),
	"combined-text": (node, { parent }) =>
		node.attributes.owner === "parent" && parent
			? {
					type: "alias",
					canonicalKind: parent.kind,
					canonicalNodeKey: parent.key,
					token: "combined-text",
				}
			: existing("Text"),
	field: (node) => existing(node.children.some((child) => child.kind === "rich-text") ? "View" : "Text"),
	link: (_node, { parent }) =>
		parent?.kind === "contact-item"
			? {
					type: "alias",
					canonicalKind: "contact-item",
					canonicalNodeKey: parent.key,
					token: "structured-link",
				}
			: existing("Link"),
	icon: (node) => existing(node.attributes.type && node.attributes.type !== "icon" ? "View" : "Svg"),
	level: existing("View"),
	"rich-text": (_node, { parent }) =>
		parent?.kind === "field"
			? {
					type: "alias",
					canonicalKind: "field",
					canonicalNodeKey: parent.key,
					token: "rich-text",
				}
			: undefined,
	"rich-heading": existing("Text"),
	blockquote: existing("View"),
	paragraph: existing("Text"),
	list: existing("View"),
	"list-item": existing("View"),
	"list-item-content": (node) => existing(node.attributes.direction === "rtl" ? "Text" : "View"),
	"list-marker": existing("Text"),
	strong: existing("Text"),
	emphasis: existing("Text"),
	underline: existing("Text"),
	strike: existing("Text"),
	code: existing("Text"),
	"text-span": existing("Text"),
	mark: existing("Text"),
	"hard-break": existing("Text"),
	"horizontal-rule": existing("View"),
} as const satisfies SemanticBindingRegistry;

export function createBindingInventory(
	tree: SemanticNode,
	registry: SemanticBindingRegistry = SHARED_BINDING_REGISTRY,
): BindingInventory {
	const bindings: Record<string, SemanticBinding> = {};
	const nodes = new Map<string, SemanticNode>();

	const visit = (node: SemanticNode, parent?: SemanticNode) => {
		nodes.set(node.key, node);

		const declaration = registry[node.kind];
		const binding = typeof declaration === "function" ? declaration(node, { parent }) : declaration;
		if (binding) bindings[node.key] = binding;

		for (const child of node.children) visit(child, node);
	};

	visit(tree);

	for (const [nodeKey, binding] of Object.entries(bindings)) {
		if (binding.type !== "alias") continue;

		const canonicalNode = nodes.get(binding.canonicalNodeKey);
		const canonicalBinding = bindings[binding.canonicalNodeKey];
		if (
			canonicalNode?.kind !== binding.canonicalKind ||
			canonicalBinding?.type !== "primitive" ||
			canonicalBinding.source !== "existing"
		) {
			delete bindings[nodeKey];
		}
	}

	return { bindings };
}