@homepages/template-kit 0.9.0-dev-20260719205406 → 0.9.0

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # @homepages/template-kit
 
-## 0.9.0-dev-20260719205406
+## 0.9.0
 
 ### Minor Changes
 
@@ -24,71 +24,72 @@
   `resolveImportedFile`, `resetClientFileCache`) that the plugin's rules consume
   over the peer edge.
 
+- f868a43: **Breaking:** the CLI has moved to its own package, `@homepages/template-cli`.
+  Installing the kit no longer installs the `template-kit` command, and the
+  `./canvas-core` subpath is gone.
+
+  The command itself is unchanged — it is still `template-kit dev`, `template-kit
+check`, and so on. Add the new package as a devDependency alongside your existing
+  kit dependency:
+
+  ```
+  npm i -D @homepages/template-cli
+  ```
+
+  The kit stays the package your templates import, under the same name and with the
+  same authoring API, so no `import` in a workspace changes. The CLI declares the kit
+  as a `peerDependency`, which is what guarantees a workspace resolves exactly one
+  copy of it.
+
+  Why: the CLI and its dev playground were 53% of the kit's published bytes while the
+  code that reaches a visitor's browser was under 1%, and they change on playground
+  cadence rather than contract cadence. Sharing one version number meant a
+  playground fix and an authoring-contract change were indistinguishable in the
+  number a template author reads.
+
+  `./ssr` additionally now exports `wrapClientModuleMagic`, `flattenLayout`,
+  `isShortSlot`, `resolveSectionRef`, `resolveAnchorMap` and `parseTreatment` — the
+  node-side schema and island helpers the CLI reaches across the peer edge. They are
+  deliberately absent from the authoring barrel: a renderer never imports `./ssr`.
+
+- b7bfc96: Fixtures state media asset ids instead of URLs, and the kit resolves them.
+
+  A fixture now states what a saved page actually holds — `{ photo_id, alt }` — and
+  the kit resolves that id to a URL, an `alt`, and a responsive ladder when it loads
+  the fixture. Previously fixtures stated the post-resolution URL plus a synthesized
+  ladder, which exercised a code path real content never takes and left every preview
+  image broken.
+
+  Breaking changes to `@homepages/template-kit/fixtures`:
+
+  - `mkResponsive` is removed. Nothing needs to call it: the ladder is attached during
+    fixture load.
+  - `PhotoFixture.url` is removed; `PhotoFixture.id` now holds a media asset id.
+  - `ContactFixture.fields` replaces `headshot_url`, `logo_light`, and `logo_dark`
+    with `headshot_id`, `logo_light_id`, and `logo_dark_id`.
+  - `MediaFixture.video_url` becomes `video_id`. `tour_3d_url` is unchanged — a 3D
+    tour is a third-party embed, not a media asset.
+  - `FloorplanAssignment.url` and `.alt` are now optional: a fixture states the plan
+    ref, and url/alt/responsive appear only after resolution.
+
+  To migrate a fixture, drop `url` and `responsive` and keep the id:
+
+  ```diff
+    hero_image: {
+      photo_id: photo.id,
+  -   url: photo.url,
+      alt: photo.alt,
+  -   responsive: mkResponsive(photo.url, 2048, 1259),
+    },
+  ```
+
 ### Patch Changes
 
