@homepages/template-kit 0.0.0 → 0.1.0

package/dist/contracts/slot-catalog.d.ts

@@ -0,0 +1,237 @@
+//#region src/contracts/slot-catalog.d.ts
+declare const CONTENT_SLOT_TYPES: readonly ["text", "number", "select", "image", "image_collection", "list", "object_list", "poi_list", "url"];
+declare const REF_SLOT_TYPES: readonly [];
+declare const SLOT_TYPES: readonly ["text", "number", "select", "image", "image_collection", "list", "object_list", "poi_list", "url"];
+type ContentSlotType = (typeof CONTENT_SLOT_TYPES)[number];
+type RefSlotType = (typeof REF_SLOT_TYPES)[number];
+type SlotType = (typeof SLOT_TYPES)[number];
+declare const REFERRAL_FIELDS: readonly ["name", "title", "email", "phone", "website", "instagram", "linkedin", "x", "facebook", "headshot", "logo_dark", "logo_light"];
+type ReferralField = (typeof REFERRAL_FIELDS)[number];
+declare const REFERRAL_IMAGE_FIELDS: readonly ["headshot", "logo_dark", "logo_light"];
+type ReferralImageField = (typeof REFERRAL_IMAGE_FIELDS)[number];
+type SourceFieldContainer = "property" | "unit" | "contact";
+type SourceFieldValueType = "text" | "number" | "image" | "coordinates" | "unit_list" | "contact_list";
+type WritebackTarget = {
+  kind: "property";
+  column: "listing_intent";
+} | {
+  kind: "unit";
+  column: "unit_label" | "beds" | "baths" | "sqft" | "price";
+} | {
+  kind: "contact";
+  field: string;
+};
+type SourceFieldDescriptor = {
+  container: SourceFieldContainer;
+  value_type: SourceFieldValueType;
+  image?: true;
+  writeback?: WritebackTarget;
+};
+declare const SOURCE_FIELDS: {
+  address: {
+    container: "property";
+    value_type: "text";
+  };
+  listing_intent: {
+    container: "property";
+    value_type: "text";
+    writeback: {
+      kind: "property";
+      column: "listing_intent";
+    };
+  };
+  status: {
+    container: "property";
+    value_type: "text";
+  };
+  property_type: {
+    container: "property";
+    value_type: "text";
+  };
+  year_built: {
+    container: "property";
+    value_type: "number";
+  };
+  lot_size: {
+    container: "property";
+    value_type: "text";
+  };
+  unit_label: {
+    container: "unit";
+    value_type: "text";
+    writeback: {
+      kind: "unit";
+      column: "unit_label";
+    };
+  };
+  beds: {
+    container: "unit";
+    value_type: "number";
+    writeback: {
+      kind: "unit";
+      column: "beds";
+    };
+  };
+  baths: {
+    container: "unit";
+    value_type: "number";
+    writeback: {
+      kind: "unit";
+      column: "baths";
+    };
+  };
+  sqft: {
+    container: "unit";
+    value_type: "number";
+    writeback: {
+      kind: "unit";
+      column: "sqft";
+    };
+  };
+  price: {
+    container: "unit";
+    value_type: "text";
+    writeback: {
+      kind: "unit";
+      column: "price";
+    };
+  };
+  notes: {
+    container: "unit";
+    value_type: "text";
+  };
+  units: {
+    container: "property";
+    value_type: "unit_list";
+  };
+  contacts: {
+    container: "property";
+    value_type: "contact_list";
+  };
+  name: {
+    container: "contact";
+    value_type: "text";
+    writeback: {
+      kind: "contact";
+      field: string;
+    };
+  };
+  title: {
+    container: "contact";
+    value_type: "text";
+    writeback: {
+      kind: "contact";
+      field: string;
+    };
+  };
+  bio: {
+    container: "contact";
+    value_type: "text";
+    writeback: {
+      kind: "contact";
+      field: string;
+    };
+  };
+  email: {
+    container: "contact";
+    value_type: "text";
+    writeback: {
+      kind: "contact";
+      field: string;
+    };
+  };
+  phone: {
+    container: "contact";
+    value_type: "text";
+    writeback: {
+      kind: "contact";
+      field: string;
+    };
+  };
+  website: {
+    container: "contact";
+    value_type: "text";
+    writeback: {
+      kind: "contact";
+      field: string;
+    };
+  };
+  instagram: {
+    container: "contact";
+    value_type: "text";
+    writeback: {
+      kind: "contact";
+      field: string;
+    };
+  };
+  linkedin: {
+    container: "contact";
+    value_type: "text";
+    writeback: {
+      kind: "contact";
+      field: string;
+    };
+  };
+  x: {
+    container: "contact";
+    value_type: "text";
+    writeback: {
+      kind: "contact";
+      field: string;
+    };
+  };
+  facebook: {
+    container: "contact";
+    value_type: "text";
+    writeback: {
+      kind: "contact";
+      field: string;
+    };
+  };
+  headshot: {
+    container: "contact";
+    value_type: "image";
+    image: true;
+  };
+  logo_dark: {
+    container: "contact";
+    value_type: "image";
+    image: true;
+  };
+  logo_light: {
+    container: "contact";
+    value_type: "image";
+    image: true;
+  };
+};
+type SourceFieldName = keyof typeof SOURCE_FIELDS;
+declare const COLLECTIONS: {
+  readonly units: {
+    readonly idKey: "unit_id";
+    readonly ownership: "property";
+  };
+  readonly contacts: {
+    readonly idKey: "id";
+    readonly cap: 12;
+    readonly min: 1;
+    readonly ownership: "library";
+  };
+};
+type CollectionField = keyof typeof COLLECTIONS;
+type CollectionIdKey = (typeof COLLECTIONS)[CollectionField]["idKey"];
+type CollectionOwnership = (typeof COLLECTIONS)[CollectionField]["ownership"];
+declare function collectionForSlot(slot: {
+  type?: string;
+  source?: {
+    kind?: string;
+    field?: string;
+  };
+}): CollectionField | null;
+declare const DERIVED_INPUT_FIELDS: readonly ["units", "address_line_parts", "contact_address_parts", "coordinates", "clock"];
+type DerivedInputName = (typeof DERIVED_INPUT_FIELDS)[number];
+declare const DECISION_TYPES: readonly ["image-assign", "image-collection", "text-block", "text-seed", "list-extract", "structured-list"];
+type DecisionType = (typeof DECISION_TYPES)[number];
+declare const FORMATTER_NAMES: readonly ["currency", "number"];
+type FormatterName = (typeof FORMATTER_NAMES)[number];
+//#endregion
+export { COLLECTIONS, CONTENT_SLOT_TYPES, CollectionField, CollectionIdKey, CollectionOwnership, ContentSlotType, DECISION_TYPES, DERIVED_INPUT_FIELDS, DecisionType, DerivedInputName, FORMATTER_NAMES, FormatterName, REFERRAL_FIELDS, REFERRAL_IMAGE_FIELDS, REF_SLOT_TYPES, RefSlotType, ReferralField, ReferralImageField, SLOT_TYPES, SOURCE_FIELDS, SlotType, SourceFieldContainer, SourceFieldDescriptor, SourceFieldName, SourceFieldValueType, WritebackTarget, collectionForSlot };

