@homepages/template-kit 0.0.0 → 0.1.0

package/dist/schema/manifest.d.ts

@@ -0,0 +1,527 @@
+import { z } from "zod";
+//#region src/schema/manifest.d.ts
+declare const TemplateManifest: z.ZodEffects<z.ZodObject<{
+  key: z.ZodString;
+  name: z.ZodString;
+  deliverable_type: z.ZodEnum<["single_property_website"]>;
+  options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    user_editable: z.ZodDefault<z.ZodBoolean>;
+    template_overridable: z.ZodDefault<z.ZodBoolean>;
+    planner_settable: z.ZodDefault<z.ZodBoolean>;
+    affects_decisions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    affects_slots: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    type: z.ZodLiteral<"enum">;
+    values: z.ZodArray<z.ZodString, "many">;
+    default: z.ZodString;
+  }, "strict", z.ZodTypeAny, {
+    type: "enum";
+    values: string[];
+    default: string;
+    user_editable: boolean;
+    template_overridable: boolean;
+    planner_settable: boolean;
+    affects_decisions: string[];
+    affects_slots: string[];
+  }, {
+    type: "enum";
+    values: string[];
+    default: string;
+    user_editable?: boolean | undefined;
+    template_overridable?: boolean | undefined;
+    planner_settable?: boolean | undefined;
+    affects_decisions?: string[] | undefined;
+    affects_slots?: string[] | undefined;
+  }>, z.ZodObject<{
+    user_editable: z.ZodDefault<z.ZodBoolean>;
+    template_overridable: z.ZodDefault<z.ZodBoolean>;
+    planner_settable: z.ZodDefault<z.ZodBoolean>;
+    affects_decisions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    affects_slots: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    type: z.ZodLiteral<"bool">;
+    default: z.ZodBoolean;
+  }, "strict", z.ZodTypeAny, {
+    type: "bool";
+    default: boolean;
+    user_editable: boolean;
+    template_overridable: boolean;
+    planner_settable: boolean;
+    affects_decisions: string[];
+    affects_slots: string[];
+  }, {
+    type: "bool";
+    default: boolean;
+    user_editable?: boolean | undefined;
+    template_overridable?: boolean | undefined;
+    planner_settable?: boolean | undefined;
+    affects_decisions?: string[] | undefined;
+    affects_slots?: string[] | undefined;
+  }>, z.ZodObject<{
+    user_editable: z.ZodDefault<z.ZodBoolean>;
+    template_overridable: z.ZodDefault<z.ZodBoolean>;
+    planner_settable: z.ZodDefault<z.ZodBoolean>;
+    affects_decisions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    affects_slots: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    type: z.ZodLiteral<"int">;
+    default: z.ZodNumber;
+    min: z.ZodOptional<z.ZodNumber>;
+    max: z.ZodOptional<z.ZodNumber>;
+  }, "strict", z.ZodTypeAny, {
+    type: "int";
+    default: number;
+    user_editable: boolean;
+    template_overridable: boolean;
+    planner_settable: boolean;
+    affects_decisions: string[];
+    affects_slots: string[];
+    min?: number | undefined;
+    max?: number | undefined;
+  }, {
+    type: "int";
+    default: number;
+    user_editable?: boolean | undefined;
+    template_overridable?: boolean | undefined;
+    planner_settable?: boolean | undefined;
+    affects_decisions?: string[] | undefined;
+    affects_slots?: string[] | undefined;
+    min?: number | undefined;
+    max?: number | undefined;
+  }>, z.ZodObject<{
+    user_editable: z.ZodDefault<z.ZodBoolean>;
+    template_overridable: z.ZodDefault<z.ZodBoolean>;
+    planner_settable: z.ZodDefault<z.ZodBoolean>;
+    affects_decisions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    affects_slots: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    type: z.ZodLiteral<"string">;
+    default: z.ZodString;
+  }, "strict", z.ZodTypeAny, {
+    type: "string";
+    default: string;
+    user_editable: boolean;
+    template_overridable: boolean;
+    planner_settable: boolean;
+    affects_decisions: string[];
+    affects_slots: string[];
+  }, {
+    type: "string";
+    default: string;
+    user_editable?: boolean | undefined;
+    template_overridable?: boolean | undefined;
+    planner_settable?: boolean | undefined;
+    affects_decisions?: string[] | undefined;
+    affects_slots?: string[] | undefined;
+  }>, z.ZodObject<{
+    user_editable: z.ZodDefault<z.ZodBoolean>;
+    template_overridable: z.ZodDefault<z.ZodBoolean>;
+    planner_settable: z.ZodDefault<z.ZodBoolean>;
+    affects_decisions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    affects_slots: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    type: z.ZodLiteral<"json">;
+    default: z.ZodUnknown;
+  }, "strict", z.ZodTypeAny, {
+    type: "json";
+    user_editable: boolean;
+    template_overridable: boolean;
+    planner_settable: boolean;
+    affects_decisions: string[];
+    affects_slots: string[];
+    default?: unknown;
+  }, {
+    type: "json";
+    default?: unknown;
+    user_editable?: boolean | undefined;
+    template_overridable?: boolean | undefined;
+    planner_settable?: boolean | undefined;
+    affects_decisions?: string[] | undefined;
+    affects_slots?: string[] | undefined;
+  }>]>>>;
+  sections: z.ZodArray<z.ZodObject<{
+    section: z.ZodString;
+    instance_id: z.ZodString;
+    options: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    locked: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    required: z.ZodDefault<z.ZodBoolean>;
+    reorderable: z.ZodDefault<z.ZodBoolean>;
+  }, "strict", z.ZodTypeAny, {
+    options: Record<string, unknown>;
+    required: boolean;
+    section: string;
+    instance_id: string;
+    locked: string[];
+    reorderable: boolean;
+  }, {
+    section: string;
+    instance_id: string;
+    options?: Record<string, unknown> | undefined;
+    required?: boolean | undefined;
+    locked?: string[] | undefined;
+    reorderable?: boolean | undefined;
+  }>, "many">;
+  reconcile: z.ZodDefault<z.ZodArray<z.ZodObject<{
+    type: z.ZodLiteral<"dedup-image">;
+    from: z.ZodObject<{
+      section: z.ZodString;
+      slot: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+      slot: string;
+      section: string;
+    }, {
+      slot: string;
+      section: string;
+    }>;
+    into: z.ZodObject<{
+      section: z.ZodString;
+      slot: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+      slot: string;
+      section: string;
+    }, {
+      slot: string;
+      section: string;
+    }>;
+    predicate_tags: z.ZodArray<z.ZodString, "many">;
+    min: z.ZodNumber;
+  }, "strict", z.ZodTypeAny, {
+    type: "dedup-image";
+    min: number;
+    from: {
+      slot: string;
+      section: string;
+    };
+    into: {
+      slot: string;
+      section: string;
+    };
+    predicate_tags: string[];
+  }, {
+    type: "dedup-image";
+    min: number;
+    from: {
+      slot: string;
+      section: string;
+    };
+    into: {
+      slot: string;
+      section: string;
+    };
+    predicate_tags: string[];
+  }>, "many">>;
+  preview: z.ZodOptional<z.ZodObject<{
+    blurb: z.ZodString;
+    intents: z.ZodArray<z.ZodEnum<["for_sale", "for_rent"]>, "many">;
+    types: z.ZodArray<z.ZodEnum<["single_family", "condo_townhome", "multi_family", "investment"]>, "many">;
+    demoUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  }, "strict", z.ZodTypeAny, {
+    blurb: string;
+    intents: ("for_sale" | "for_rent")[];
+    types: ("single_family" | "condo_townhome" | "multi_family" | "investment")[];
+    demoUrl?: string | null | undefined;
+  }, {
+    blurb: string;
+    intents: ("for_sale" | "for_rent")[];
+    types: ("single_family" | "condo_townhome" | "multi_family" | "investment")[];
+    demoUrl?: string | null | undefined;
+  }>>;
+}, "strict", z.ZodTypeAny, {
+  key: string;
+  name: string;
+  deliverable_type: "single_property_website";
+  sections: {
+    options: Record<string, unknown>;
+    required: boolean;
+    section: string;
+    instance_id: string;
+    locked: string[];
+    reorderable: boolean;
+  }[];
+  reconcile: {
+    type: "dedup-image";
+    min: number;
+    from: {
+      slot: string;
+      section: string;
+    };
+    into: {
+      slot: string;
+      section: string;
+    };
+    predicate_tags: string[];
+  }[];
+  options?: Record<string, {
+    type: "enum";
+    values: string[];
+    default: string;
+    user_editable: boolean;
+    template_overridable: boolean;
+    planner_settable: boolean;
+    affects_decisions: string[];
+    affects_slots: string[];
+  } | {
+    type: "bool";
+    default: boolean;
+    user_editable: boolean;
+    template_overridable: boolean;
+    planner_settable: boolean;
+    affects_decisions: string[];
+    affects_slots: string[];
+  } | {
+    type: "int";
+    default: number;
+    user_editable: boolean;
+    template_overridable: boolean;
+    planner_settable: boolean;
+    affects_decisions: string[];
+    affects_slots: string[];
+    min?: number | undefined;
+    max?: number | undefined;
+  } | {
+    type: "string";
+    default: string;
+    user_editable: boolean;
+    template_overridable: boolean;
+    planner_settable: boolean;
+    affects_decisions: string[];
+    affects_slots: string[];
+  } | {
+    type: "json";
+    user_editable: boolean;
+    template_overridable: boolean;
+    planner_settable: boolean;
+    affects_decisions: string[];
+    affects_slots: string[];
+    default?: unknown;
+  }> | undefined;
+  preview?: {
+    blurb: string;
+    intents: ("for_sale" | "for_rent")[];
+    types: ("single_family" | "condo_townhome" | "multi_family" | "investment")[];
+    demoUrl?: string | null | undefined;
+  } | undefined;
+}, {
+  key: string;
+  name: string;
+  deliverable_type: "single_property_website";
+  sections: {
+    section: string;
+    instance_id: string;
+    options?: Record<string, unknown> | undefined;
+    required?: boolean | undefined;
+    locked?: string[] | undefined;
+    reorderable?: boolean | undefined;
+  }[];
+  options?: Record<string, {
+    type: "enum";
+    values: string[];
+    default: string;
+    user_editable?: boolean | undefined;
+    template_overridable?: boolean | undefined;
+    planner_settable?: boolean | undefined;
+    affects_decisions?: string[] | undefined;
+    affects_slots?: string[] | undefined;
+  } | {
+    type: "bool";
+    default: boolean;
+    user_editable?: boolean | undefined;
+    template_overridable?: boolean | undefined;
+    planner_settable?: boolean | undefined;
+    affects_decisions?: string[] | undefined;
+    affects_slots?: string[] | undefined;
+  } | {
+    type: "int";
+    default: number;
+    user_editable?: boolean | undefined;
+    template_overridable?: boolean | undefined;
+    planner_settable?: boolean | undefined;
+    affects_decisions?: string[] | undefined;
+    affects_slots?: string[] | undefined;
+    min?: number | undefined;
+    max?: number | undefined;
+  } | {
+    type: "string";
+    default: string;
+    user_editable?: boolean | undefined;
+    template_overridable?: boolean | undefined;
+    planner_settable?: boolean | undefined;
+    affects_decisions?: string[] | undefined;
+    affects_slots?: string[] | undefined;
+  } | {
+    type: "json";
+    default?: unknown;
+    user_editable?: boolean | undefined;
+    template_overridable?: boolean | undefined;
+    planner_settable?: boolean | undefined;
+    affects_decisions?: string[] | undefined;
+    affects_slots?: string[] | undefined;
+  }> | undefined;
+  reconcile?: {
+    type: "dedup-image";
+    min: number;
+    from: {
+      slot: string;
+      section: string;
+    };
+    into: {
+      slot: string;
+      section: string;
+    };
+    predicate_tags: string[];
+  }[] | undefined;
+  preview?: {
+    blurb: string;
+    intents: ("for_sale" | "for_rent")[];
+    types: ("single_family" | "condo_townhome" | "multi_family" | "investment")[];
+    demoUrl?: string | null | undefined;
+  } | undefined;
+}>, {
+  key: string;
+  name: string;
+  deliverable_type: "single_property_website";
+  sections: {
+    options: Record<string, unknown>;
+    required: boolean;
+    section: string;
+    instance_id: string;
+    locked: string[];
+    reorderable: boolean;
+  }[];
+  reconcile: {
+    type: "dedup-image";
+    min: number;
+    from: {
+      slot: string;
+      section: string;
+    };
+    into: {
+      slot: string;
+      section: string;
+    };
+    predicate_tags: string[];
+  }[];
+  options?: Record<string, {
+    type: "enum";
+    values: string[];
+    default: string;
+    user_editable: boolean;
+    template_overridable: boolean;
+    planner_settable: boolean;
+    affects_decisions: string[];
+    affects_slots: string[];
+  } | {
+    type: "bool";
+    default: boolean;
+    user_editable: boolean;
+    template_overridable: boolean;
+    planner_settable: boolean;
+    affects_decisions: string[];
+    affects_slots: string[];
+  } | {
+    type: "int";
+    default: number;
+    user_editable: boolean;
+    template_overridable: boolean;
+    planner_settable: boolean;
+    affects_decisions: string[];
+    affects_slots: string[];
+    min?: number | undefined;
+    max?: number | undefined;
+  } | {
+    type: "string";
+    default: string;
+    user_editable: boolean;
+    template_overridable: boolean;
+    planner_settable: boolean;
+    affects_decisions: string[];
+    affects_slots: string[];
+  } | {
+    type: "json";
+    user_editable: boolean;
+    template_overridable: boolean;
+    planner_settable: boolean;
+    affects_decisions: string[];
+    affects_slots: string[];
+    default?: unknown;
+  }> | undefined;
+  preview?: {
+    blurb: string;
+    intents: ("for_sale" | "for_rent")[];
+    types: ("single_family" | "condo_townhome" | "multi_family" | "investment")[];
+    demoUrl?: string | null | undefined;
+  } | undefined;
+}, {
+  key: string;
+  name: string;
+  deliverable_type: "single_property_website";
+  sections: {
+    section: string;
+    instance_id: string;
+    options?: Record<string, unknown> | undefined;
+    required?: boolean | undefined;
+    locked?: string[] | undefined;
+    reorderable?: boolean | undefined;
+  }[];
+  options?: Record<string, {
+    type: "enum";
+    values: string[];
+    default: string;
+    user_editable?: boolean | undefined;
+    template_overridable?: boolean | undefined;
+    planner_settable?: boolean | undefined;
+    affects_decisions?: string[] | undefined;
+    affects_slots?: string[] | undefined;
+  } | {
+    type: "bool";
+    default: boolean;
+    user_editable?: boolean | undefined;
+    template_overridable?: boolean | undefined;
+    planner_settable?: boolean | undefined;
+    affects_decisions?: string[] | undefined;
+    affects_slots?: string[] | undefined;
+  } | {
+    type: "int";
+    default: number;
+    user_editable?: boolean | undefined;
+    template_overridable?: boolean | undefined;
+    planner_settable?: boolean | undefined;
+    affects_decisions?: string[] | undefined;
+    affects_slots?: string[] | undefined;
+    min?: number | undefined;
+    max?: number | undefined;
+  } | {
+    type: "string";
+    default: string;
+    user_editable?: boolean | undefined;
+    template_overridable?: boolean | undefined;
+    planner_settable?: boolean | undefined;
+    affects_decisions?: string[] | undefined;
+    affects_slots?: string[] | undefined;
+  } | {
+    type: "json";
+    default?: unknown;
+    user_editable?: boolean | undefined;
+    template_overridable?: boolean | undefined;
+    planner_settable?: boolean | undefined;
+    affects_decisions?: string[] | undefined;
+    affects_slots?: string[] | undefined;
+  }> | undefined;
+  reconcile?: {
+    type: "dedup-image";
+    min: number;
+    from: {
+      slot: string;
+      section: string;
+    };
+    into: {
+      slot: string;
+      section: string;
+    };
+    predicate_tags: string[];
+  }[] | undefined;
+  preview?: {
+    blurb: string;
+    intents: ("for_sale" | "for_rent")[];
+    types: ("single_family" | "condo_townhome" | "multi_family" | "investment")[];
+    demoUrl?: string | null | undefined;
+  } | undefined;
+}>;
+type TemplateManifestShape = z.infer<typeof TemplateManifest>;
+//#endregion
+export { TemplateManifest, TemplateManifestShape };