-- 10f53a7: `template-kit dev`'s canvas hover/select ring no longer overflows the page's
-  x-axis when hovering a full-bleed section (e.g. a hero or header flush with
-  both page edges). The ring's geometry inflated the target's bounding rect by
-  a fixed offset on every side with no bound, so a rect already touching the
-  document edge pushed the ring 2px past it, growing the iframe's horizontal
-  scroll extent. The ring box is now clamped to `[0, containerWidth]`.
-- f3f6d70: `template-kit check` no longer fails on a tsconfig `paths` alias (e.g.
-  `"@/platform/*": ["../platform/*"]`) or on a section whose contract files
-  share a module large enough for esbuild to code-split. Previously the
-  loader's css-stub plugin decided "external vs. bundle" from the specifier's
-  own text, so a `paths`-resolved alias got re-emitted as a literal bare
-  import Node couldn't resolve; separately, the loader's build applied
-  `publicPath` to code-split `chunk-*.js` cross-imports the same way it does
-  to real asset files, producing an import path Node couldn't resolve either.
-  Both are now decided from the actual resolved file, and `publicPath` is no
-  longer set on the loader's build.
-- 1c2c2db: `template-kit dev`'s preview server no longer 500s on `/runtime/base.css`.
-  The route resolved the file at a path the build never emits to
-  (`dist/css/base.css`; the build copies it flat to `dist/base.css`), so every
-  section rendered unstyled — Tailwind-derived colors and layout were silently
-  missing everywhere, only arbitrary-value element geometry survived. The
-  route now checks the built (flat) path first and falls back to the source
-  (`src/css/`) layout, so it resolves correctly both from an installed kit and
-  when running the CLI unbuilt via `tsx` during kit development.
-- 989d23e: `template-kit dev` gains an optional `--diagnostics-cmd` flag: point it at any
-  command that prints `{"violations": [...]}` JSON for a `--template`/`--section`
-  pair, and the standalone section preview
-  (`/sections/<template>/<section>/<fixture>`) shows a dismissible banner when it
-  reports violations. Unset by default — no behavior change for a workspace that
-  doesn't configure it.
-- e1d5792: `template-kit dev`'s preview server now compiles a template's theme-color
-  Tailwind utilities (`bg-primary`, `text-ink`, `bg-background`, etc.) instead
-  of silently dropping them. `assembleTemplateCss` used to concatenate the
-  compiled theme (`compileThemeToCss`, the `@theme inline` alias layer plus
-  its `:root` custom props) onto Tailwind's CLI output _after_ the CLI had
-  already run, so the theme's color tokens were never part of the build graph
-  Tailwind scanned — `@theme` outside that graph is inert, and silently so, so
-  any utility built on a template color never got generated. No error, no
-  warning: every section rendered with correct layout but default
-  black-on-white text and backgrounds. The theme partial is now written to the
-  dev cache and `@import`ed into the Tailwind entry ahead of the section
-  `@source` scans, mirroring how the registry's own publish pipeline
-  (`ci/build-css.ts`) has always assembled it. `fontFaces` is still prepended
-  to the final bundle separately, since a nested `@import url(...)` doesn't
-  hoist out of an imported partial.
-- 2e36277: Escape `>` and `&` as well as `<` in the dev server's island map, matching the escaping used by published pages.
 - 1c4c7dd: Island hydration is now nesting-safe: `hydrateIslands` skips any island marker
   nested inside another marker, so an island can render another island without the
   child being hydrated twice (once by its parent root, once independently). Enables
   interactive islands (accordion, card-slider, carousel) to wrap existing leaf
   islands (expandable-text) on published pages.
-- ff1d6de: `template-kit dev`'s canvas mirror now shows the Islands inspector panel for a
-  section-level selection, not just a slot selection. A `fill-parent`/`fill-self`
-  island with no owning slot of its own only ever gets its shield dropped by a
-  section-level click, so the panel previously could show it as `shielded` but
-  never `interactive`. Existing slot-selection behavior (edit panel + Islands
-  list) is unchanged.
-- 41d0e88: `template-kit dev` now honors a workspace's tsconfig `paths` when resolving
-  imports, the same way `check` already does via esbuild's native tsconfig
-  lookup. Previously the dev server's Vite instance had no `paths` awareness at
-  all, so a workspace mapping (e.g. `"@/lib/*": ["../lib/*"]`) that made `check`
-  pass left `dev` 500ing with `Cannot find module`. A workspace with no `paths`
-  mapping is unaffected.
 
 ## 0.8.0
 

package/README.md

@@ -1,7 +1,9 @@
 # @homepages/template-kit
 
 The authoring surface for HomePages marketing-section templates: schema system,