package/dist/contracts/slot-catalog.js

@@ -0,0 +1,247 @@
+//#region src/contracts/slot-catalog.ts
+const CONTENT_SLOT_TYPES = [
+	"text",
+	"number",
+	"select",
+	"image",
+	"image_collection",
+	"list",
+	"object_list",
+	"poi_list",
+	"url"
+];
+const REF_SLOT_TYPES = [];
+const SLOT_TYPES = [...CONTENT_SLOT_TYPES, ...REF_SLOT_TYPES];
+const REFERRAL_FIELDS = [
+	"name",
+	"title",
+	"email",
+	"phone",
+	"website",
+	"instagram",
+	"linkedin",
+	"x",
+	"facebook",
+	"headshot",
+	"logo_dark",
+	"logo_light"
+];
+const REFERRAL_IMAGE_FIELDS = [
+	"headshot",
+	"logo_dark",
+	"logo_light"
+];
+const SOURCE_FIELDS = {
+	address: {
+		container: "property",
+		value_type: "text"
+	},
+	listing_intent: {
+		container: "property",
+		value_type: "text",
+		writeback: {
+			kind: "property",
+			column: "listing_intent"
+		}
+	},
+	status: {
+		container: "property",
+		value_type: "text"
+	},
+	property_type: {
+		container: "property",
+		value_type: "text"
+	},
+	year_built: {
+		container: "property",
+		value_type: "number"
+	},
+	lot_size: {
+		container: "property",
+		value_type: "text"
+	},
+	unit_label: {
+		container: "unit",
+		value_type: "text",
+		writeback: {
+			kind: "unit",
+			column: "unit_label"
+		}
+	},
+	beds: {
+		container: "unit",
+		value_type: "number",
+		writeback: {
+			kind: "unit",
+			column: "beds"
+		}
+	},
+	baths: {
+		container: "unit",
+		value_type: "number",
+		writeback: {
+			kind: "unit",
+			column: "baths"
+		}
+	},
+	sqft: {
+		container: "unit",
+		value_type: "number",
+		writeback: {
+			kind: "unit",
+			column: "sqft"
+		}
+	},
+	price: {
+		container: "unit",
+		value_type: "text",
+		writeback: {
+			kind: "unit",
+			column: "price"
+		}
+	},
+	notes: {
+		container: "unit",
+		value_type: "text"
+	},
+	units: {
+		container: "property",
+		value_type: "unit_list"
+	},
+	contacts: {
+		container: "property",
+		value_type: "contact_list"
+	},
+	name: {
+		container: "contact",
+		value_type: "text",
+		writeback: {
+			kind: "contact",
+			field: "name"
+		}
+	},
+	title: {
+		container: "contact",
+		value_type: "text",
+		writeback: {
+			kind: "contact",
+			field: "title"
+		}
+	},
+	bio: {
+		container: "contact",
+		value_type: "text",
+		writeback: {
+			kind: "contact",
+			field: "bio"
+		}
+	},
+	email: {
+		container: "contact",
+		value_type: "text",
+		writeback: {
+			kind: "contact",
+			field: "email"
+		}
+	},
+	phone: {
+		container: "contact",
+		value_type: "text",
+		writeback: {
+			kind: "contact",
+			field: "phone"
+		}
+	},
+	website: {
+		container: "contact",
+		value_type: "text",
+		writeback: {
+			kind: "contact",
+			field: "website"
+		}
+	},
+	instagram: {
+		container: "contact",
+		value_type: "text",
+		writeback: {
+			kind: "contact",
+			field: "socials.instagram"
+		}
+	},
+	linkedin: {
+		container: "contact",
+		value_type: "text",
+		writeback: {
+			kind: "contact",
+			field: "socials.linkedin"
+		}
+	},
+	x: {
+		container: "contact",
+		value_type: "text",
+		writeback: {
+			kind: "contact",
+			field: "socials.x"
+		}
+	},
+	facebook: {
+		container: "contact",
+		value_type: "text",
+		writeback: {
+			kind: "contact",
+			field: "socials.facebook"
+		}
+	},
+	headshot: {
+		container: "contact",
+		value_type: "image",
+		image: true
+	},
+	logo_dark: {
+		container: "contact",
+		value_type: "image",
+		image: true
+	},
+	logo_light: {
+		container: "contact",
+		value_type: "image",
+		image: true
+	}
+};
+const COLLECTIONS = {
+	units: {
+		idKey: "unit_id",
+		ownership: "property"
+	},
+	contacts: {
+		idKey: "id",
+		cap: 12,
+		min: 1,
+		ownership: "library"
+	}
+};
+function collectionForSlot(slot) {
+	if (slot.type !== "object_list") return null;
+	if (slot.source?.kind !== "direct") return null;
+	const field = slot.source.field;
+	return field !== void 0 && Object.hasOwn(COLLECTIONS, field) ? field : null;
+}
+const DERIVED_INPUT_FIELDS = [
+	"units",
+	"address_line_parts",
+	"contact_address_parts",
+	"coordinates",
+	"clock"
+];
+const DECISION_TYPES = [
+	"image-assign",
+	"image-collection",
+	"text-block",
+	"text-seed",
+	"list-extract",
+	"structured-list"
+];
+const FORMATTER_NAMES = ["currency", "number"];
+
+//#endregion
+export { COLLECTIONS, CONTENT_SLOT_TYPES, DECISION_TYPES, DERIVED_INPUT_FIELDS, FORMATTER_NAMES, REFERRAL_FIELDS, REFERRAL_IMAGE_FIELDS, REF_SLOT_TYPES, SLOT_TYPES, SOURCE_FIELDS, collectionForSlot };