package/dist/schema/manifest.js

@@ -0,0 +1,73 @@
+import { OptionDef } from "./section-schema.js";
+import { z } from "zod";
+
+//#region src/schema/manifest.ts
+const SectionInstance = z.object({
+	section: z.string().min(1),
+	instance_id: z.string().min(1),
+	options: z.record(z.string(), z.unknown()).default({}),
+	locked: z.array(z.string()).default([]),
+	required: z.boolean().default(false),
+	reorderable: z.boolean().default(true)
+}).strict();
+const ReconcileRule = z.object({
+	type: z.literal("dedup-image"),
+	from: z.object({
+		section: z.string(),
+		slot: z.string()
+	}).strict(),
+	into: z.object({
+		section: z.string(),
+		slot: z.string()
+	}).strict(),
+	predicate_tags: z.array(z.string().regex(/^[a-z]+:[a-z][a-z0-9-]*$/)).min(1),
+	min: z.number().int().nonnegative()
+}).strict();
+const TemplatePreview = z.object({
+	blurb: z.string().min(1),
+	intents: z.array(z.enum(["for_sale", "for_rent"])),
+	types: z.array(z.enum([
+		"single_family",
+		"condo_townhome",
+		"multi_family",
+		"investment"
+	])),
+	demoUrl: z.string().nullable().optional()
+}).strict();
+const TemplateManifest = z.object({
+	key: z.string().min(1),
+	name: z.string().min(1),
+	deliverable_type: z.enum(["single_property_website"]),
+	options: z.record(z.string(), OptionDef).optional(),
+	sections: z.array(SectionInstance).min(1),
+	reconcile: z.array(ReconcileRule).default([]),
+	preview: TemplatePreview.optional()
+}).strict().superRefine((manifest, ctx) => {
+	manifest.sections.forEach((inst, idx) => {
+		for (const lockedKey of inst.locked) if (!(lockedKey in inst.options)) ctx.addIssue({
+			code: z.ZodIssueCode.custom,
+			path: [
+				"sections",
+				idx,
+				"locked"
+			],
+			message: `Locked option "${lockedKey}" must also appear in this section instance's options.`
+		});
+	});
+	const seen = /* @__PURE__ */ new Set();
+	manifest.sections.forEach((inst, idx) => {
+		if (seen.has(inst.instance_id)) ctx.addIssue({
+			code: z.ZodIssueCode.custom,
+			path: [
+				"sections",
+				idx,
+				"instance_id"
+			],
+			message: `Duplicate instance_id "${inst.instance_id}".`
+		});
+		seen.add(inst.instance_id);
+	});
+});
+
+//#endregion
+export { TemplateManifest };