-contract primitives, the theme system, and the `template-kit` CLI.
+contract primitives, and the theme system. The `template-kit` command lives in its
+own package, [`@homepages/template-cli`](#install) — the kit is what your templates
+`import`.
 
 **Status: 0.0.x.** The **schema system** (the section authoring contract and the closed
 vocabulary it validates against), the **contract primitives**, and the **theme system**
@@ -31,9 +33,16 @@ Prefer to wire a workspace by hand? See **Install** below.
 
 ```bash
 npm install @homepages/template-kit react react-dom
+npm install -D @homepages/template-cli                               # the `template-kit` command
 npm install -D typescript eslint @typescript-eslint/parser esbuild   # the authoring toolchain
 ```
 
+The **command is `template-kit`; the package that provides it is
+`@homepages/template-cli`** — a package/bin mismatch in the same spirit as
+`typescript`/`tsc`. Everything you write is imported from `@homepages/template-kit`;
+the CLI declares the kit as a peer dependency, so a workspace resolves exactly one
+copy of it.
+
 React 19 is a **peer dependency** — the kit never bundles its own copy.
 
 The kit has exactly **one runtime dependency** (`zod`). The authoring toolchain the
@@ -97,6 +106,7 @@ Full contract: **[guide/primitives.md](guide/primitives.md)**.
 | `@homepages/template-kit/browser` | Browser helpers for published pages (site config, signed ingest) |
 | `@homepages/template-kit/styles.css` | The global Tailwind preamble: the breakpoint ladder, the spacing base unit, the motion defaults, kit source registration |
 | `@homepages/template-kit/base.css` | Cascade-layer order, the three reset gaps Tailwind's preflight leaves, `.tr-section`, and the motion tokens |
+| `@homepages/template-cli` | The `template-kit` command (its own package) |
 | `@homepages/eslint-plugin-template` | ESLint flat-config preset (its own package) |
 | `@homepages/template-kit/tsconfig` | tsconfig preset (`"extends"`) |
 
@@ -158,7 +168,7 @@ section also has a standalone page, and so does the whole template at
 payload), and `/api/screenshot` (a full-page PNG, section or whole template). Like
 `check`, it runs **your** toolchain — Vite and Tailwind resolved from your workspace,
 installed with `npm i -D vite @vitejs/plugin-react tailwindcss @tailwindcss/cli` — not
-shipped by the kit. Full contract: **[guide/dev.md](guide/dev.md)**.
+shipped by either package. Full contract: **[guide/dev.md](guide/dev.md)**.
 
 ## Checking a workspace
 
@@ -229,5 +239,5 @@ that vocabulary — your template names its own.
 
 Don't — changesets owns `package.json`'s version. There is nothing else to keep
 in step with it: `KIT_VERSION` is read from `package.json` and inlined at build
-time, and the test suite asserts `template-kit --version` against `package.json`
-to prove the inlining happened.
+time, and the test suite asserts it against `package.json` to prove the inlining
+happened.

package/dist/contracts/fill-treatments.d.ts

@@ -0,0 +1,23 @@
+//#region src/contracts/fill-treatments.d.ts
+declare const GENERATED_KINDS: readonly ["text", "list<text>"];
+type GeneratedKind = (typeof GENERATED_KINDS)[number];
+declare const COMPUTED_FNS: readonly ["haversine_miles", "mint_id"];
+type ComputedFn = (typeof COMPUTED_FNS)[number];
+declare const CATALOG_FIELDS: readonly ["key", "label", "icon", "slot"];
+type CatalogField = (typeof CATALOG_FIELDS)[number];
+type Treatment = {
+  kind: "source";
+  path: string | null;
+} | {
+  kind: "computed";
+  fn: ComputedFn;
+} | {
+  kind: "catalog";
+  field: CatalogField;
+} | {
+  kind: "generated";
+  outKind: GeneratedKind;
+};
+declare function parseTreatment(raw: string): Treatment | null;
+//#endregion
+export { CATALOG_FIELDS, COMPUTED_FNS, CatalogField, ComputedFn, GENERATED_KINDS, GeneratedKind, Treatment, parseTreatment };

package/dist/fixtures/sample-property.d.ts

@@ -1,15 +1,12 @@
-import { ResponsiveImage } from "../contracts/image-descriptor.js";
 //#region src/fixtures/sample-property.d.ts
 type PhotoFixture = {
   id: string;
-  url: string;
   alt: string;
   tags: {
     room?: string;
     category?: string;
   };
 };
