@scenography/plugin-artwork 0.2.0

package/dist/index.cjs

@@ -0,0 +1,358 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_data = require("./data-WcCPqQ_k.cjs");
+let _scenography_engine = require("@scenography/engine");
+let three = require("three");
+//#region src/buildLabel.ts
+const MM_PER_PT = .3528;
+const UNITS_PER_MM = .1;
+const PX_PER_UNIT = 48;
+const ptToUnits = (pt) => pt * MM_PER_PT * UNITS_PER_MM;
+const ptToPx = (pt) => ptToUnits(pt) * PX_PER_UNIT;
+const TITLE_PT = 24;
+const BODY_PT = 18;
+const DOT_DIAMETER_UNITS = .5;
+const PAD_PX = 4 * UNITS_PER_MM * PX_PER_UNIT;
+const LINE_GAP_PX = 2 * UNITS_PER_MM * PX_PER_UNIT;
+const AVAILABILITY_COLOR = {
+	"for-sale": "#22c55e",
+	sold: "#ef4444",
+	"not-for-sale": "#ef4444"
+};
+const has = (fields, field) => fields.includes(field);
+const joinParts = (parts, sep) => parts.filter((p) => Boolean(p)).join(sep);
+/**
+* Build a physical wall label (cartela) for an artwork, rendered to a canvas
+* texture at real physical size: a bold 24pt title, 18pt body, and a 5 mm
+* availability dot in the top-right corner. Field visibility follows
+* `artwork.label.fields` (default `DEFAULT_ARTWORK_FIELDS`); render order is fixed
+* regardless of array order. Returns `null` when nothing is visible.
+*/
+function buildLabel(artwork) {
+	const fields = artwork.label?.fields ?? require_data.DEFAULT_ARTWORK_FIELDS;
+	const lines = [];
+	if (has(fields, "title") && artwork.title) lines.push({
+		text: artwork.title,
+		px: ptToPx(TITLE_PT),
+		bold: true
+	});
+	const authorYear = joinParts([has(fields, "author") ? artwork.author : void 0, has(fields, "year") ? artwork.year?.toString() : void 0], ", ");
+	if (authorYear) lines.push({
+		text: authorYear,
+		px: ptToPx(BODY_PT),
+		bold: false
+	});
+	const techDims = joinParts([has(fields, "technique") ? artwork.technique : void 0, has(fields, "dimensions") ? artwork.dimensions : void 0], ", ");
+	if (techDims) lines.push({
+		text: techDims,
+		px: ptToPx(BODY_PT),
+		bold: false
+	});
+	const showDot = has(fields, "availability") && artwork.availability !== void 0;
+	if (lines.length === 0 && !showDot) return null;
+	const canvas = document.createElement("canvas");
+	const ctx = canvas.getContext("2d");
+	if (!ctx) return null;
+	const font = (line) => `${line.bold ? "700" : "400"} ${line.px}px system-ui, sans-serif`;
+	const dotPx = DOT_DIAMETER_UNITS * PX_PER_UNIT;
+	let maxTextWidth = 0;
+	for (const line of lines) {
+		ctx.font = font(line);
+		maxTextWidth = Math.max(maxTextWidth, ctx.measureText(line.text).width);
+	}
+	canvas.width = Math.ceil(maxTextWidth + (showDot ? 33.6 : 0) + 2 * PAD_PX);
+	const contentHeight = lines.reduce((sum, l) => sum + l.px + LINE_GAP_PX, 0);
+	canvas.height = Math.ceil(Math.max(contentHeight, dotPx) + 2 * PAD_PX);
+	ctx.fillStyle = "#f7f5f0";
+	ctx.fillRect(0, 0, canvas.width, canvas.height);
+	ctx.textBaseline = "top";
+	ctx.fillStyle = "#1c1917";
+	let y = PAD_PX;
+	for (const line of lines) {
+		ctx.font = font(line);
+		ctx.fillText(line.text, PAD_PX, y);
+		y += line.px + LINE_GAP_PX;
+	}
+	if (showDot) {
+		ctx.beginPath();
+		ctx.arc(canvas.width - PAD_PX - dotPx / 2, 31.200000000000003, dotPx / 2, 0, Math.PI * 2);
+		ctx.fillStyle = AVAILABILITY_COLOR[artwork.availability];
+		ctx.fill();
+	}
+	const texture = new three.CanvasTexture(canvas);
+	texture.colorSpace = three.SRGBColorSpace;
+	texture.minFilter = three.LinearFilter;
+	texture.magFilter = three.LinearFilter;
+	const scale = artwork.label?.scale ?? 1;
+	const worldWidth = canvas.width / PX_PER_UNIT * scale;
+	const worldHeight = canvas.height / PX_PER_UNIT * scale;
+	const mesh = new three.Mesh(new three.PlaneGeometry(worldWidth, worldHeight), new three.MeshBasicMaterial({
+		map: texture,
+		transparent: true
+	}));
+	mesh.name = `label:${artwork.id}`;
+	return {
+		object: mesh,
+		worldWidth,
+		worldHeight
+	};
+}
+//#endregion
+//#region src/placement.ts
+const SURFACE_GAP = 1;
+const DEFAULT_DEPTH$1 = 2;
+const clamp01 = (t) => Math.min(Math.max(t, 0), 1);
+const parseMeasure = (m) => typeof m === "number" ? {
+	value: m,
+	percent: false
+} : {
+	value: parseFloat(m),
+	percent: true
+};
+/**
+* Resolve an artwork's placement from its location, the resolved wall edges and
+* the default eye height. Pure geometry — no three.js. Returns `null` for a
+* wall piece whose edge is not (yet) in the index, so the caller can skip it.
+*/
+function placeArtwork(artwork, edges, eyeHeight) {
+	const loc = artwork.location;
+	if (loc.type === "floating") return {
+		position: [
+			loc.point[0],
+			loc.point[1],
+			loc.point[2]
+		],
+		yaw: loc.yaw ?? 0
+	};
+	const edge = edges.get(loc.edge);
+	if (!edge) return null;
+	const [ax, az] = edge.a;
+	const [bx, bz] = edge.b;
+	const dx = bx - ax;
+	const dz = bz - az;
+	const length = Math.hypot(dx, dz) || 1;
+	const ux = dx / length;
+	const uz = dz / length;
+	const pos = parseMeasure(loc.position);
+	const t = clamp01(pos.percent ? pos.value / 100 : pos.value / length);
+	const px = ax + dx * t;
+	const pz = az + dz * t;
+	let py = eyeHeight;
+	if (loc.height !== void 0) {
+		const h = parseMeasure(loc.height);
+		py = h.percent ? h.value / 100 * edge.height : h.value;
+	}
+	const sign = loc.side === "left" ? -1 : 1;
+	const nx = uz * sign;
+	const nz = -ux * sign;
+	const depth = artwork.depth ?? DEFAULT_DEPTH$1;
+	const offset = edge.thickness / 2 + SURFACE_GAP + depth / 2;
+	return {
+		position: [
+			px + nx * offset,
+			py,
+			pz + nz * offset
+		],
+		yaw: Math.atan2(nx, nz)
+	};
+}
+//#endregion
+//#region src/buildArtwork.ts
+const loader = new three.TextureLoader();
+const DEFAULT_DEPTH = 2;
+const DEFAULT_FRAME_WIDTH = 5;
+const DEFAULT_FRAME_DEPTH = 3;
+const DEFAULT_FRAME_COLOR = "#2e2622";
+const DEFAULT_MAT_WIDTH = 6;
+const DEFAULT_MAT_COLOR = "#f4f0e8";
+const MAT_GAP = .2;
+const IMAGE_GAP = .4;
+const frameMaterial = (frame) => {
+	const material = new three.MeshStandardMaterial({
+		color: frame.color ?? DEFAULT_FRAME_COLOR,
+		roughness: .7
+	});
+	return {
+		material,
+		needsUv1: frame.texture ? (0, _scenography_engine.applyTexture)(material, frame.texture) : false
+	};
+};
+/** Four flat bars forming a border around the front face, standing proud of it. */
+function buildFrameBars(frame, width, height, front) {
+	const fw = frame.width ?? DEFAULT_FRAME_WIDTH;
+	const fd = frame.depth ?? DEFAULT_FRAME_DEPTH;
+	const { material, needsUv1 } = frameMaterial(frame);
+	const group = new three.Group();
+	const z = front + fd / 2;
+	const bars = [
+		[
+			width + 2 * fw,
+			fw,
+			0,
+			height / 2 + fw / 2
+		],
+		[
+			width + 2 * fw,
+			fw,
+			0,
+			-(height / 2 + fw / 2)
+		],
+		[
+			fw,
+			height,
+			-(width / 2 + fw / 2),
+			0
+		],
+		[
+			fw,
+			height,
+			width / 2 + fw / 2,
+			0
+		]
+	];
+	for (const [bw, bh, x, y] of bars) {
+		const geometry = new three.BoxGeometry(bw, bh, fd);
+		if (needsUv1) {
+			const uv = geometry.getAttribute("uv");
+			if (uv) geometry.setAttribute("uv1", uv);
+		}
+		const bar = new three.Mesh(geometry, material);
+		bar.position.set(x, y, z);
+		bar.castShadow = true;
+		bar.receiveShadow = true;
+		group.add(bar);
+	}
+	return group;
+}
+/** Load an ornate frame from an external glTF/GLB, placed at the front face. */
+function loadFrameModel(group, src, front) {
+	import("three/examples/jsm/loaders/GLTFLoader.js").then(({ GLTFLoader }) => {
+		new GLTFLoader().load(src, (gltf) => {
+			gltf.scene.position.z = front;
+			gltf.scene.traverse((child) => {
+				child.castShadow = true;
+				child.receiveShadow = true;
+			});
+			group.add(gltf.scene);
+		});
+	});
+}
+/**
+* Build the artwork piece: a box (the image on the front, white sides and back),
+* an optional passepartout mat, and an optional frame (generated bars or an
+* external model). Shared by every location type.
+*/
+function buildPiece(artwork) {
+	const [width, height] = artwork.size;
+	const depth = artwork.depth ?? DEFAULT_DEPTH;
+	const front = depth / 2;
+	const group = new three.Group();
+	const body = new three.Mesh(new three.BoxGeometry(width, height, depth), new three.MeshStandardMaterial({
+		color: "#ffffff",
+		roughness: .9
+	}));
+	body.castShadow = true;
+	body.receiveShadow = true;
+	group.add(body);
+	const frame = artwork.frame;
+	const mat = frame?.passepartout;
+	let imageWidth = width;
+	let imageHeight = height;
+	if (mat) {
+		const mw = mat.width ?? DEFAULT_MAT_WIDTH;
+		const matMesh = new three.Mesh(new three.PlaneGeometry(width, height), new three.MeshStandardMaterial({
+			color: mat.color ?? DEFAULT_MAT_COLOR,
+			roughness: .95
+		}));
+		matMesh.position.z = front + MAT_GAP;
+		matMesh.receiveShadow = true;
+		group.add(matMesh);
+		imageWidth = Math.max(width - 2 * mw, 1);
+		imageHeight = Math.max(height - 2 * mw, 1);
+	}
+	const texture = loader.load(artwork.src);
+	texture.colorSpace = three.SRGBColorSpace;
+	const image = new three.Mesh(new three.PlaneGeometry(imageWidth, imageHeight), new three.MeshStandardMaterial({
+		map: texture,
+		roughness: .9
+	}));
+	image.position.z = front + IMAGE_GAP;
+	image.receiveShadow = true;
+	group.add(image);
+	if (frame) if (frame.model) loadFrameModel(group, frame.model, front);
+	else group.add(buildFrameBars(frame, width, height, front));
+	return group;
+}
+/**
+* Build the three.js object for an `Artwork`, placing it according to its
+* `location`. Wall-hung pieces are positioned along a resolved edge (the box's
+* back resting on the wall); floating pieces use explicit coordinates. Returns
+* `null` if a wall location references an edge that no longer exists.
+*/
+function buildArtwork(artwork, edges, eyeHeight) {
+	const group = buildPiece(artwork);
+	const depth = artwork.depth ?? DEFAULT_DEPTH;
+	const [pieceWidth, pieceHeight] = artwork.size;
+	const front = depth / 2;
+	const label = artwork.label ? buildLabel(artwork) : null;
+	if (label) {
+		const z = -depth / 2 + .5;
+		const side = artwork.label?.side ?? "below";
+		const frameExtent = artwork.frame ? artwork.frame.width ?? DEFAULT_FRAME_WIDTH : 0;
+		const [ox, oy] = artwork.label?.offset ?? [0, 0];
+		if (side === "below") {
+			const y = -(pieceHeight / 2 + frameExtent + 3 + label.worldHeight / 2);
+			label.object.position.set(ox, y + oy, z);
+		} else {
+			const x = (side === "left" ? -1 : 1) * (pieceWidth / 2 + frameExtent + 3 + label.worldWidth / 2);
+			label.object.position.set(x + ox, oy, z);
+		}
+		label.object.userData.pickTarget = artwork.id;
+		label.object.userData.pickInfo = {
+			width: label.worldWidth,
+			height: label.worldHeight,
+			frontOffset: .2
+		};
+		group.add(label.object);
+	} else {
+		group.userData.pickTarget = artwork.id;
+		group.userData.pickInfo = {
+			width: pieceWidth,
+			height: pieceHeight,
+			frontOffset: front + .6
+		};
+	}
+	const placement = placeArtwork(artwork, edges, eyeHeight);
+	if (!placement) return null;
+	group.position.set(...placement.position);
+	group.rotation.y = placement.yaw;
+	group.name = `artwork:${artwork.id}`;
+	group.userData.scenographyId = artwork.id;
+	group.userData.size = artwork.size;
+	return group;
+}
+//#endregion
+//#region src/plugin.ts
+const EMPTY_EDGES = /* @__PURE__ */ new Map();
+const DEFAULT_EYE_HEIGHT = 150;
+/**
+* The artwork plugin: materializes each `Artwork` as a framed box (with an
+* optional physical label), placed on a wall edge or floating. Consumes the
+* `edges` capability (from the wall plugin) to resolve wall placements and
+* `eyeHeight` for the default hang height, rebuilding when either changes.
+*/
+const artwork = () => ({
+	data: require_data.artworkData,
+	dependsOn: [_scenography_engine.EDGES, _scenography_engine.EYE_HEIGHT],
+	build: (definition, ctx) => {
+		const object = buildArtwork(definition, ctx.capabilities.get(_scenography_engine.EDGES) ?? EMPTY_EDGES, ctx.capabilities.get(_scenography_engine.EYE_HEIGHT) ?? DEFAULT_EYE_HEIGHT);
+		return object ? { object } : {};
+	}
+});
+//#endregion
+exports.DEFAULT_ARTWORK_FIELDS = require_data.DEFAULT_ARTWORK_FIELDS;
+exports.artwork = artwork;
+exports.artworkData = require_data.artworkData;
+exports.buildArtwork = buildArtwork;
+exports.validateArtwork = require_data.validateArtwork;
+
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["DEFAULT_ARTWORK_FIELDS","CanvasTexture","SRGBColorSpace","LinearFilter","Mesh","PlaneGeometry","MeshBasicMaterial","DEFAULT_DEPTH","TextureLoader","MeshStandardMaterial","Group","BoxGeometry","Mesh","PlaneGeometry","SRGBColorSpace","artworkData","EDGES","EYE_HEIGHT"],"sources":["../src/buildLabel.ts","../src/placement.ts","../src/buildArtwork.ts","../src/plugin.ts"],"sourcesContent":["import {\n  CanvasTexture,\n  LinearFilter,\n  Mesh,\n  MeshBasicMaterial,\n  PlaneGeometry,\n  SRGBColorSpace,\n  type Object3D,\n} from \"three\";\nimport { DEFAULT_ARTWORK_FIELDS, type Artwork, type ArtworkField } from \"./data\";\n\n// World units are centimeters (100 units = 1 m), so the label is sized to real\n// physical dimensions. Text is rasterized to a canvas (zero assets shipped); the\n// canvas resolution (px per world unit) only affects crispness, not size.\nconst MM_PER_PT = 0.3528;\nconst UNITS_PER_MM = 0.1; // 1 unit = 1 cm = 10 mm\nconst PX_PER_UNIT = 48; // canvas resolution\n\nconst ptToUnits = (pt: number): number => pt * MM_PER_PT * UNITS_PER_MM;\nconst ptToPx = (pt: number): number => ptToUnits(pt) * PX_PER_UNIT;\n\nconst TITLE_PT = 24;\nconst BODY_PT = 18;\nconst DOT_DIAMETER_UNITS = 0.5; // 5 mm\nconst PAD_PX = 4 * UNITS_PER_MM * PX_PER_UNIT; // ~4 mm padding\nconst LINE_GAP_PX = 2 * UNITS_PER_MM * PX_PER_UNIT; // ~2 mm between lines\n\n/** Gap between the piece and its label, in world units (cm). */\nexport const LABEL_GAP = 3;\n\nconst AVAILABILITY_COLOR: Record<NonNullable<Artwork[\"availability\"]>, string> = {\n  \"for-sale\": \"#22c55e\",\n  sold: \"#ef4444\",\n  \"not-for-sale\": \"#ef4444\",\n};\n\nconst has = (fields: readonly ArtworkField[], field: ArtworkField): boolean =>\n  fields.includes(field);\nconst joinParts = (parts: (string | undefined)[], sep: string): string =>\n  parts.filter((p): p is string => Boolean(p)).join(sep);\n\n/** A built physical label plus its real-world size (for placement/picking). */\nexport interface BuiltLabel {\n  object: Object3D;\n  worldWidth: number;\n  worldHeight: number;\n}\n\n/**\n * Build a physical wall label (cartela) for an artwork, rendered to a canvas\n * texture at real physical size: a bold 24pt title, 18pt body, and a 5 mm\n * availability dot in the top-right corner. Field visibility follows\n * `artwork.label.fields` (default `DEFAULT_ARTWORK_FIELDS`); render order is fixed\n * regardless of array order. Returns `null` when nothing is visible.\n */\nexport function buildLabel(artwork: Artwork): BuiltLabel | null {\n  const fields = artwork.label?.fields ?? DEFAULT_ARTWORK_FIELDS;\n\n  const lines: { text: string; px: number; bold: boolean }[] = [];\n  if (has(fields, \"title\") && artwork.title)\n    lines.push({ text: artwork.title, px: ptToPx(TITLE_PT), bold: true });\n  const authorYear = joinParts(\n    [\n      has(fields, \"author\") ? artwork.author : undefined,\n      has(fields, \"year\") ? artwork.year?.toString() : undefined,\n    ],\n    \", \",\n  );\n  if (authorYear) lines.push({ text: authorYear, px: ptToPx(BODY_PT), bold: false });\n  const techDims = joinParts(\n    [\n      has(fields, \"technique\") ? artwork.technique : undefined,\n      has(fields, \"dimensions\") ? artwork.dimensions : undefined,\n    ],\n    \", \",\n  );\n  if (techDims) lines.push({ text: techDims, px: ptToPx(BODY_PT), bold: false });\n\n  const showDot = has(fields, \"availability\") && artwork.availability !== undefined;\n  if (lines.length === 0 && !showDot) return null;\n\n  const canvas = document.createElement(\"canvas\");\n  const ctx = canvas.getContext(\"2d\");\n  if (!ctx) return null;\n\n  const font = (line: { px: number; bold: boolean }): string =>\n    `${line.bold ? \"700\" : \"400\"} ${line.px}px system-ui, sans-serif`;\n\n  // Width from the widest line (plus room for the dot on the first line), height\n  // from the stacked lines — so the card is exactly as big as its content.\n  const dotPx = DOT_DIAMETER_UNITS * PX_PER_UNIT;\n  let maxTextWidth = 0;\n  for (const line of lines) {\n    ctx.font = font(line);\n    maxTextWidth = Math.max(maxTextWidth, ctx.measureText(line.text).width);\n  }\n  const dotReserve = showDot ? dotPx + LINE_GAP_PX : 0;\n  canvas.width = Math.ceil(maxTextWidth + dotReserve + 2 * PAD_PX);\n  const contentHeight = lines.reduce((sum, l) => sum + l.px + LINE_GAP_PX, 0);\n  canvas.height = Math.ceil(Math.max(contentHeight, dotPx) + 2 * PAD_PX);\n\n  ctx.fillStyle = \"#f7f5f0\";\n  ctx.fillRect(0, 0, canvas.width, canvas.height);\n\n  ctx.textBaseline = \"top\";\n  ctx.fillStyle = \"#1c1917\";\n  let y = PAD_PX;\n  for (const line of lines) {\n    ctx.font = font(line);\n    ctx.fillText(line.text, PAD_PX, y);\n    y += line.px + LINE_GAP_PX;\n  }\n\n  if (showDot) {\n    ctx.beginPath();\n    ctx.arc(canvas.width - PAD_PX - dotPx / 2, PAD_PX + dotPx / 2, dotPx / 2, 0, Math.PI * 2);\n    ctx.fillStyle = AVAILABILITY_COLOR[artwork.availability as NonNullable<Artwork[\"availability\"]>];\n    ctx.fill();\n  }\n\n  const texture = new CanvasTexture(canvas);\n  texture.colorSpace = SRGBColorSpace;\n  texture.minFilter = LinearFilter;\n  texture.magFilter = LinearFilter;\n\n  // Real physical size, optionally scaled up for legibility (the canvas\n  // resolution is unchanged, so the text just renders larger on the plane).\n  const scale = artwork.label?.scale ?? 1;\n  const worldWidth = (canvas.width / PX_PER_UNIT) * scale;\n  const worldHeight = (canvas.height / PX_PER_UNIT) * scale;\n  const mesh = new Mesh(\n    new PlaneGeometry(worldWidth, worldHeight),\n    new MeshBasicMaterial({ map: texture, transparent: true }),\n  );\n  mesh.name = `label:${artwork.id}`;\n  return { object: mesh, worldWidth, worldHeight };\n}\n","import type { EdgeIndex } from \"@scenography/engine\";\nimport type { Measure } from \"@scenography/scene\";\n\nimport type { Artwork } from \"./data\";\n\nconst SURFACE_GAP = 1;\nconst DEFAULT_DEPTH = 2;\n\nconst clamp01 = (t: number): number => Math.min(Math.max(t, 0), 1);\n\nconst parseMeasure = (m: Measure): { value: number; percent: boolean } =>\n  typeof m === \"number\" ? { value: m, percent: false } : { value: parseFloat(m), percent: true };\n\n/** Where an artwork sits: world position `[x, y, z]` and Y-axis rotation. */\nexport interface Placement {\n  position: [number, number, number];\n  yaw: number;\n}\n\n/**\n * Resolve an artwork's placement from its location, the resolved wall edges and\n * the default eye height. Pure geometry — no three.js. Returns `null` for a\n * wall piece whose edge is not (yet) in the index, so the caller can skip it.\n */\nexport function placeArtwork(\n  artwork: Artwork,\n  edges: EdgeIndex,\n  eyeHeight: number,\n): Placement | null {\n  const loc = artwork.location;\n  if (loc.type === \"floating\") {\n    return { position: [loc.point[0], loc.point[1], loc.point[2]], yaw: loc.yaw ?? 0 };\n  }\n\n  const edge = edges.get(loc.edge);\n  if (!edge) return null;\n\n  const [ax, az] = edge.a;\n  const [bx, bz] = edge.b;\n  const dx = bx - ax;\n  const dz = bz - az;\n  const length = Math.hypot(dx, dz) || 1;\n  const ux = dx / length;\n  const uz = dz / length;\n\n  // Position along the edge.\n  const pos = parseMeasure(loc.position);\n  const t = clamp01(pos.percent ? pos.value / 100 : pos.value / length);\n  const px = ax + dx * t;\n  const pz = az + dz * t;\n\n  // Vertical placement: eye height by default, or an explicit absolute/percent.\n  let py = eyeHeight;\n  if (loc.height !== undefined) {\n    const h = parseMeasure(loc.height);\n    py = h.percent ? (h.value / 100) * edge.height : h.value;\n  }\n\n  // Outward normal: right-hand side of the edge by default. Offset by the box\n  // half-depth so its back rests against the wall surface.\n  const sign = loc.side === \"left\" ? -1 : 1;\n  const nx = uz * sign;\n  const nz = -ux * sign;\n  const depth = artwork.depth ?? DEFAULT_DEPTH;\n  const offset = edge.thickness / 2 + SURFACE_GAP + depth / 2;\n\n  return {\n    position: [px + nx * offset, py, pz + nz * offset],\n    yaw: Math.atan2(nx, nz),\n  };\n}\n","import {\n  BoxGeometry,\n  Group,\n  Mesh,\n  MeshStandardMaterial,\n  PlaneGeometry,\n  SRGBColorSpace,\n  TextureLoader,\n  type Object3D,\n} from \"three\";\nimport { applyTexture, type EdgeIndex } from \"@scenography/engine\";\n\nimport type { Artwork, Frame } from \"./data\";\nimport { buildLabel, LABEL_GAP } from \"./buildLabel\";\nimport { placeArtwork } from \"./placement\";\n\nconst loader = new TextureLoader();\n\nconst DEFAULT_DEPTH = 2;\nconst DEFAULT_FRAME_WIDTH = 5;\nconst DEFAULT_FRAME_DEPTH = 3;\nconst DEFAULT_FRAME_COLOR = \"#2e2622\";\nconst DEFAULT_MAT_WIDTH = 6;\nconst DEFAULT_MAT_COLOR = \"#f4f0e8\";\n\n// Tiny z-offsets stacked on the box front to avoid z-fighting.\nconst MAT_GAP = 0.2;\nconst IMAGE_GAP = 0.4;\n\nconst frameMaterial = (frame: Frame): { material: MeshStandardMaterial; needsUv1: boolean } => {\n  const material = new MeshStandardMaterial({\n    color: frame.color ?? DEFAULT_FRAME_COLOR,\n    roughness: 0.7,\n  });\n  const needsUv1 = frame.texture ? applyTexture(material, frame.texture) : false;\n  return { material, needsUv1 };\n};\n\n/** Four flat bars forming a border around the front face, standing proud of it. */\nfunction buildFrameBars(frame: Frame, width: number, height: number, front: number): Group {\n  const fw = frame.width ?? DEFAULT_FRAME_WIDTH;\n  const fd = frame.depth ?? DEFAULT_FRAME_DEPTH;\n  const { material, needsUv1 } = frameMaterial(frame);\n  const group = new Group();\n  const z = front + fd / 2;\n\n  // Horizontals span the full outer width (covering the corners); verticals fill\n  // the gap between them (butt joints).\n  const bars: [number, number, number, number][] = [\n    [width + 2 * fw, fw, 0, height / 2 + fw / 2], // top\n    [width + 2 * fw, fw, 0, -(height / 2 + fw / 2)], // bottom\n    [fw, height, -(width / 2 + fw / 2), 0], // left\n    [fw, height, width / 2 + fw / 2, 0], // right\n  ];\n  for (const [bw, bh, x, y] of bars) {\n    const geometry = new BoxGeometry(bw, bh, fd);\n    if (needsUv1) {\n      const uv = geometry.getAttribute(\"uv\");\n      if (uv) geometry.setAttribute(\"uv1\", uv);\n    }\n    const bar = new Mesh(geometry, material);\n    bar.position.set(x, y, z);\n    bar.castShadow = true;\n    bar.receiveShadow = true;\n    group.add(bar);\n  }\n  return group;\n}\n\n/** Load an ornate frame from an external glTF/GLB, placed at the front face. */\nfunction loadFrameModel(group: Group, src: string, front: number): void {\n  void import(\"three/examples/jsm/loaders/GLTFLoader.js\").then(({ GLTFLoader }) => {\n    new GLTFLoader().load(src, (gltf) => {\n      gltf.scene.position.z = front;\n      gltf.scene.traverse((child) => {\n        child.castShadow = true;\n        child.receiveShadow = true;\n      });\n      group.add(gltf.scene);\n    });\n  });\n}\n\n/**\n * Build the artwork piece: a box (the image on the front, white sides and back),\n * an optional passepartout mat, and an optional frame (generated bars or an\n * external model). Shared by every location type.\n */\nfunction buildPiece(artwork: Artwork): Group {\n  const [width, height] = artwork.size;\n  const depth = artwork.depth ?? DEFAULT_DEPTH;\n  const front = depth / 2;\n  const group = new Group();\n\n  const body = new Mesh(\n    new BoxGeometry(width, height, depth),\n    new MeshStandardMaterial({ color: \"#ffffff\", roughness: 0.9 }),\n  );\n  body.castShadow = true;\n  body.receiveShadow = true;\n  group.add(body);\n\n  // Passepartout only applies when there's a frame.\n  const frame = artwork.frame;\n  const mat = frame?.passepartout;\n  let imageWidth = width;\n  let imageHeight = height;\n  if (mat) {\n    const mw = mat.width ?? DEFAULT_MAT_WIDTH;\n    const matMesh = new Mesh(\n      new PlaneGeometry(width, height),\n      new MeshStandardMaterial({ color: mat.color ?? DEFAULT_MAT_COLOR, roughness: 0.95 }),\n    );\n    matMesh.position.z = front + MAT_GAP;\n    matMesh.receiveShadow = true;\n    group.add(matMesh);\n    imageWidth = Math.max(width - 2 * mw, 1);\n    imageHeight = Math.max(height - 2 * mw, 1);\n  }\n\n  const texture = loader.load(artwork.src);\n  texture.colorSpace = SRGBColorSpace;\n  const image = new Mesh(\n    new PlaneGeometry(imageWidth, imageHeight),\n    new MeshStandardMaterial({ map: texture, roughness: 0.9 }),\n  );\n  image.position.z = front + IMAGE_GAP;\n  image.receiveShadow = true;\n  group.add(image);\n\n  if (frame) {\n    if (frame.model) loadFrameModel(group, frame.model, front);\n    else group.add(buildFrameBars(frame, width, height, front));\n  }\n\n  return group;\n}\n\n/**\n * Build the three.js object for an `Artwork`, placing it according to its\n * `location`. Wall-hung pieces are positioned along a resolved edge (the box's\n * back resting on the wall); floating pieces use explicit coordinates. Returns\n * `null` if a wall location references an edge that no longer exists.\n */\nexport function buildArtwork(\n  artwork: Artwork,\n  edges: EdgeIndex,\n  eyeHeight: number,\n): Object3D | null {\n  const group = buildPiece(artwork);\n  const depth = artwork.depth ?? DEFAULT_DEPTH;\n  const [pieceWidth, pieceHeight] = artwork.size;\n  const front = depth / 2;\n\n  // Physical wall label (cartela) next to the piece, when declared. Placed near\n  // the wall surface (the box's back), not at the protruding front face. When a\n  // label exists it's the click target; otherwise the piece itself is (set below).\n  const label = artwork.label ? buildLabel(artwork) : null;\n  if (label) {\n    const z = -depth / 2 + 0.5;\n    const side = artwork.label?.side ?? \"below\";\n    // Clear the frame so the cartela isn't tucked under the (proud) frame bars.\n    const frameExtent = artwork.frame ? (artwork.frame.width ?? DEFAULT_FRAME_WIDTH) : 0;\n    const [ox, oy] = artwork.label?.offset ?? [0, 0];\n    if (side === \"below\") {\n      const y = -(pieceHeight / 2 + frameExtent + LABEL_GAP + label.worldHeight / 2);\n      label.object.position.set(ox, y + oy, z);\n    } else {\n      const sign = side === \"left\" ? -1 : 1;\n      const x = sign * (pieceWidth / 2 + frameExtent + LABEL_GAP + label.worldWidth / 2);\n      label.object.position.set(x + ox, oy, z);\n    }\n    // The label mesh is the pick target; mark only it (not the group) so the\n    // piece stays non-interactive when a label is present.\n    label.object.userData.pickTarget = artwork.id;\n    label.object.userData.pickInfo = { width: label.worldWidth, height: label.worldHeight, frontOffset: 0.2 };\n    group.add(label.object);\n  } else {\n    // No label: the piece is the selector. Mark the group so any of its meshes\n    // resolve to this id, and outline the front image face on hover.\n    group.userData.pickTarget = artwork.id;\n    group.userData.pickInfo = { width: pieceWidth, height: pieceHeight, frontOffset: front + 0.6 };\n  }\n\n  const placement = placeArtwork(artwork, edges, eyeHeight);\n  if (!placement) return null;\n  group.position.set(...placement.position);\n  group.rotation.y = placement.yaw;\n\n  group.name = `artwork:${artwork.id}`;\n  group.userData.scenographyId = artwork.id;\n  // Real-world face size, consumed by the camera framing to fit the piece.\n  group.userData.size = artwork.size;\n  return group;\n}\n","import { EDGES, EYE_HEIGHT, type EdgeIndex, type EnginePlugin } from \"@scenography/engine\";\n\nimport { buildArtwork } from \"./buildArtwork\";\nimport { artworkData, type Artwork } from \"./data\";\n\nconst EMPTY_EDGES: EdgeIndex = new Map();\nconst DEFAULT_EYE_HEIGHT = 150;\n\n/**\n * The artwork plugin: materializes each `Artwork` as a framed box (with an\n * optional physical label), placed on a wall edge or floating. Consumes the\n * `edges` capability (from the wall plugin) to resolve wall placements and\n * `eyeHeight` for the default hang height, rebuilding when either changes.\n */\nexport const artwork = (): EnginePlugin<Artwork> => ({\n  data: artworkData,\n  dependsOn: [EDGES, EYE_HEIGHT],\n  build: (definition, ctx) => {\n    const edges = ctx.capabilities.get<EdgeIndex>(EDGES) ?? EMPTY_EDGES;\n    const eyeHeight = ctx.capabilities.get<number>(EYE_HEIGHT) ?? DEFAULT_EYE_HEIGHT;\n    const object = buildArtwork(definition, edges, eyeHeight);\n    return object ? { object } : {};\n  },\n});\n"],"mappings":"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"}

