@homepages/template-kit 0.0.1 → 0.1.0

package/dist/schema/fill-spec.js

@@ -0,0 +1,98 @@
+import { z } from "zod";
+
+//#region src/schema/fill-spec.ts
+const Bindable = (literal) => z.union([literal, z.object({ bind: z.string().regex(/^(options|template)\.[a-zA-Z0-9_]+$/) }).strict()]);
+const ImageAssignDecision = z.object({
+	id: z.string(),
+	type: z.literal("image-assign"),
+	tag_query: z.string().optional(),
+	selection_prompt: z.string().optional(),
+	from_fact: z.string().optional(),
+	produces: z.array(z.string()).min(1)
+}).strict();
+const ImageCollectionDecision = z.object({
+	id: z.string(),
+	type: z.literal("image-collection"),
+	tag_query: z.string().optional(),
+	mode: z.enum(["spread", "walkthrough"]).optional(),
+	count: z.object({
+		min: z.number().int().nonnegative(),
+		max: z.number().int().positive()
+	}).strict().optional(),
+	selection_prompt: z.string(),
+	produces: z.array(z.string()).min(1)
+}).strict();
+const TextBlockDecision = z.object({
+	id: z.string(),
+	type: z.literal("text-block"),
+	length_cap: Bindable(z.number().int().positive()),
+	structure: Bindable(z.enum([
+		"single_sentence",
+		"paragraph",
+		"bullet_list"
+	])),
+	perspective: z.enum([
+		"first",
+		"second",
+		"third"
+	]).optional(),
+	voice_prompt: z.string(),
+	content_prompt: z.string().optional(),
+	produces: z.array(z.string()).min(1)
+}).strict();
+const TextSeedDecision = z.object({
+	id: z.string(),
+	type: z.literal("text-seed"),
+	source: z.string().regex(/^\$\{(facts|options|template)\.[a-zA-Z0-9_.]+\}$/),
+	produces: z.array(z.string()).min(1)
+}).strict();
+const ListExtractDecision = z.object({
+	id: z.string(),
+	type: z.literal("list-extract"),
+	iterate: z.string().optional(),
+	item_count: Bindable(z.number().int().positive()).optional(),
+	per_item_length_cap: Bindable(z.number().int().positive()).optional(),
+	structure_hint: z.string(),
+	voice_prompt: z.string(),
+	content_prompt: z.string().optional(),
+	produces: z.array(z.string()).min(1)
+}).strict();
+const StructuredListDecision = z.object({
+	id: z.string(),
+	type: z.literal("structured-list"),
+	iterate: z.string().optional(),
+	item_count: Bindable(z.number().int().positive()).optional(),
+	item_fields: z.record(z.string(), z.string()),
+	structure_hint: z.string(),
+	voice_prompt: z.string(),
+	content_prompt: z.string().optional(),
+	system_prompt: z.string().optional(),
+	route_by: z.string().optional(),
+	per_field_cap: z.record(z.string(), z.number().int().positive()).optional(),
+	per_field_min: z.record(z.string(), z.number().int().positive()).optional(),
+	produces: z.array(z.string()).min(1),
+	catalog: z.array(z.object({
+		key: z.string(),
+		label: z.string(),
+		icon: z.string(),
+		aliases: z.array(z.string()).default([]),
+		slot: z.string().optional()
+	}).strict()).optional(),
+	per_category_max: z.number().int().positive().optional(),
+	min: z.number().int().nonnegative().optional()
+}).strict();
+const Decision = z.discriminatedUnion("type", [
+	ImageAssignDecision,
+	ImageCollectionDecision,
+	TextBlockDecision,
+	TextSeedDecision,
+	ListExtractDecision,
+	StructuredListDecision
+]);
+const FillSpec = z.object({
+	reads: z.array(z.string()).default([]),
+	decisions: z.array(Decision)
+}).strict();
+
+//#endregion
+export { Decision, FillSpec };

package/dist/schema/fixture-schema.d.ts