-declare function mkResponsive(url: string, width: number, height: number): ResponsiveImage;
 type PoiFixture = {
   id: string;
   category: "restaurant" | "park" | "transit" | "shopping" | "coffee" | "fitness";
@@ -31,14 +28,14 @@ type ContactFixture = {
     display_name: string;
     title: string;
     bio: string;
-    headshot_url: string;
+    headshot_id: string;
     website_url: string;
     email: string;
     phone: string;
     address: string;
     org_name: string;
-    logo_light: string | null;
-    logo_dark: string | null;
+    logo_light_id: string | null;
+    logo_dark_id: string | null;
     socials: Array<{
       platform: "instagram" | "linkedin" | "x" | "facebook";
       url: string;
@@ -54,4 +51,4 @@ type AmenityItem = {
   items: string[];
 };
 //#endregion
-export { AmenityItem, ContactFixture, PhotoFixture, PoiFixture, mkResponsive };
+export { AmenityItem, ContactFixture, PhotoFixture, PoiFixture };

package/dist/fixtures/sample-property.js

@@ -1,9 +1,7 @@
 //#region src/fixtures/sample-property.ts
-const PHOTO_BASE = "https://example.invalid/photos/queensway";
 const galleryPhotos = [
 	{
-		id: "ph_001",
-		url: `${PHOTO_BASE}/01-lobby.jpg`,
+		id: "dev_upl_queensway_01_lobby",
 		alt: "Lobby with terrazzo flooring and chandeliers.",
 		tags: {
 			room: "lobby",
@@ -11,8 +9,7 @@ const galleryPhotos = [
 		}
 	},
 	{
-		id: "ph_002",
-		url: `${PHOTO_BASE}/02-gym-a.jpg`,
+		id: "dev_upl_queensway_02_gym_a",
 		alt: "Gym with cardio equipment and floor-to-ceiling mirrors.",
 		tags: {
 			room: "gym",
@@ -20,8 +17,7 @@ const galleryPhotos = [
 		}
 	},
 	{
-		id: "ph_003",
-		url: `${PHOTO_BASE}/03-gym-b.jpg`,
+		id: "dev_upl_queensway_03_gym_b",
 		alt: "Gym free-weights area.",
 		tags: {
 			room: "gym",
@@ -29,8 +25,7 @@ const galleryPhotos = [
 		}
 	},
 	{
-		id: "ph_004",
-		url: `${PHOTO_BASE}/04-living-a.jpg`,
+		id: "dev_upl_queensway_04_living_a",
 		alt: "Living area with bay windows and original mouldings.",
 		tags: {
 			room: "living",
@@ -38,8 +33,7 @@ const galleryPhotos = [
 		}
 	},
 	{
-		id: "ph_005",
-		url: `${PHOTO_BASE}/05-living-b.jpg`,
+		id: "dev_upl_queensway_05_living_b",
 		alt: "Living area facing the fireplace.",
 		tags: {
 			room: "living",
@@ -47,8 +41,7 @@ const galleryPhotos = [
 		}
 	},
 	{
-		id: "ph_006",
-		url: `${PHOTO_BASE}/06-kitchen-a.jpg`,
+		id: "dev_upl_queensway_06_kitchen_a",
 		alt: "Kitchen with quartz waterfall island.",
 		tags: {
 			room: "kitchen",
@@ -56,8 +49,7 @@ const galleryPhotos = [
 		}
 	},
 	{
-		id: "ph_007",
-		url: `${PHOTO_BASE}/07-kitchen-b.jpg`,
+		id: "dev_upl_queensway_07_kitchen_b",
 		alt: "Kitchen breakfast nook by the window.",
 		tags: {
 			room: "kitchen",
@@ -65,8 +57,7 @@ const galleryPhotos = [
 		}
 	},
 	{
-		id: "ph_008",
-		url: `${PHOTO_BASE}/08-dining.jpg`,
+		id: "dev_upl_queensway_08_dining",
 		alt: "Dining area set for six.",
 		tags: {
 			room: "dining",
@@ -74,8 +65,7 @@ const galleryPhotos = [
 		}
 	},
 	{
-		id: "ph_009",
-		url: `${PHOTO_BASE}/09-living-c.jpg`,
+		id: "dev_upl_queensway_09_living_c",
 		alt: "Living area with statement art wall.",
 		tags: {
 			room: "living",
@@ -83,8 +73,7 @@ const galleryPhotos = [
 		}
 	},
 	{
-		id: "ph_010",
-		url: `${PHOTO_BASE}/10-living-d.jpg`,
+		id: "dev_upl_queensway_10_living_d",
 		alt: "Living area opening onto private terrace.",
 		tags: {
 			room: "living",
@@ -92,8 +81,7 @@ const galleryPhotos = [
 		}
 	},
 	{
-		id: "ph_011",
-		url: `${PHOTO_BASE}/11-living-e.jpg`,
+		id: "dev_upl_queensway_11_living_e",
 		alt: "Sunken living area with built-in shelving.",
 		tags: {
 			room: "living",
@@ -101,8 +89,7 @@ const galleryPhotos = [
 		}
 	},
 	{
-		id: "ph_012",
-		url: `${PHOTO_BASE}/12-living-f.jpg`,
+		id: "dev_upl_queensway_12_living_f",
 		alt: "Living area corner with reading chair.",
 		tags: {
 			room: "living",
@@ -110,8 +97,7 @@ const galleryPhotos = [
 		}
 	},
 	{
-		id: "ph_013",
-		url: `${PHOTO_BASE}/13-master-bedroom.jpg`,
+		id: "dev_upl_queensway_13_master_bedroom",
 		alt: "Primary bedroom with king bed and skylight.",
 		tags: {
 			room: "bedroom",
@@ -119,8 +105,7 @@ const galleryPhotos = [
 		}
 	},
 	{
-		id: "ph_014",
-		url: `${PHOTO_BASE}/14-master-bath-a.jpg`,
+		id: "dev_upl_queensway_14_master_bath_a",
 		alt: "Spa-style primary bath with freestanding tub.",
 		tags: {
 			room: "bath",
@@ -128,8 +113,7 @@ const galleryPhotos = [
 		}
 	},
 	{
-		id: "ph_015",
-		url: `${PHOTO_BASE}/15-master-bath-b.jpg`,
+		id: "dev_upl_queensway_15_master_bath_b",
 		alt: "Primary bath double vanity and shower.",
 		tags: {
 			room: "bath",
@@ -137,8 +121,7 @@ const galleryPhotos = [
 		}
 	},
 	{
-		id: "ph_016",
-		url: `${PHOTO_BASE}/16-common-bath.jpg`,
+		id: "dev_upl_queensway_16_common_bath",
 		alt: "Common bath with marble subway tile.",
 		tags: {
 			room: "bath",
@@ -146,8 +129,7 @@ const galleryPhotos = [
 		}
 	},
 	{
-		id: "ph_017",
-		url: `${PHOTO_BASE}/17-entrance.jpg`,
+		id: "dev_upl_queensway_17_entrance",
 		alt: "Entrance foyer with original mosaic floor.",
 		tags: {
 			room: "entry",
@@ -155,8 +137,7 @@ const galleryPhotos = [
 		}
 	},
 	{
-		id: "ph_018",
-		url: `${PHOTO_BASE}/18-patio.jpg`,
+		id: "dev_upl_queensway_18_patio",
 		alt: "Patio with built-in seating and planters.",
 		tags: {
 			room: "patio",
@@ -164,8 +145,7 @@ const galleryPhotos = [
 		}
 	},
 	{
-		id: "ph_019",
-		url: `${PHOTO_BASE}/19-outdoor-deck.jpg`,
+		id: "dev_upl_queensway_19_outdoor_deck",
 		alt: "Outdoor deck with sunset view.",
 		tags: {
 			room: "deck",
@@ -173,8 +153,7 @@ const galleryPhotos = [
 		}
 	},
 	{
-		id: "ph_020",
-		url: `${PHOTO_BASE}/20-exterior-hero.jpg`,
+		id: "dev_upl_queensway_20_exterior_hero",
 		alt: "Mansard victorian facade at golden hour.",
 		tags: {
 			room: "exterior-front",
@@ -183,56 +162,21 @@ const galleryPhotos = [
 	}
 ];
 const allPhotos = galleryPhotos;
-const RUNG_WIDTHS = [
-	320,
-	640,
-	960,
-	1200,
-	1600,
-	2048
-];
-function mkResponsive(url, width, height) {
-	const widths = RUNG_WIDTHS.filter((w) => w <= width);
-	if (widths.length === 0) widths.push(width);
-	const ladder = (ext) => widths.map((w) => `${url}.${w}.${ext} ${w}w`).join(", ");
-	return {
-		sources: [
-			{
-				type: "image/avif",
-				srcset: ladder("avif")
-			},
-			{
-				type: "image/webp",
-				srcset: ladder("webp")
-			},
-			{
-				type: "image/jpeg",
-				srcset: ladder("jpg")
-			}
-		],
-		width,
-		height
-	};
-}
-const FP_BASE = "https://example.invalid/floorplans/queensway";
-function fp(id, url, alt, floorLabel, position) {
+function fp(id, floorLabel, position) {
 	return {
 		id,
-		url,
-		alt,
 		floor_label: floorLabel,
-		position,
-		responsive: mkResponsive(url, 1024, 1024)
+		position
 	};
 }
-const FLOORPLAN_3BR = (suffix) => [fp(`fp_3br_${suffix}_a`, `${FP_BASE}/3br-${suffix}-l1.png`, "3BR layout — main floor.", "Main Floor", 0), fp(`fp_3br_${suffix}_b`, `${FP_BASE}/3br-${suffix}-l2.png`, "3BR layout — upper floor.", "Upper Floor", 1)];
-const FLOORPLAN_2BR = (suffix) => [fp(`fp_2br_${suffix}_a`, `${FP_BASE}/2br-${suffix}-l1.png`, "2BR layout.", null, 0)];
+const FLOORPLAN_3BR = (suffix) => [fp(`dev_efp_queensway_3br_${suffix}_l1`, "Main Floor", 0), fp(`dev_efp_queensway_3br_${suffix}_l2`, "Upper Floor", 1)];
+const FLOORPLAN_2BR = (suffix) => [fp(`dev_efp_queensway_2br_${suffix}_l1`, null, 0)];
 const FLOORPLAN_4BR = (suffix) => [
-	fp(`fp_4br_${suffix}_a`, `${FP_BASE}/4br-${suffix}-l1.png`, "4BR layout — main floor.", "Main Floor", 0),
-	fp(`fp_4br_${suffix}_b`, `${FP_BASE}/4br-${suffix}-l2.png`, "4BR layout — upper floor.", "Upper Floor", 1),
-	fp(`fp_4br_${suffix}_c`, `${FP_BASE}/4br-${suffix}-l3.png`, "4BR layout — penthouse.", "Penthouse", 2)
+	fp(`dev_efp_queensway_4br_${suffix}_l1`, "Main Floor", 0),
+	fp(`dev_efp_queensway_4br_${suffix}_l2`, "Upper Floor", 1),
+	fp(`dev_efp_queensway_4br_${suffix}_l3`, "Penthouse", 2)
 ];
-const FLOORPLAN_STUDIO = (suffix) => [fp(`fp_studio_${suffix}_a`, `${FP_BASE}/studio-${suffix}-l1.png`, "Studio layout.", null, 0)];
+const FLOORPLAN_STUDIO = (suffix) => [fp(`dev_efp_queensway_studio_${suffix}_l1`, null, 0)];
 function unit(position, unitLabel, beds, baths, sqft, price, notes, description, features, floorPlans) {
 	return {
 		unit_id: `unit_${String(position + 1).padStart(2, "0")}`,
@@ -645,14 +589,14 @@ const sampleContacts = [
 			display_name: "James Donovan",
 			title: "Listing Agent",
 			bio: "James Donovan is a 15-year veteran of the Boston real estate market, specializing in historic multi-family conversions in Jamaica Plain and the South End. He has closed over $400M in residential transactions and is known for white-glove attention to multi-unit listings.",
-			headshot_url: "https://example.invalid/contacts/james-donovan.jpg",
+			headshot_id: "dev_lib_james_donovan",
 			website_url: "https://okane-marketing.example.invalid",
 			email: "info@homepages.io",
 			phone: "(617) 555-1068",
 			address: "677 Centre St, Suite 200, Jamaica Plain, MA 02130",
 			org_name: "Okane Marketing",
-			logo_light: "https://example.invalid/brand/okane-logo-light.svg",
-			logo_dark: "https://example.invalid/brand/okane-logo-dark.svg",
+			logo_light_id: "dev_lib_okane_logo_light",
+			logo_dark_id: "dev_lib_okane_logo_dark",
 			socials: [
 				{
 					platform: "instagram",
@@ -682,14 +626,14 @@ const sampleContacts = [
 			display_name: "Elena Marsh",
 			title: "Buyer's Agent",
 			bio: "Elena Marsh has guided over 120 buyer clients through the Boston multi-family market since joining the team in 2018, with a focus on Jamaica Plain, Roslindale, and West Roxbury first-time and investor purchases. She is a certified condo-conversion specialist and negotiates every offer personally.",
-			headshot_url: "https://example.invalid/contacts/elena-marsh.jpg",
+			headshot_id: "dev_lib_elena_marsh",
 			website_url: "https://okane-marketing.example.invalid",
 			email: "elena@homepages.io",
 			phone: "(617) 555-2214",
 			address: "677 Centre St, Suite 200, Jamaica Plain, MA 02130",
 			org_name: "Okane Marketing",
-			logo_light: "https://example.invalid/brand/okane-logo-light.svg",
-			logo_dark: "https://example.invalid/brand/okane-logo-dark.svg",
+			logo_light_id: "dev_lib_okane_logo_light",
+			logo_dark_id: "dev_lib_okane_logo_dark",
 			socials: [{
 				platform: "instagram",
 				url: "https://instagram.com/elenamarsh.realty/"
@@ -708,14 +652,14 @@ const sampleContacts = [
 			display_name: "Marcus Webb",
 			title: "Director of Sales",
 			bio: "Marcus Webb leads the team's dispositions practice, working with investors and owner-occupants on multi-unit acquisitions and conversions across greater Boston. A former general contractor, he brings a builder's eye to every walkthrough and has overseen more than 60 multi-family closings.",
-			headshot_url: "https://example.invalid/contacts/marcus-webb.jpg",
+			headshot_id: "dev_lib_marcus_webb",
 			website_url: "https://okane-marketing.example.invalid",
 			email: "marcus@homepages.io",
 			phone: "(617) 555-3357",
 			address: "677 Centre St, Suite 200, Jamaica Plain, MA 02130",
 			org_name: "Okane Marketing",
-			logo_light: "https://example.invalid/brand/okane-logo-light.svg",
-			logo_dark: "https://example.invalid/brand/okane-logo-dark.svg",
+			logo_light_id: "dev_lib_okane_logo_light",
+			logo_dark_id: "dev_lib_okane_logo_dark",
 			socials: [{
 				platform: "linkedin",
 				url: "https://linkedin.com/in/marcus-webb-realty/"
@@ -824,10 +768,10 @@ const sampleProperty = {
 		phone: c.fields.phone,
 		address: c.fields.address,
 		website_url: c.fields.website_url,
-		avatar_upload_id: `upload_headshot_${c.library_item_id}`,
+		avatar_upload_id: c.fields.headshot_id,
 		org_name: c.fields.org_name,
-		logo_light_upload_id: c.fields.logo_light ? `upload_logo_light_${c.library_item_id}` : null,
-		logo_dark_upload_id: c.fields.logo_dark ? `upload_logo_dark_${c.library_item_id}` : null,
+		logo_light_upload_id: c.fields.logo_light_id,
+		logo_dark_upload_id: c.fields.logo_dark_id,
 		instagram_url: c.fields.socials.find((s) => s.platform === "instagram")?.url ?? null,
 		linkedin_url: c.fields.socials.find((s) => s.platform === "linkedin")?.url ?? null,
 		x_url: c.fields.socials.find((s) => s.platform === "x")?.url ?? null,
@@ -836,4 +780,4 @@ const sampleProperty = {
 };
 
 //#endregion
-export { allPhotos, mkResponsive, sampleAmenities, sampleContacts, samplePois, sampleProperty };
+export { allPhotos, sampleAmenities, sampleContacts, samplePois, sampleProperty };

package/dist/fixtures/scenario.d.ts

@@ -3,7 +3,7 @@ import { AmenityItem, ContactFixture, PhotoFixture, PoiFixture } from "./sample-
 //#region src/fixtures/scenario.d.ts
 type ScenarioKey = "luxuryMultiUnit" | "sparseSingleFamily" | "forRentCondo";
 type MediaFixture = {
-  video_url: string | null;
+  video_id: string | null;
   tour_3d_url: string | null;
 };
 type Scenario = {