package/dist/index.d.cts

@@ -0,0 +1,24 @@
+import { a as ArtworkField, c as Availability, d as Passepartout, i as Artwork, l as DEFAULT_ARTWORK_FIELDS, n as validateArtwork, o as ArtworkLabel, s as ArtworkLocation, t as artworkData, u as Frame } from "./index-XUkegdM8.cjs";
+import { EdgeIndex, EnginePlugin } from "@scenography/engine";
+import { Object3D } from "three";
+
+//#region src/plugin.d.ts
+/**
+ * The artwork plugin: materializes each `Artwork` as a framed box (with an
+ * optional physical label), placed on a wall edge or floating. Consumes the
+ * `edges` capability (from the wall plugin) to resolve wall placements and
+ * `eyeHeight` for the default hang height, rebuilding when either changes.
+ */
+declare const artwork: () => EnginePlugin<Artwork>;
+//#endregion
+//#region src/buildArtwork.d.ts
+/**
+ * Build the three.js object for an `Artwork`, placing it according to its
+ * `location`. Wall-hung pieces are positioned along a resolved edge (the box's
+ * back resting on the wall); floating pieces use explicit coordinates. Returns
+ * `null` if a wall location references an edge that no longer exists.
+ */
+declare function buildArtwork(artwork: Artwork, edges: EdgeIndex, eyeHeight: number): Object3D | null;
+//#endregion
+export { type Artwork, type ArtworkField, type ArtworkLabel, type ArtworkLocation, type Availability, DEFAULT_ARTWORK_FIELDS, type Frame, type Passepartout, artwork, artworkData, buildArtwork, validateArtwork };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.mts