@@ -0,0 +1,143 @@
+import { SchemaForSynth } from "./synthesize-nullable.js";
+import { z } from "zod";
+//#region src/schema/fixture-schema.d.ts
+declare const FixtureOverride: z.ZodObject<{
+  label: z.ZodOptional<z.ZodString>;
+  slots: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  anchors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+  variants: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+  options?: Record<string, unknown> | undefined;
+  label?: string | undefined;
+  variants?: Record<string, string> | undefined;
+  slots?: Record<string, unknown> | undefined;
+  anchors?: Record<string, string> | undefined;
+}, {
+  options?: Record<string, unknown> | undefined;
+  label?: string | undefined;
+  variants?: Record<string, string> | undefined;
+  slots?: Record<string, unknown> | undefined;
+  anchors?: Record<string, string> | undefined;
+}>;
+declare const FixtureModuleShape: z.ZodObject<{
+  base: z.ZodObject<{
+    slots: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    anchors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    variants: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+  }, "strip", z.ZodTypeAny, {
+    slots: Record<string, unknown>;
+    options?: Record<string, unknown> | undefined;
+    variants?: Record<string, string> | undefined;
+    anchors?: Record<string, string> | undefined;
+  }, {
+    slots: Record<string, unknown>;
+    options?: Record<string, unknown> | undefined;
+    variants?: Record<string, string> | undefined;
+    anchors?: Record<string, string> | undefined;
+  }>;
+  option_matrix: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    label: z.ZodOptional<z.ZodString>;
+    options: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+  }, "strip", z.ZodTypeAny, {
+    options: Record<string, unknown>;
+    label?: string | undefined;
+  }, {
+    options: Record<string, unknown>;
+    label?: string | undefined;
+  }>, "many">>;
+  states: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+    label: z.ZodOptional<z.ZodString>;
+    slots: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    anchors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    variants: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+  }, "strip", z.ZodTypeAny, {
+    options?: Record<string, unknown> | undefined;
+    label?: string | undefined;
+    variants?: Record<string, string> | undefined;
+    slots?: Record<string, unknown> | undefined;
+    anchors?: Record<string, string> | undefined;
+  }, {
+    options?: Record<string, unknown> | undefined;
+    label?: string | undefined;
+    variants?: Record<string, string> | undefined;
+    slots?: Record<string, unknown> | undefined;
+    anchors?: Record<string, string> | undefined;
+  }>>>;
+}, "strip", z.ZodTypeAny, {
+  base: {
+    slots: Record<string, unknown>;
+    options?: Record<string, unknown> | undefined;
+    variants?: Record<string, string> | undefined;
+    anchors?: Record<string, string> | undefined;
+  };
+  option_matrix?: {
+    options: Record<string, unknown>;
+    label?: string | undefined;
+  }[] | undefined;
+  states?: Record<string, {
+    options?: Record<string, unknown> | undefined;
+    label?: string | undefined;
+    variants?: Record<string, string> | undefined;
+    slots?: Record<string, unknown> | undefined;
+    anchors?: Record<string, string> | undefined;
+  }> | undefined;
+}, {
+  base: {
+    slots: Record<string, unknown>;
+    options?: Record<string, unknown> | undefined;
+    variants?: Record<string, string> | undefined;
+    anchors?: Record<string, string> | undefined;
+  };
+  option_matrix?: {
+    options: Record<string, unknown>;
+    label?: string | undefined;
+  }[] | undefined;
+  states?: Record<string, {
+    options?: Record<string, unknown> | undefined;
+    label?: string | undefined;
+    variants?: Record<string, string> | undefined;
+    slots?: Record<string, unknown> | undefined;
+    anchors?: Record<string, string> | undefined;
+  }> | undefined;
+}>;
+type FixtureModule = z.infer<typeof FixtureModuleShape>;
+type FixtureOverride = z.infer<typeof FixtureOverride>;
+type ResolvedFixture = {
+  id: string;
+  label: string;
+  props: {
+    slots: Record<string, unknown>;
+    options: Record<string, unknown>;
+    nav: {
+      selfAnchor: string;
+      anchors: Record<string, unknown>;
+    };
+    variants: Record<string, string>;
+  };
+};
+type VariantAxes = Record<string, {
+  cases: string[];
+  default: string;
+}>;
+type SchemaForBuild = {
+  slots: Record<string, unknown>;
+  meta?: {
+    variants?: VariantAxes | undefined;
+  } | undefined;
+  variants?: VariantAxes | undefined;
+};
+declare function buildFixtureSet(input: {
+  schema: SchemaForBuild;
+  module: FixtureModule;
+  selfAnchor?: string;
+}): ResolvedFixture[];
+declare function buildInvariantFixtures(input: {
+  schema: SchemaForBuild & SchemaForSynth;
+  module: FixtureModule;
+  selfAnchor?: string;
+}): ResolvedFixture[];
+//#endregion
+export { FixtureModule, FixtureModuleShape, FixtureOverride, ResolvedFixture, buildFixtureSet, buildInvariantFixtures };