package/dist/contracts/transforms.d.ts

@@ -0,0 +1,108 @@
+import { DerivedInputName } from "./slot-catalog.js";
+//#region src/contracts/transforms.d.ts
+type TransformUnit = {
+  beds: number | null;
+  baths: number | null;
+  sqft: number | null;
+  price: string | null;
+  position: number;
+};
+type AddressParts = {
+  line1: string | null;
+  line2: string | null;
+};
+type Coordinates = {
+  lat: number;
+  lng: number;
+};
+type TransformInput = {
+  units: ReadonlyArray<TransformUnit>;
+  address?: string | null;
+  address_line_parts?: AddressParts | null;
+  contact_address_parts?: AddressParts | null;
+  coordinates?: Coordinates | null;
+  year?: number;
+};
+type TransformFn = (input: TransformInput) => string | number | null;
+type TransformDescriptor = {
+  inputs: readonly DerivedInputName[];
+  impl: TransformFn;
+};
+declare const TRANSFORMS: {
+  "units.bedsPrimary": {
+    inputs: "units"[];
+    impl: ({ units }: TransformInput) => number | null;
+  };
+  "units.bathsPrimary": {
+    inputs: "units"[];
+    impl: ({ units }: TransformInput) => number | null;
+  };
+  "units.sqftPrimary": {
+    inputs: "units"[];
+    impl: ({ units }: TransformInput) => number | null;
+  };
+  "units.pricePrimary": {
+    inputs: "units"[];
+    impl: ({ units }: TransformInput) => string | null;
+  };
+  "units.bedsRange": {
+    inputs: "units"[];
+    impl: ({ units }: TransformInput) => string | null;
+  };
+  "units.priceStart": {
+    inputs: "units"[];
+    impl: ({ units }: TransformInput) => string | null;
+  };
+  "units.bedsMin": {
+    inputs: "units"[];
+    impl: ({ units }: TransformInput) => string | null;
+  };
+  "units.bedsMax": {
+    inputs: "units"[];
+    impl: ({ units }: TransformInput) => string | null;
+  };
+  "units.bathsMin": {
+    inputs: "units"[];
+    impl: ({ units }: TransformInput) => string | null;
+  };
+  "units.bathsMax": {
+    inputs: "units"[];
+    impl: ({ units }: TransformInput) => string | null;
+  };
+  "units.sqftMax": {
+    inputs: "units"[];
+    impl: ({ units }: TransformInput) => string | null;
+  };
+  "address.line1": {
+    inputs: "address_line_parts"[];
+    impl: ({ address_line_parts: p }: TransformInput) => string | null;
+  };
+  "address.line2": {
+    inputs: "address_line_parts"[];
+    impl: ({ address_line_parts: p }: TransformInput) => string | null;
+  };
+  "contact_address.line1": {
+    inputs: "contact_address_parts"[];
+    impl: ({ contact_address_parts: p }: TransformInput) => string | null;
+  };
+  "contact_address.line2": {
+    inputs: "contact_address_parts"[];
+    impl: ({ contact_address_parts: p }: TransformInput) => string | null;
+  };
+  "clock.currentYear": {
+    inputs: "clock"[];
+    impl: () => number;
+  };
+  "coordinate.lat": {
+    inputs: "coordinates"[];
+    impl: ({ coordinates }: TransformInput) => number | null;
+  };
+  "coordinate.lng": {
+    inputs: "coordinates"[];
+    impl: ({ coordinates }: TransformInput) => number | null;
+  };
+};
+type TransformName = keyof typeof TRANSFORMS;
+declare const TRANSFORM_NAMES: readonly TransformName[];
+//#endregion
+export { AddressParts, Coordinates, TRANSFORMS, TRANSFORM_NAMES, TransformDescriptor, TransformFn, TransformInput, TransformName, TransformUnit };