@@ -0,0 +1,24 @@
+import { a as ArtworkField, c as Availability, d as Passepartout, i as Artwork, l as DEFAULT_ARTWORK_FIELDS, n as validateArtwork, o as ArtworkLabel, s as ArtworkLocation, t as artworkData, u as Frame } from "./index-XUkegdM8.mjs";
+import { EdgeIndex, EnginePlugin } from "@scenography/engine";
+import { Object3D } from "three";
+
+//#region src/plugin.d.ts
+/**
+ * The artwork plugin: materializes each `Artwork` as a framed box (with an
+ * optional physical label), placed on a wall edge or floating. Consumes the
+ * `edges` capability (from the wall plugin) to resolve wall placements and
+ * `eyeHeight` for the default hang height, rebuilding when either changes.
+ */
+declare const artwork: () => EnginePlugin<Artwork>;
+//#endregion
+//#region src/buildArtwork.d.ts
+/**
+ * Build the three.js object for an `Artwork`, placing it according to its
+ * `location`. Wall-hung pieces are positioned along a resolved edge (the box's
+ * back resting on the wall); floating pieces use explicit coordinates. Returns
+ * `null` if a wall location references an edge that no longer exists.
+ */
+declare function buildArtwork(artwork: Artwork, edges: EdgeIndex, eyeHeight: number): Object3D | null;
+//#endregion
+export { type Artwork, type ArtworkField, type ArtworkLabel, type ArtworkLocation, type Availability, DEFAULT_ARTWORK_FIELDS, type Frame, type Passepartout, artwork, artworkData, buildArtwork, validateArtwork };
+//# sourceMappingURL=index.d.mts.map