package/dist/schema/property-facts.d.ts

@@ -0,0 +1,44 @@
+import { ResponsiveImage } from "../contracts/image-descriptor.js";
+//#region src/schema/property-facts.d.ts
+type Coordinates = {
+  lat: number;
+  lng: number;
+};
+type FloorplanAssignment = {
+  id: string;
+  upload_id?: string;
+  url: string;
+  alt: string;
+  floor_label: string | null;
+  position: number;
+  responsive?: ResponsiveImage | null;
+};
+type UnitRow = {
+  unit_id: string;
+  unit_label: string | null;
+  beds: number | null;
+  baths: number | null;
+  sqft: number | null;
+  price: string | null;
+  notes: string | null;
+  description: string | null;
+  features: string[];
+  position: number;
+  floor_plans: FloorplanAssignment[];
+};
+type PropertyFacts = {
+  address: string;
+  address_lines?: string[];
+  lat?: number | null;
+  lon?: number | null;
+  coordinates?: Coordinates | null;
+  listing_intent: "for_sale" | "for_rent";
+  status: string | null;
+  property_type: "single_family" | "condo_townhome" | "multi_family" | "investment";
+  year_built: number | null;
+  lot_size: string | null;
+  units: UnitRow[];
+  contacts?: Array<Record<string, unknown>>;
+};
+//#endregion
+export { Coordinates, FloorplanAssignment, PropertyFacts, UnitRow };

package/dist/schema/resolve-variants.d.ts

@@ -0,0 +1,11 @@
+import { TransformInput } from "../contracts/transforms.js";
+//#region src/schema/resolve-variants.d.ts
+type VariantSelectorFn = (input: TransformInput) => string;
+type VariantsMeta = Record<string, {
+  cases: string[];
+  default: string;
+  select: VariantSelectorFn;
+}>;
+declare function makeResolveVariants(meta: VariantsMeta | undefined): (input: TransformInput) => Record<string, string>;
+//#endregion
+export { VariantSelectorFn, VariantsMeta, makeResolveVariants };

package/dist/schema/resolve-variants.js

@@ -0,0 +1,15 @@
+//#region src/schema/resolve-variants.ts
+function makeResolveVariants(meta) {
+	const axes = meta ?? {};
+	return (input) => {
+		const out = {};
+		for (const [axis, def] of Object.entries(axes)) {
+			const value = def.select(input);
+			out[axis] = def.cases.includes(value) ? value : def.default;
+		}
+		return out;
+	};
+}
+
+//#endregion
+export { makeResolveVariants };