package/dist/contracts/transforms.js

@@ -0,0 +1,117 @@
+//#region src/contracts/transforms.ts
+function primary(units) {
+	if (units.length === 0) return null;
+	return [...units].sort((a, b) => a.position - b.position)[0];
+}
+function digits(price) {
+	if (price == null) return null;
+	const s = price.trim().replace(/^\$/, "").replace(/,/g, "").trim();
+	return /^\d+$/.test(s) ? Number(s) : null;
+}
+function readYear() {
+	const fixed = process.env.TR_FIXED_YEAR;
+	if (fixed) {
+		const n = Number(fixed);
+		if (!Number.isInteger(n)) throw new Error(`TR_FIXED_YEAR not an integer: ${fixed}`);
+		return n;
+	}
+	return (/* @__PURE__ */ new Date()).getUTCFullYear();
+}
+const enUS = new Intl.NumberFormat("en-US");
+function aggFmt(values, pick) {
+	if (values.length === 0) return null;
+	return enUS.format(pick === "max" ? Math.max(...values) : Math.min(...values));
+}
+function numVals(units, k) {
+	return units.map((u) => u[k]).filter((v) => v != null);
+}
+function firstUnitPriceText(units) {
+	for (const u of [...units].sort((a, b) => a.position - b.position)) if (u.price != null && u.price.trim() !== "" && digits(u.price) == null) return u.price;
+	return null;
+}
+const TRANSFORMS = {
+	"units.bedsPrimary": {
+		inputs: ["units"],
+		impl: ({ units }) => primary(units)?.beds ?? null
+	},
+	"units.bathsPrimary": {
+		inputs: ["units"],
+		impl: ({ units }) => primary(units)?.baths ?? null
+	},
+	"units.sqftPrimary": {
+		inputs: ["units"],
+		impl: ({ units }) => primary(units)?.sqft ?? null
+	},
+	"units.pricePrimary": {
+		inputs: ["units"],
+		impl: ({ units }) => primary(units)?.price ?? null
+	},
+	"units.bedsRange": {
+		inputs: ["units"],
+		impl: ({ units }) => {
+			const beds = units.map((u) => u.beds).filter((b) => b != null);
+			if (beds.length === 0) return null;
+			const lo = Math.min(...beds), hi = Math.max(...beds);
+			return lo === hi ? String(lo) : `${lo}–${hi}`;
+		}
+	},
+	"units.priceStart": {
+		inputs: ["units"],
+		impl: ({ units }) => {
+			const prices = units.map((u) => digits(u.price)).filter((n) => n != null);
+			return prices.length === 0 ? firstUnitPriceText(units) : String(Math.min(...prices));
+		}
+	},
+	"units.bedsMin": {
+		inputs: ["units"],
+		impl: ({ units }) => aggFmt(numVals(units, "beds"), "min")
+	},
+	"units.bedsMax": {
+		inputs: ["units"],
+		impl: ({ units }) => aggFmt(numVals(units, "beds"), "max")
+	},
+	"units.bathsMin": {
+		inputs: ["units"],
+		impl: ({ units }) => aggFmt(numVals(units, "baths"), "min")
+	},
+	"units.bathsMax": {
+		inputs: ["units"],
+		impl: ({ units }) => aggFmt(numVals(units, "baths"), "max")
+	},
+	"units.sqftMax": {
+		inputs: ["units"],
+		impl: ({ units }) => aggFmt(numVals(units, "sqft"), "max")
+	},
+	"address.line1": {
+		inputs: ["address_line_parts"],
+		impl: ({ address_line_parts: p }) => p?.line1 ?? null
+	},
+	"address.line2": {
+		inputs: ["address_line_parts"],
+		impl: ({ address_line_parts: p }) => p?.line2 ?? null
+	},
+	"contact_address.line1": {
+		inputs: ["contact_address_parts"],
+		impl: ({ contact_address_parts: p }) => p?.line1 ?? null
+	},
+	"contact_address.line2": {
+		inputs: ["contact_address_parts"],
+		impl: ({ contact_address_parts: p }) => p?.line2 ?? null
+	},
+	"clock.currentYear": {
+		inputs: ["clock"],
+		impl: () => readYear()
+	},
+	"coordinate.lat": {
+		inputs: ["coordinates"],
+		impl: ({ coordinates }) => coordinates?.lat ?? null
+	},
+	"coordinate.lng": {
+		inputs: ["coordinates"],
+		impl: ({ coordinates }) => coordinates?.lng ?? null
+	}
+};
+const TRANSFORM_NAMES = Object.keys(TRANSFORMS);
+
+//#endregion
+export { TRANSFORMS, TRANSFORM_NAMES };

package/dist/design-system/breakpoints.d.ts

@@ -0,0 +1,5 @@
+//#region src/design-system/breakpoints.d.ts
+declare const VERIFICATION_WIDTHS: readonly [350, 390, 425, 512, 768, 1024, 1440, 1920];
+type VerificationWidth = (typeof VERIFICATION_WIDTHS)[number];
+//#endregion
+export { VERIFICATION_WIDTHS, VerificationWidth };