@hatiolab/figure-model 0.4.2 → 0.4.3

package/dist/slot-layout.d.ts

@@ -1,4 +1,7 @@
-export type LayoutIssueCode = 'TIERS_REQUIRED' | 'MOUNT_INVALID' | 'TIER_NUMBER_SEQUENCE' | 'ELEVATION_NOT_ASCENDING' | 'FINITE_NUMBER_REQUIRED' | 'POSITIVE_NUMBER_REQUIRED' | 'POSITIVE_INTEGER_REQUIRED' | 'ARRAY_REQUIRED' | 'OBJECT_REQUIRED' | 'AXIS_INVALID' | 'PATTERN_INVALID' | 'SLOT_NUMBER_SEQUENCE'
+import type { Vec3 } from './words.ts';
+export type LayoutIssueCode = 'TIERS_REQUIRED' | 'MOUNT_INVALID' | 'ANCHOR_REQUIRED'
+/** The tier names an anchor the holder does not give (params.anchorId). Checked only when the anchors are known. */
+ | 'ANCHOR_UNKNOWN' | 'TIER_NUMBER_DUPLICATE' | 'FINITE_NUMBER_REQUIRED' | 'POSITIVE_NUMBER_REQUIRED' | 'POSITIVE_INTEGER_REQUIRED' | 'ARRAY_REQUIRED' | 'OBJECT_REQUIRED' | 'AXIS_INVALID' | 'PATTERN_INVALID' | 'SLOTS_REQUIRED' | 'SLOT_NUMBER_DUPLICATE'
 /** A value JSON would turn into null (params.value: NaN, Infinity, -Infinity). */
  | 'NOT_PERSISTABLE';
 /** A problem as a code, the path of the value, and parameters -- never a sentence. The screen words it. */
@@ -9,18 +12,26 @@ export interface LayoutIssue {
     params?: Record<string, string | number>;
 }
 export declare function layoutIssue(code: LayoutIssueCode, path: string, params?: Record<string, string | number>): LayoutIssue;
-/** How a holder carries what it holds: on top, inside, or hanging below. */
+/**
+ * How a tier carries what it holds. ON and IN seat items along the tier's local +Y -- IN differs only in that the room
+ * is enclosed (a judgement about room, not a turned direction); HANG hangs them along -Y.
+ */
 export type SlotMount = 'ON' | 'IN' | 'HANG';
+/** The anchor at the holder's own origin, for a holder that gives no other. */
+export declare const HOLDER_ANCHOR = "holder";
 export interface SlotLayout {
-    mount: SlotMount;
-    /** In tierNo order, bottom to top. */
     tiers: SlotLayoutTier[];
 }
 export interface SlotLayoutTier {
-    /** From 1. */
+    /** The holder's own number for the tier: a positive integer, unique, kept when tiers are removed or reordered. */
     tierNo: number;
-    /** The tier floor's height above the holder's floor -- not added to the tier below's. */
-    elevation: number;
+    /** The anchor the tier stands on. */
+    anchorId: string;
+    mount: SlotMount;
+    /** The tier's centre in its anchor's frame. */
+    position: Vec3;
+    /** Degrees about the anchor's Y. */
+    rotation: number;
     layout: SlotPattern;
 }
 /** How the slots of one tier are arranged. */
@@ -53,16 +64,16 @@ export type SlotPattern = {
     pattern: 'CUSTOM';
     slots: PatternSlot[];
 };
-/** The order GRID slots are numbered in. ROW_MAJOR by default. */
+/** The order GRID slots are numbered in. ROW_MAJOR by default. Changing it changes what an address means. */
 export type GridOrder = 'ROW_MAJOR' | 'COL_MAJOR' | 'SERPENTINE_ROW' | 'SERPENTINE_COL';