package/dist/schema/fixture-schema.js

@@ -0,0 +1,113 @@
+import { synthesizeNullableFixtures } from "./synthesize-nullable.js";
+import { z } from "zod";
+
+//#region src/schema/fixture-schema.ts
+const FixtureOverride = z.object({
+	label: z.string().optional(),
+	slots: z.record(z.string(), z.unknown()).optional(),
+	options: z.record(z.string(), z.unknown()).optional(),
+	anchors: z.record(z.string(), z.string()).optional(),
+	variants: z.record(z.string(), z.string()).optional()
+});
+const FixtureModuleShape = z.object({
+	base: z.object({
+		slots: z.record(z.string(), z.unknown()),
+		options: z.record(z.string(), z.unknown()).optional(),
+		anchors: z.record(z.string(), z.string()).optional(),
+		variants: z.record(z.string(), z.string()).optional()
+	}),
+	option_matrix: z.array(z.object({
+		label: z.string().optional(),
+		options: z.record(z.string(), z.unknown())
+	})).optional(),
+	states: z.record(z.string(), FixtureOverride).optional()
+});
+function resolveBaseVariants(schema, module) {
+	const axisDefaults = {};
+	const declaredVariants = schema.meta?.variants ?? schema.variants ?? {};
+	for (const [axis, def] of Object.entries(declaredVariants)) axisDefaults[axis] = def.default;
+	return {
+		...axisDefaults,
+		...module.base.variants ?? {}
+	};
+}
+function buildFixtureSet(input) {
+	const { schema, module, selfAnchor = "" } = input;
+	const baseSlots = module.base.slots;
+	const baseOptions = module.base.options ?? {};
+	const baseAnchors = module.base.anchors ?? {};
+	const baseVariants = resolveBaseVariants(schema, module);
+	const out = [];
+	out.push({
+		id: "typical",
+		label: "Typical (base content)",
+		props: {
+			slots: { ...baseSlots },
+			options: { ...baseOptions },
+			nav: {
+				selfAnchor,
+				anchors: { ...baseAnchors }
+			},
+			variants: { ...baseVariants }
+		}
+	});
+	if (module.option_matrix) module.option_matrix.forEach((entry, i) => {
+		const id = entry.label ? `option_${slugify(entry.label)}` : `option_${i + 1}`;
+		out.push({
+			id,
+			label: entry.label ?? `Option variant ${i + 1}`,
+			props: {
+				slots: { ...baseSlots },
+				options: {
+					...baseOptions,
+					...entry.options
+				},
+				nav: {
+					selfAnchor,
+					anchors: { ...baseAnchors }
+				},
+				variants: { ...baseVariants }
+			}
+		});
+	});
+	if (module.states) for (const [id, override] of Object.entries(module.states)) out.push({
+		id,
+		label: override.label ?? id,
+		props: {
+			slots: {
+				...baseSlots,
+				...override.slots ?? {}
+			},
+			options: {
+				...baseOptions,
+				...override.options ?? {}
+			},
+			nav: {
+				selfAnchor,
+				anchors: {
+					...baseAnchors,
+					...override.anchors ?? {}
+				}
+			},
+			variants: {
+				...baseVariants,
+				...override.variants ?? {}
+			}
+		}
+	});
+	return out;
+}
+function slugify(s) {
+	return s.toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_+|_+$/g, "");
+}
+function buildInvariantFixtures(input) {
+	const { schema, module, selfAnchor = "" } = input;
+	return [...buildFixtureSet({
+		schema,
+		module,
+		selfAnchor
+	}), ...synthesizeNullableFixtures(schema, module, selfAnchor)];
+}
+
+//#endregion
+export { FixtureModuleShape, buildFixtureSet, buildInvariantFixtures, resolveBaseVariants };