-/** The corner GRID slot 1 is at. { x: 'MIN', z: 'MIN' } by default. */
+/** The corner GRID slot 1 is at. { x: 'MIN', z: 'MIN' } by default. Changing it changes what an address means. */
 export interface GridOrigin {
     x: 'MIN' | 'MAX';
     z: 'MIN' | 'MAX';
 }
 /** One slot's room and rules. Every slot of a SINGLE, ROW or GRID tier has the same. */
 export interface SlotSpec {
-    /** The room a held thing may take: width along X, depth along Z, height along Y. */
+    /** The room a held thing may take, in the tier's axes: width along X, depth along Z, height along Y. */
     allowed: {
         width: number;
         depth: number;
@@ -80,7 +91,7 @@ export interface SlotSpec {
 }
 /** A slot of a CUSTOM tier. */
 export interface PatternSlot extends SlotSpec {
-    /** From 1 within the tier. */
+    /** The tier's own number for the slot: a positive integer, unique in the tier, kept when other slots are removed. */
     slotNo: number;
     /** For display (FRONT, REAR, L, R …). */
     name?: string;
@@ -94,12 +105,18 @@ export interface SlotAddress {
     tier: number;
     slot: number;
 }
-/** A slot found by its address. offset is from the tier's centre, elevation from the holder's floor. */
+/** A slot found by its address, with its tier's placement on the anchor. */
 export interface ResolvedSlot {
     tier: number;
     slotNo: number;
     name?: string;
-    elevation: number;
+    anchorId: string;
+    mount: SlotMount;
+    /** The tier's centre in the anchor's frame. */
+    tierPosition: Vec3;
+    /** The tier's turn about the anchor's Y, degrees. */
+    tierRotation: number;
+    /** The slot's centre from the tier's centre, in the tier's axes. */
     offset: {
         x: number;
         z: number;
@@ -111,16 +128,23 @@ export interface ResolvedSlot {
     };
     accepts?: string[];
     stackLimit: number;
+    /** The slot's turn about Y in the tier, degrees. */
     rotation: number;
 }
+export interface ValidateSlotLayoutOptions {
+    /** The anchors the holder gives. Left out: a tier's anchor is not checked against them. */
+    anchors?: Iterable<string>;
+}
 /**
  * Everything wrong with a layout; an empty list is a sound one. stackLimit may be Infinity (no limit); a layout that is
  * to be stored as JSON is also checked with `persistenceIssues`.
  */
-export declare function validateSlotLayout(layout: SlotLayout): LayoutIssue[];
+export declare function validateSlotLayout(layout: SlotLayout, options?: ValidateSlotLayoutOptions): LayoutIssue[];
 /** Values JSON turns into null (NaN, Infinity): stored, they would come back as a broken layout. */
 export declare function persistenceIssues(value: unknown, path?: string): LayoutIssue[];
 export declare function slotCount(pattern: SlotPattern): number;
+/** A tier's slot numbers, in order. ROW and GRID count from 1; CUSTOM has the numbers it was given. */
+export declare function slotNumbers(pattern: SlotPattern): number[];
 /** A GRID slot's number from its row r and column c (from 1), counted from the origin corner. */
 export declare function gridSlotNo(rows: number, cols: number, r: number, c: number, order?: GridOrder): number;
 /** The row and column of a GRID slot number -- the inverse of gridSlotNo. */
@@ -143,21 +167,24 @@ export declare function resolveSlot(layout: SlotLayout, address: SlotAddress, op
 export declare function slotIdOf(address: SlotAddress): string;
 /** The address a slot id names, or null when it is not one. */
 export declare function addressOfSlotId(slotId: unknown): SlotAddress | null;
-/** Every address of a layout, tier by tier. For a big GRID, resolve only the addresses you need. */
+/** Every address of a layout, tier by tier as written. For a big GRID, resolve only the addresses you need. */
 export declare function slotAddresses(layout: SlotLayout): Generator<SlotAddress>;
+/** A place in an anchor's frame: a position and a turn about the anchor's Y in degrees. */
+export interface AnchorFrame {
+    position: Vec3;
+    rotation: number;
+}
+/** A slot's frame in its anchor's: the tier's placement, then the slot's offset and turn in the tier. */
+export declare function slotFrame(slot: ResolvedSlot): AnchorFrame;
 /** An item's size: width along X, depth along Z, height along Y -- in the layout's unit. */
 export interface ItemDims {
     width: number;
     depth: number;
     height: number;
 }
-/** Where an item sits, in the holder's coordinates: its centre, its turn about Y in degrees, and one uniform scale. */
+/** Where an item sits: its centre, its turn about Y in degrees, and one uniform scale. */
 export interface SeatTransform {
-    position: {
-        x: number;
-        y: number;
-        z: number;
-    };
+    position: Vec3;
     rotation: number;
     scale: number;
 }
@@ -168,26 +195,44 @@ export declare function rotatedFootprint(dims: ItemDims, rotation: number): {
     depth: number;
 };
 /**
- * Where an item sits in a slot: shrunk to fit the slot's width and depth (by its turned extent, never enlarged), on top
- * of `belowHeight` -- the shown heights (height × scale) of what is stacked under it. `margin` is room left only for
- * showing (0 ≤ margin < 1); whether it fits is judged elsewhere, at full size. Null when a size or value is unusable --
- * never NaN or Infinity.
+ * Where an item sits in its slot's own frame: shrunk to fit the slot's width and depth (by its turned extent, never
+ * enlarged), on top of `belowHeight` -- the shown heights (height × scale) of what is stacked under it -- along +Y for ON
+ * and IN, -Y for HANG. x and z are 0 and it is not turned: the slot's frame has the offset and the turn. `margin` is room
+ * left only for showing (0 ≤ margin < 1); whether it fits is judged elsewhere, at full size. Null when a size or value is
+ * unusable -- never NaN or Infinity.
+ *   slotFrame(slot) then seatInSlot(...) = seatTransform(...)
  */
-export declare function seatTransform(dims: ItemDims, slot: ResolvedSlot, mount: SlotMount, belowHeight?: number, margin?: number): SeatTransform | null;
-/** Where each of a slot's stacked items sits, bottom first. An item of unknown size is null and adds no height. */
-export declare function stackSeatTransforms(stack: (ItemDims | null | undefined)[], slot: ResolvedSlot, mount: SlotMount, margin?: number): (SeatTransform | null)[];
-/** A slot anchor's place in the holder: the slot's offset and the tier's elevation, nothing else. */
-export declare function slotAnchorPosition(slot: ResolvedSlot): {
-    x: number;
-    y: number;
-    z: number;
-};
+export declare function seatInSlot(dims: ItemDims, slot: ResolvedSlot, belowHeight?: number, margin?: number): SeatTransform | null;
+/** Where an item sits in its anchor's frame: the slot's frame, then the seat in it. */
+export declare function seatTransform(dims: ItemDims, slot: ResolvedSlot, belowHeight?: number, margin?: number): SeatTransform | null;
+/** Where each of a slot's stacked items sits in the anchor's frame, bottom first. An item of unknown size is null and adds no height. */
+export declare function stackSeatTransforms(stack: (ItemDims | null | undefined)[], slot: ResolvedSlot, margin?: number): (SeatTransform | null)[];
+export type SlotSpaceCode = 
+/** Two slots' rooms share space (params: tier, slot, otherTier, otherSlot). Touching is not overlapping. */
+'SLOT_OVERLAP'
+/** A slot's footprint reaches past the face its anchor gives (params: tier, slot). */
+ | 'SLOT_OUTSIDE_ANCHOR'
+/** The anchor gives no face size, so whether its slots stay on it is unknown (params: anchorId). */
+ | 'ANCHOR_SPACE_UNKNOWN';
+/** A warning about a layout's room: a setting to look at, never a judgement that items can physically be put there. */
+export interface SlotSpaceWarning {
+    code: SlotSpaceCode;
+    path: string;
+    params: Record<string, string | number>;
+}
+export interface SlotSpaceOptions {
+    /** The size of the face each anchor gives, centred on the anchor, in its X and Z. An anchor left out is UNKNOWN. */
+    anchorFaces?: Record<string, {
+        width: number;
+        depth: number;
+    }>;
+}
 /**
- * Where an item sits when it hangs off a slot anchor: only the stack height, half its height, scale and turn; x and z are
- * 0 because the anchor already has the offset and elevation.
- *   slotAnchorPosition(slot) + seatInAnchor(...).position = seatTransform(...).position
+ * Where a sound layout's slots crowd each other or leave their anchor's face, as warnings. Only slots on the same anchor
+ * are compared: anchors move apart. Rooms are each slot's allowed box, placed by its tier and turned; sharing a face or
+ * an edge is not overlapping.
  */
-export declare function seatInAnchor(dims: ItemDims, slot: ResolvedSlot, mount: SlotMount, belowHeight?: number, margin?: number): SeatTransform | null;
+export declare function slotSpaceWarnings(layout: SlotLayout, options?: SlotSpaceOptions): SlotSpaceWarning[];
 export type FitVerdict = 'OK' | 'NG' | 'UNKNOWN';
 export type FitReason = 'SLOT_NOT_FOUND' | 'TYPE_NOT_ACCEPTED' | 'WIDTH_EXCEEDED' | 'DEPTH_EXCEEDED' | 'HEIGHT_EXCEEDED' | 'STACK_LIMIT_EXCEEDED' | 'SPEC_UNKNOWN';
 export interface FitCandidate {

package/dist/slot-layout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"slot-layout.d.ts","sourceRoot":"","sources":["../src/slot-layout.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"slot-layout.d.ts","sourceRoot":"","sources":["../src/slot-layout.ts"],"names":[],"mappings":"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"}

package/dist/slot-layout.js

@@ -1,19 +1,28 @@
 /*
- * Slot layouts (ADR-0118): a holder's tiers, the slots on each tier, how slots are numbered, where an item sits in a
- * slot, and whether it fits. Pure computation; nothing here knows a scene, a graph or a component.
+ * Slot layouts (ADR-0118): a holder's anchors, the tiers placed on them, the slots of each tier, how slots are numbered,
+ * where an item sits in a slot, and whether it fits. Pure computation; nothing here knows a scene, a graph or a component.
  *
- * A holder has one or more tiers; each tier has its own arrangement (SINGLE, ROW, GRID or CUSTOM). A slot's address is
- * (tier, slot), both counted from 1, and slot numbers restart on every tier. ROW and GRID slots are not stored: they are
- * worked out from the rule, so thousands of slots are one rule. A slot's id is `t{tier}_s{slot}` -- a logical id, not
- * the name of a node in any 3D asset.
+ *   holder → anchor → tier → slot → item
  *
- * Coordinates are the holder's own: X and Z put a slot's centre relative to the tier's centre, Y is the tier floor's
- * height above the holder's floor. Lengths are in whatever unit the layout is written in; nothing here converts them.
- * Rotations are in degrees about Y.
+ * An anchor is a frame the holder gives: a position and a direction, and whatever moves it (a fork, a lift). The holder
+ * decides how many anchors there are; nothing here makes one. A tier is a group of slots placed on one anchor -- a shelf
+ * level, the load area of one fork. Several tiers may share an anchor, at the same height or not. A slot is one place an
+ * item is put; its address is (tier, slot). Tier numbers are the holder's own and slot numbers the tier's own: positive,
+ * unique, kept as they are when tiers or slots are removed or shown in another order -- never renumbered by height or
+ * position. ROW and GRID slots are not stored: they are worked out from the rule, so thousands of slots are one rule. A
+ * slot's id is `t{tier}_s{slot}` -- a logical id, not the name of a node in any 3D asset.
+ *
+ * Where an item is, each part said once:
+ *   item in the world = holder × anchor × tier × slot × seat
+ * The anchor's frame is the holder's to give. Here a tier is placed in its anchor's frame (position, turn about the
+ * anchor's Y), a slot in its tier's (offset in X and Z, turn about Y), and an item in its slot (stack height, scale).
+ * Lengths are in whatever unit the layout is written in; nothing here converts them. Rotations are in degrees about Y.
  */
 export function layoutIssue(code, path, params) {
     return params ? { code, path, params } : { code, path };
 }
+/** The anchor at the holder's own origin, for a holder that gives no other. */
+export const HOLDER_ANCHOR = 'holder';
 /* ── checking a layout ───────────────────────────────────────────────────── */
 const isFiniteNumber = (v) => typeof v === 'number' && Number.isFinite(v);
 const isPositive = (v) => isFiniteNumber(v) && v > 0;
@@ -37,24 +46,38 @@ function checkSpec(spec, path, issues) {
  * Everything wrong with a layout; an empty list is a sound one. stackLimit may be Infinity (no limit); a layout that is
  * to be stored as JSON is also checked with `persistenceIssues`.
  */
-export function validateSlotLayout(layout) {
+export function validateSlotLayout(layout, options = {}) {
     const issues = [];
     if (!layout || !Array.isArray(layout.tiers) || layout.tiers.length === 0)
         return [layoutIssue('TIERS_REQUIRED', 'tiers')];
-    if (!['ON', 'IN', 'HANG'].includes(layout.mount))
-        issues.push(layoutIssue('MOUNT_INVALID', 'mount'));
+    const anchors = options.anchors ? new Set(options.anchors) : null;
+    const tierNos = new Set();
     layout.tiers.forEach((tier, i) => {
         const path = `tiers[${i}]`;
         if (!tier || typeof tier !== 'object') {
             issues.push(layoutIssue('OBJECT_REQUIRED', path));
             return;
         }
-        if (tier.tierNo !== i + 1)
-            issues.push(layoutIssue('TIER_NUMBER_SEQUENCE', `${path}.tierNo`));
-        if (!isFiniteNumber(tier.elevation))
-            issues.push(layoutIssue('FINITE_NUMBER_REQUIRED', `${path}.elevation`));
-        else if (i > 0 && isFiniteNumber(layout.tiers[i - 1]?.elevation) && tier.elevation <= layout.tiers[i - 1].elevation)
-            issues.push(layoutIssue('ELEVATION_NOT_ASCENDING', `${path}.elevation`));
+        if (!isPositiveInt(tier.tierNo))
+            issues.push(layoutIssue('POSITIVE_INTEGER_REQUIRED', `${path}.tierNo`));
+        else if (tierNos.has(tier.tierNo))
+            issues.push(layoutIssue('TIER_NUMBER_DUPLICATE', `${path}.tierNo`, { tierNo: tier.tierNo }));
+        else
+            tierNos.add(tier.tierNo);
+        if (typeof tier.anchorId !== 'string' || !tier.anchorId.trim())
+            issues.push(layoutIssue('ANCHOR_REQUIRED', `${path}.anchorId`));
+        else if (anchors && !anchors.has(tier.anchorId))
+            issues.push(layoutIssue('ANCHOR_UNKNOWN', `${path}.anchorId`, { anchorId: tier.anchorId }));
+        if (!['ON', 'IN', 'HANG'].includes(tier.mount))
+            issues.push(layoutIssue('MOUNT_INVALID', `${path}.mount`));
+        if (!tier.position || typeof tier.position !== 'object')
+            issues.push(layoutIssue('OBJECT_REQUIRED', `${path}.position`));
+        else
+            for (const k of ['x', 'y', 'z'])
+                if (!isFiniteNumber(tier.position[k]))
+                    issues.push(layoutIssue('FINITE_NUMBER_REQUIRED', `${path}.position.${k}`));
+        if (!isFiniteNumber(tier.rotation))
+            issues.push(layoutIssue('FINITE_NUMBER_REQUIRED', `${path}.rotation`));
         const l = tier.layout;
         switch (l?.pattern) {
             case 'SINGLE':
@@ -81,14 +104,24 @@ export function validateSlotLayout(layout) {
                 checkSpec(l.slot, `${path}.layout.slot`, issues);
                 break;
             case 'CUSTOM': {
-                const slots = Array.isArray(l.slots) ? l.slots : [];
-                const nos = slots.map(s => s?.slotNo).sort((a, b) => a - b);
-                if (!nos.length || nos.some((n, k) => n !== k + 1))
-                    issues.push(layoutIssue('SLOT_NUMBER_SEQUENCE', `${path}.layout.slots`));
-                slots.forEach((s, k) => {
+                if (!Array.isArray(l.slots)) {
+                    issues.push(layoutIssue('ARRAY_REQUIRED', `${path}.layout.slots`));
+                    break;
+                }
+                if (!l.slots.length)
+                    issues.push(layoutIssue('SLOTS_REQUIRED', `${path}.layout.slots`));
+                const slotNos = new Set();
+                l.slots.forEach((s, k) => {
+                    const at = `${path}.layout.slots[${k}]`;
+                    if (!isPositiveInt(s?.slotNo))
+                        issues.push(layoutIssue('POSITIVE_INTEGER_REQUIRED', `${at}.slotNo`));
+                    else if (slotNos.has(s.slotNo))
+                        issues.push(layoutIssue('SLOT_NUMBER_DUPLICATE', `${at}.slotNo`, { slotNo: s.slotNo }));
+                    else
+                        slotNos.add(s.slotNo);
                     if (!isFiniteNumber(s?.offset?.x) || !isFiniteNumber(s?.offset?.z))
-                        issues.push(layoutIssue('FINITE_NUMBER_REQUIRED', `${path}.layout.slots[${k}].offset`));
-                    checkSpec(s, `${path}.layout.slots[${k}]`, issues);
+                        issues.push(layoutIssue('FINITE_NUMBER_REQUIRED', `${at}.offset`));
+                    checkSpec(s, at, issues);
                 });
                 break;
             }
@@ -126,6 +159,12 @@ export function slotCount(pattern) {
             return pattern.slots.length;
     }
 }
+/** A tier's slot numbers, in order. ROW and GRID count from 1; CUSTOM has the numbers it was given. */
+export function slotNumbers(pattern) {
+    if (pattern.pattern === 'CUSTOM')
+        return pattern.slots.map(s => s.slotNo).sort((a, b) => a - b);
+    return Array.from({ length: slotCount(pattern) }, (_, i) => i + 1);
+}
 /** A GRID slot's number from its row r and column c (from 1), counted from the origin corner. */
 export function gridSlotNo(rows, cols, r, c, order = 'ROW_MAJOR') {
     switch (order) {
@@ -169,7 +208,7 @@ const flip = (v, max) => (max && v !== 0 ? -v : v);
  */
 export function resolveSlot(layout, address, options = {}) {
     const tier = layout?.tiers?.find(t => t?.tierNo === address?.tier);
-    if (!tier || !isPositiveInt(address.slot) || address.slot > slotCount(tier.layout))
+    if (!tier || !isPositiveInt(address.slot))
         return null;
     const l = tier.layout;
     let spec;
@@ -177,16 +216,22 @@ export function resolveSlot(layout, address, options = {}) {
     let name;
     switch (l.pattern) {
         case 'SINGLE':
+            if (address.slot !== 1)
+                return null;
             spec = l.slot;
             offset = { x: 0, z: 0 };
             break;
         case 'ROW': {
+            if (address.slot > l.count)
+                return null;
             const v = flip((address.slot - 1 - (l.count - 1) / 2) * l.pitch, l.origin === 'MAX');
             spec = l.slot;
             offset = l.axis === 'X' ? { x: v, z: 0 } : { x: 0, z: v };
             break;
         }
         case 'GRID': {
+            if (address.slot > l.rows * l.cols)
+                return null;
             const { r, c } = gridCellOf(l.rows, l.cols, address.slot, l.order);
             const origin = l.origin ?? { x: 'MIN', z: 'MIN' };
             spec = l.slot;
@@ -210,7 +255,10 @@ export function resolveSlot(layout, address, options = {}) {
         tier: tier.tierNo,
         slotNo: address.slot,
         name,
-        elevation: tier.elevation,
+        anchorId: tier.anchorId,
+        mount: tier.mount,
+        tierPosition: { ...tier.position },
+        tierRotation: tier.rotation,
         offset,
         allowed: { ...spec.allowed },
         accepts: spec.accepts ? [...spec.accepts] : undefined,
@@ -228,12 +276,31 @@ export function addressOfSlotId(slotId) {
     const m = typeof slotId === 'string' ? /^t(\d+)_s(\d+)$/.exec(slotId) : null;
     return m ? { tier: Number(m[1]), slot: Number(m[2]) } : null;
 }
-/** Every address of a layout, tier by tier. For a big GRID, resolve only the addresses you need. */
+/** Every address of a layout, tier by tier as written. For a big GRID, resolve only the addresses you need. */
 export function* slotAddresses(layout) {
     for (const tier of layout?.tiers ?? [])
-        for (let slot = 1; slot <= slotCount(tier.layout); slot++)
+        for (const slot of slotNumbers(tier.layout))
             yield { tier: tier.tierNo, slot };
 }
+/** A point of the tier's X-Z plane turned by the tier's rotation about Y (right-handed: +X turns toward -Z). */
+function turnY(x, z, degrees) {
+    if (!degrees)
+        return { x, z };
+    const a = (degrees * Math.PI) / 180;
+    const c = Math.cos(a);
+    const s = Math.sin(a);
+    // clears the 6e-17 left at multiples of 90°
+    const clean = (v) => Math.round(v * 1e9) / 1e9;
+    return { x: clean(x * c + z * s), z: clean(-x * s + z * c) };
+}
+/** A slot's frame in its anchor's: the tier's placement, then the slot's offset and turn in the tier. */
+export function slotFrame(slot) {
+    const o = turnY(slot.offset.x, slot.offset.z, slot.tierRotation);
+    return {
+        position: { x: slot.tierPosition.x + o.x, y: slot.tierPosition.y, z: slot.tierPosition.z + o.z },
+        rotation: slot.tierRotation + slot.rotation
+    };
+}
 export const DEFAULT_SEAT_MARGIN = 0.05;
 const knownDims = (d) => !!d && isPositive(d.width) && isPositive(d.depth) && isPositive(d.height);
 /** The X and Z extent of an item turned by `rotation` degrees. */
@@ -246,12 +313,14 @@ export function rotatedFootprint(dims, rotation) {
     return { width: clean(dims.width * c + dims.depth * s), depth: clean(dims.width * s + dims.depth * c) };
 }
 /**
- * Where an item sits in a slot: shrunk to fit the slot's width and depth (by its turned extent, never enlarged), on top
- * of `belowHeight` -- the shown heights (height × scale) of what is stacked under it. `margin` is room left only for
- * showing (0 ≤ margin < 1); whether it fits is judged elsewhere, at full size. Null when a size or value is unusable --
- * never NaN or Infinity.
+ * Where an item sits in its slot's own frame: shrunk to fit the slot's width and depth (by its turned extent, never
+ * enlarged), on top of `belowHeight` -- the shown heights (height × scale) of what is stacked under it -- along +Y for ON
+ * and IN, -Y for HANG. x and z are 0 and it is not turned: the slot's frame has the offset and the turn. `margin` is room
+ * left only for showing (0 ≤ margin < 1); whether it fits is judged elsewhere, at full size. Null when a size or value is
+ * unusable -- never NaN or Infinity.
+ *   slotFrame(slot) then seatInSlot(...) = seatTransform(...)
  */
-export function seatTransform(dims, slot, mount, belowHeight = 0, margin = DEFAULT_SEAT_MARGIN) {
+export function seatInSlot(dims, slot, belowHeight = 0, margin = DEFAULT_SEAT_MARGIN) {
     if (!knownDims(dims))
         return null;
     if (!isFiniteNumber(belowHeight) || !isFiniteNumber(margin) || margin < 0 || margin >= 1)
@@ -259,34 +328,112 @@ export function seatTransform(dims, slot, mount, belowHeight = 0, margin = DEFAU
     const fp = rotatedFootprint(dims, slot.rotation);
     const scale = Math.min(1, Math.min(slot.allowed.width / fp.width, slot.allowed.depth / fp.depth) * (1 - margin));
     const h = dims.height * scale;
-    const dir = mount === 'HANG' ? -1 : 1;
-    const y = slot.elevation + dir * (belowHeight + h / 2);
-    return { position: { x: slot.offset.x, y, z: slot.offset.z }, rotation: slot.rotation, scale };
+    const dir = slot.mount === 'HANG' ? -1 : 1;
+    return { position: { x: 0, y: dir * (belowHeight + h / 2), z: 0 }, rotation: 0, scale };
+}
+/** Where an item sits in its anchor's frame: the slot's frame, then the seat in it. */
+export function seatTransform(dims, slot, belowHeight = 0, margin = DEFAULT_SEAT_MARGIN) {
+    const seat = seatInSlot(dims, slot, belowHeight, margin);
+    if (!seat)
+        return null;
+    const f = slotFrame(slot);
+    return { position: { x: f.position.x, y: f.position.y + seat.position.y, z: f.position.z }, rotation: f.rotation, scale: seat.scale };
 }
-/** Where each of a slot's stacked items sits, bottom first. An item of unknown size is null and adds no height. */
-export function stackSeatTransforms(stack, slot, mount, margin = DEFAULT_SEAT_MARGIN) {
+/** Where each of a slot's stacked items sits in the anchor's frame, bottom first. An item of unknown size is null and adds no height. */
+export function stackSeatTransforms(stack, slot, margin = DEFAULT_SEAT_MARGIN) {
     let below = 0;
     return stack.map(dims => {
-        const t = dims ? seatTransform(dims, slot, mount, below, margin) : null;
+        const t = dims ? seatTransform(dims, slot, below, margin) : null;
         if (t)
             below += dims.height * t.scale;
         return t;
     });
 }
-/** A slot anchor's place in the holder: the slot's offset and the tier's elevation, nothing else. */
-export function slotAnchorPosition(slot) {
-    return { x: slot.offset.x, y: slot.elevation, z: slot.offset.z };
+/** Below this, a shared length is a touch, not an overlap. */
+const TOUCH = 1e-6;
+function roomOf(slot, tierIndex) {
+    const f = slotFrame(slot);
+    const hw = slot.allowed.width / 2;
+    const hd = slot.allowed.depth / 2;
+    const corners = [
+        [-hw, -hd],
+        [hw, -hd],
+        [hw, hd],
+        [-hw, hd]
+    ].map(([x, z]) => {
+        const p = turnY(x, z, f.rotation);
+        return { x: f.position.x + p.x, z: f.position.z + p.z };
+    });
+    const ax = turnY(1, 0, f.rotation);
+    const az = turnY(0, 1, f.rotation);
+    const dir = slot.mount === 'HANG' ? -1 : 1;
+    const ys = [f.position.y, f.position.y + dir * slot.allowed.height];
+    const xs = corners.map(c => c.x);
+    return {
+        tierIndex,
+        tier: slot.tier,
+        slot: slot.slotNo,
+        corners,
+        axes: [ax, az],
+        y0: Math.min(...ys),
+        y1: Math.max(...ys),
+        minX: Math.min(...xs),
+        maxX: Math.max(...xs)
+    };
+}
+/** Whether two turned rectangles share area: no axis of either separates them by more than a touch. */
+function footprintsOverlap(a, b) {
+    for (const axis of [...a.axes, ...b.axes]) {
+        const pa = a.corners.map(c => c.x * axis.x + c.z * axis.z);
+        const pb = b.corners.map(c => c.x * axis.x + c.z * axis.z);
+        const shared = Math.min(Math.max(...pa), Math.max(...pb)) - Math.max(Math.min(...pa), Math.min(...pb));
+        if (shared <= TOUCH)
+            return false;
+    }
+    return true;
 }
 /**
- * Where an item sits when it hangs off a slot anchor: only the stack height, half its height, scale and turn; x and z are
- * 0 because the anchor already has the offset and elevation.
- *   slotAnchorPosition(slot) + seatInAnchor(...).position = seatTransform(...).position
+ * Where a sound layout's slots crowd each other or leave their anchor's face, as warnings. Only slots on the same anchor
+ * are compared: anchors move apart. Rooms are each slot's allowed box, placed by its tier and turned; sharing a face or
+ * an edge is not overlapping.
  */
-export function seatInAnchor(dims, slot, mount, belowHeight = 0, margin = DEFAULT_SEAT_MARGIN) {
-    const t = seatTransform(dims, slot, mount, belowHeight, margin);
-    if (!t)
-        return null;
-    return { position: { x: 0, y: t.position.y - slot.elevation, z: 0 }, rotation: t.rotation, scale: t.scale };
+export function slotSpaceWarnings(layout, options = {}) {
+    const warnings = [];
+    const byAnchor = new Map();
+    layout.tiers.forEach((tier, i) => {
+        const rooms = byAnchor.get(tier.anchorId) ?? [];
+        byAnchor.set(tier.anchorId, rooms);
+        for (const n of slotNumbers(tier.layout))
+            rooms.push(roomOf(resolveSlot(layout, { tier: tier.tierNo, slot: n }), i));
+    });
+    for (const [anchorId, rooms] of byAnchor) {
+        const face = options.anchorFaces?.[anchorId];
+        if (!face)
+            warnings.push({ code: 'ANCHOR_SPACE_UNKNOWN', path: 'tiers', params: { anchorId } });
+        else
+            for (const r of rooms)
+                if (r.corners.some(c => Math.abs(c.x) - face.width / 2 > TOUCH || Math.abs(c.z) - face.depth / 2 > TOUCH))
+                    warnings.push({ code: 'SLOT_OUTSIDE_ANCHOR', path: `tiers[${r.tierIndex}]`, params: { tier: r.tier, slot: r.slot } });
+        // sweep along X so a big grid is not compared pair by pair
+        const sorted = [...rooms].sort((a, b) => a.minX - b.minX);
+        for (let i = 0; i < sorted.length; i++) {
+            const a = sorted[i];
+            for (let j = i + 1; j < sorted.length && sorted[j].minX < a.maxX - TOUCH; j++) {
+                const b = sorted[j];
+                if (Math.min(a.y1, b.y1) - Math.max(a.y0, b.y0) <= TOUCH)
+                    continue;
+                if (!footprintsOverlap(a, b))
+                    continue;
+                const [first, second] = a.tierIndex < b.tierIndex || (a.tierIndex === b.tierIndex && a.slot < b.slot) ? [a, b] : [b, a];
+                warnings.push({
+                    code: 'SLOT_OVERLAP',
+                    path: `tiers[${second.tierIndex}]`,
+                    params: { tier: second.tier, slot: second.slot, otherTier: first.tier, otherSlot: first.slot }
+                });
+            }
+        }
+    }
+    return warnings;
 }
 /**
  * Whether one more item fits in a slot that already holds `occupants`, at full size. The count limit and the height