package/dist/schema/index.d.ts

@@ -0,0 +1,16 @@
+import { ResponsiveImage, ResponsiveSource } from "../contracts/image-descriptor.js";
+import { Coordinates, FloorplanAssignment, PropertyFacts, UnitRow } from "./property-facts.js";
+import { 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 } from "../contracts/slot-catalog.js";
+import { AddressParts, TRANSFORMS, TRANSFORM_NAMES, TransformDescriptor, TransformFn, TransformInput, TransformName, TransformUnit } from "../contracts/transforms.js";
+import { VariantSelectorFn, VariantsMeta, makeResolveVariants } from "./resolve-variants.js";
+import { ContentSlot, SLOT_TYPE_DESCRIPTORS, Slot, SlotDef, defaultForSlotType, slotDefTypes } from "./slot-types.js";
+import { VERIFICATION_WIDTHS, VerificationWidth } from "../design-system/breakpoints.js";
+import { FrameConfig, ImageCollectionValue, ImageValue, PoiRow } from "./runtime-values.js";
+import { SectionNav } from "./section-nav.js";
+import { OptionValue, SectionProps, SlotValue } from "./section-props.js";
+import { derived, direct } from "./source.js";
+import { OptionDef, SectionMeta, SectionMetaShape, SectionSchema, SectionSchemaResolved, SectionSchemaShape, SlotGroupDef, SlotGroupDefShape } from "./section-schema.js";
+import { Decision, FillSpec, FillSpecShape } from "./fill-spec.js";
+import { FixtureModule, FixtureModuleShape, FixtureOverride, ResolvedFixture, buildFixtureSet, buildInvariantFixtures } from "./fixture-schema.js";
+import { TemplateManifest, TemplateManifestShape } from "./manifest.js";
+export { type AddressParts, COLLECTIONS, CONTENT_SLOT_TYPES, type CollectionField, type CollectionIdKey, type CollectionOwnership, ContentSlot, type ContentSlotType, type Coordinates, DECISION_TYPES, DERIVED_INPUT_FIELDS, Decision, type DecisionType, type DerivedInputName, FORMATTER_NAMES, FillSpec, type FillSpecShape, type FixtureModule, FixtureModuleShape, type FixtureOverride, type FloorplanAssignment, type FormatterName, type FrameConfig, type ImageCollectionValue, type ImageValue, OptionDef, type OptionValue, type PoiRow, type PropertyFacts, REFERRAL_FIELDS, REFERRAL_IMAGE_FIELDS, REF_SLOT_TYPES, type RefSlotType, type ReferralField, type ReferralImageField, type ResolvedFixture, type ResponsiveImage, type ResponsiveSource, SLOT_TYPES, SLOT_TYPE_DESCRIPTORS, SOURCE_FIELDS, SectionMeta, type SectionMetaShape, type SectionNav, type SectionProps, SectionSchema, type SectionSchemaResolved, type SectionSchemaShape, type Slot, SlotDef, SlotGroupDef, type SlotGroupDefShape, type SlotType, type SlotValue, type SourceFieldContainer, type SourceFieldDescriptor, type SourceFieldName, type SourceFieldValueType, TRANSFORMS, TRANSFORM_NAMES, TemplateManifest, type TemplateManifestShape, type TransformDescriptor, type TransformFn, type TransformInput, type TransformName, type TransformUnit, type UnitRow, VERIFICATION_WIDTHS, type VariantSelectorFn, type VariantsMeta, type VerificationWidth, type WritebackTarget, buildFixtureSet, buildInvariantFixtures, collectionForSlot, defaultForSlotType, derived, direct, makeResolveVariants, slotDefTypes };