venuekit 0.0.0-stage → 0.10.0

package/dist/index.cjs

@@ -0,0 +1,180 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+var _chunk47ILVPKZcjs = require('./chunk-47ILVPKZ.cjs');
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+exports.CURRENT_VERSION = _chunk47ILVPKZcjs.CURRENT_VERSION; exports.CommandError = _chunk47ILVPKZcjs.CommandError; exports.DEFAULT_BLOCK = _chunk47ILVPKZcjs.DEFAULT_BLOCK; exports.DEFAULT_MAX_SELECTION = _chunk47ILVPKZcjs.DEFAULT_MAX_SELECTION; exports.DEFAULT_TABLE_PLACES = _chunk47ILVPKZcjs.DEFAULT_TABLE_PLACES; exports.DEFAULT_ZONE = _chunk47ILVPKZcjs.DEFAULT_ZONE; exports.HISTORY_LIMIT = _chunk47ILVPKZcjs.HISTORY_LIMIT; exports.History = _chunk47ILVPKZcjs.History; exports.ID_SEP = _chunk47ILVPKZcjs.ID_SEP; exports.LATIN_ALPHABET = _chunk47ILVPKZcjs.LATIN_ALPHABET; exports.LayoutError = _chunk47ILVPKZcjs.LayoutError; exports.MAX_ELEMENTS = _chunk47ILVPKZcjs.MAX_ELEMENTS; exports.MAX_ID_LENGTH = _chunk47ILVPKZcjs.MAX_ID_LENGTH; exports.MAX_LETTERS_START = _chunk47ILVPKZcjs.MAX_LETTERS_START; exports.MAX_NAME_LENGTH = _chunk47ILVPKZcjs.MAX_NAME_LENGTH; exports.MAX_REF_LENGTH = _chunk47ILVPKZcjs.MAX_REF_LENGTH; exports.MAX_SCALE = _chunk47ILVPKZcjs.MAX_SCALE; exports.MAX_SKIP = _chunk47ILVPKZcjs.MAX_SKIP; exports.MAX_SRC_LENGTH = _chunk47ILVPKZcjs.MAX_SRC_LENGTH; exports.MAX_TABLE_LABEL_LENGTH = _chunk47ILVPKZcjs.MAX_TABLE_LABEL_LENGTH; exports.MAX_UNITS = _chunk47ILVPKZcjs.MAX_UNITS; exports.MIN_SCALE = _chunk47ILVPKZcjs.MIN_SCALE; exports.PLACE_OFFSET = _chunk47ILVPKZcjs.PLACE_OFFSET; exports.SPANISH_ALPHABET = _chunk47ILVPKZcjs.SPANISH_ALPHABET; exports.SpatialIndex = _chunk47ILVPKZcjs.SpatialIndex; exports.TABLE_HEIGHT = _chunk47ILVPKZcjs.TABLE_HEIGHT; exports.TABLE_RADIUS = _chunk47ILVPKZcjs.TABLE_RADIUS; exports.TABLE_WIDTH = _chunk47ILVPKZcjs.TABLE_WIDTH; exports.VERSION = _chunk47ILVPKZcjs.VERSION; exports.applyCommand = _chunk47ILVPKZcjs.applyCommand; exports.applyTransform = _chunk47ILVPKZcjs.applyTransform; exports.assignPlaceType = _chunk47ILVPKZcjs.assignPlaceType; exports.backgroundSchema = _chunk47ILVPKZcjs.backgroundSchema; exports.bbox = _chunk47ILVPKZcjs.bbox; exports.blockShape = _chunk47ILVPKZcjs.blockShape; exports.canAssign = _chunk47ILVPKZcjs.canAssign; exports.capacityViolations = _chunk47ILVPKZcjs.capacityViolations; exports.createPiece = _chunk47ILVPKZcjs.createPiece; exports.distance = _chunk47ILVPKZcjs.distance; exports.duplicatePiece = _chunk47ILVPKZcjs.duplicatePiece; exports.elementSchema = _chunk47ILVPKZcjs.elementSchema; exports.expand = _chunk47ILVPKZcjs.expand; exports.expandLabels = _chunk47ILVPKZcjs.expandLabels; exports.expandSeatBlock = _chunk47ILVPKZcjs.expandSeatBlock; exports.expandTable = _chunk47ILVPKZcjs.expandTable; exports.findLockViolations = _chunk47ILVPKZcjs.findLockViolations; exports.idSchema = _chunk47ILVPKZcjs.idSchema; exports.labelRuleSchema = _chunk47ILVPKZcjs.labelRuleSchema; exports.labelSequence = _chunk47ILVPKZcjs.labelSequence; exports.landmarkById = _chunk47ILVPKZcjs.landmarkById; exports.landmarkSchema = _chunk47ILVPKZcjs.landmarkSchema; exports.landmarks = _chunk47ILVPKZcjs.landmarks; exports.layoutSchema = _chunk47ILVPKZcjs.layoutSchema; exports.letterIndex = _chunk47ILVPKZcjs.letterIndex; exports.letterLabel = _chunk47ILVPKZcjs.letterLabel; exports.metaSchema = _chunk47ILVPKZcjs.metaSchema; exports.migrate = _chunk47ILVPKZcjs.migrate; exports.newElementId = _chunk47ILVPKZcjs.newElementId; exports.nextBlockUnits = _chunk47ILVPKZcjs.nextBlockUnits; exports.parseUnitId = _chunk47ILVPKZcjs.parseUnitId; exports.placeTypeBounds = _chunk47ILVPKZcjs.placeTypeBounds; exports.placeTypeCapacity = _chunk47ILVPKZcjs.placeTypeCapacity; exports.placeTypeLinkSchema = _chunk47ILVPKZcjs.placeTypeLinkSchema; exports.placeUnitId = _chunk47ILVPKZcjs.placeUnitId; exports.pointInPolygon = _chunk47ILVPKZcjs.pointInPolygon; exports.pointInZone = _chunk47ILVPKZcjs.pointInZone; exports.rebindPlaceTypes = _chunk47ILVPKZcjs.rebindPlaceTypes; exports.rotatePiece = _chunk47ILVPKZcjs.rotatePiece; exports.rotationSchema = _chunk47ILVPKZcjs.rotationSchema; exports.scalePiece = _chunk47ILVPKZcjs.scalePiece; exports.seatBlockSchema = _chunk47ILVPKZcjs.seatBlockSchema; exports.seatUnitId = _chunk47ILVPKZcjs.seatUnitId; exports.snapScale = _chunk47ILVPKZcjs.snapScale; exports.spanishParseOptions = _chunk47ILVPKZcjs.spanishParseOptions; exports.summarize = _chunk47ILVPKZcjs.summarize; exports.tableSchema = _chunk47ILVPKZcjs.tableSchema; exports.tableSize = _chunk47ILVPKZcjs.tableSize; exports.toggleRemovedSeat = _chunk47ILVPKZcjs.toggleRemovedSeat; exports.toggleUnit = _chunk47ILVPKZcjs.toggleUnit; exports.transformSchema = _chunk47ILVPKZcjs.transformSchema; exports.unitStates = _chunk47ILVPKZcjs.unitStates; exports.zoneArc = _chunk47ILVPKZcjs.zoneArc; exports.zoneBounds = _chunk47ILVPKZcjs.zoneBounds; exports.zoneLabelSize = _chunk47ILVPKZcjs.zoneLabelSize; exports.zoneLocalSize = _chunk47ILVPKZcjs.zoneLocalSize; exports.zoneOutline = _chunk47ILVPKZcjs.zoneOutline; exports.zoneSchema = _chunk47ILVPKZcjs.zoneSchema; exports.zoneWithLocalSize = _chunk47ILVPKZcjs.zoneWithLocalSize;

package/dist/index.d.cts

@@ -0,0 +1,256 @@
+import { L as LabelRule, a as Layout, S as SellableUnit, B as Box, Z as Zone, P as Point, E as Element, b as Background } from './place-types-CeTjPHTF.cjs';
+export { C as CapacityViolation, D as DEFAULT_BLOCK, c as DEFAULT_TABLE_PLACES, d as DEFAULT_ZONE, e as Landmark, f as LockViolation, M as MAX_ELEMENTS, g as MAX_ID_LENGTH, h as MAX_LETTERS_START, i as MAX_NAME_LENGTH, j as MAX_REF_LENGTH, k as MAX_SCALE, l as MAX_SKIP, m as MAX_SRC_LENGTH, n as MAX_TABLE_LABEL_LENGTH, o as MAX_UNITS, p as MIN_SCALE, q as PLACE_OFFSET, r as PieceKind, s as PieceOptions, t as PlaceTypeAccepts, u as PlaceTypeLink, v as PlaceTypeOption, w as PlanSummary, R as Rotation, x as SeatBlock, T as TABLE_HEIGHT, y as TABLE_RADIUS, z as TABLE_WIDTH, A as Table, F as Transform, G as applyTransform, H as assignPlaceType, I as backgroundSchema, J as bbox, K as blockShape, N as canAssign, O as capacityViolations, Q as createPiece, U as distance, V as duplicatePiece, W as elementSchema, X as expand, Y as expandSeatBlock, _ as expandTable, $ as findLockViolations, a0 as idSchema, a1 as labelRuleSchema, a2 as landmarkSchema, a3 as layoutSchema, a4 as metaSchema, a5 as newElementId, a6 as nextBlockUnits, a7 as placeTypeCapacity, a8 as placeTypeLinkSchema, a9 as pointInPolygon, aa as rebindPlaceTypes, ab as rotatePiece, ac as rotationSchema, ad as scalePiece, ae as seatBlockSchema, af as snapScale, ag as spanishParseOptions, ah as summarize, ai as tableSchema, aj as tableSize, ak as toggleRemovedSeat, al as transformSchema, am as zoneSchema } from './place-types-CeTjPHTF.cjs';
+import 'zod';
+
+declare const LATIN_ALPHABET = "ABCDEFGHIJKLMNOPQRSTUVWXYZ";
+/** El alfabeto argentino: la Ñ va después de la N. */
+declare const SPANISH_ALPHABET = "ABCDEFGHIJKLMN\u00D1OPQRSTUVWXYZ";
+type LabelAlphabet = "latin" | "es";
+type LabelPattern = "sequential" | "odd" | "even" | "center";
+/** 0 → "A", 25 → "Z", 26 → "AA" (numeración bijectiva en base 26; 27 con la Ñ). */
+declare function letterLabel(index: number, alphabet?: LabelAlphabet): string;
+/** Inversa de letterLabel. "A" → 0, "AA" → 26. */
+declare function letterIndex(label: string, alphabet?: LabelAlphabet): number;
+/**
+ * Las `count` etiquetas en el orden en que se numeran (todavía sin acomodarlas en
+ * la fila): desde `start`, sin las de `skip`. Con `odd`/`even`, sólo impares o
+ * pares, desde el primero de esa clase que no sea menor que `start`.
+ */
+declare function labelSequence(rule: LabelRule, count: number): string[];
+/**
+ * Genera `count` etiquetas en el orden de la fila/columna (de izquierda a derecha).
+ * `skip` saca etiquetas de la secuencia (después de H viene J si skip incluye I).
+ * `pattern` (sólo números; ausente = `sequential`, como siempre): seguidas, sólo
+ * impares, sólo pares o desde el centro. `rtl` invierte el orden en que se asignan.
+ */
+declare function expandLabels(rule: LabelRule, count: number): string[];
+
+declare const ID_SEP = ":";
+declare function seatUnitId(blockId: string, rowLabel: string, seatLabel: string): string;
+declare function placeUnitId(tableId: string, n: number): string;
+declare function parseUnitId(id: string): string[];
+
+/**
+ * Caja que encierra las posiciones de las unidades de un tipo de lugar. Es lo
+ * que el selector usa para encuadrar la cámara sobre ese tipo.
+ *
+ * Devuelve `null` si no tiene ninguna — `bbox([])` devuelve una caja de
+ * ±Infinity, que como cámara es una pantalla en blanco sin explicación.
+ */
+declare function placeTypeBounds(_layout: Layout, units: SellableUnit[], ref: string): Box | null;
+
+/**
+ * Una zona curva es una banda de arco con la misma convención que un bloque curvo
+ * (`expand.ts`): el arco abre `curve` grados, el centro queda arriba y los extremos
+ * suben (la "sonrisa"). `width` se mide sobre el arco central y `height` es el grosor.
+ * El punto de la pieza (`transform`) es el medio del arco central.
+ */
+type ZoneArc = {
+    /** Mitad del ángulo, en radianes. */
+    half: number;
+    /** Radio del arco central. */
+    mid: number;
+    inner: number;
+    outer: number;
+};
+/** `null` si la zona es recta. */
+declare function zoneArc(zone: Zone): ZoneArc | null;
+/** Ancho y alto de la caja de la pieza sin girar. */
+declare function zoneLocalSize(zone: Zone): {
+    width: number;
+    height: number;
+};
+/** La caja que contiene la zona, en el mundo. */
+declare function zoneBounds(zone: Zone): Box;
+/** Si un punto del mundo cae adentro de la zona (de la banda, si es curva). */
+declare function pointInZone(zone: Zone, p: Point): boolean;
+/**
+ * El contorno de una zona curva en el mundo, con las cuatro esquinas suaves
+ * (`corner`, en unidades del plano). Vacío si la zona es recta: esa se dibuja como rect.
+ */
+declare function zoneOutline(zone: Zone, corner?: number): Point[];
+/**
+ * Cuánto lugar recto hay para un texto horizontal en el medio de la banda (sin girar).
+ * Recta, toda la zona; curva, lo que entra sobre la línea que pasa por su punto.
+ */
+declare function zoneLabelSize(zone: Zone): {
+    width: number;
+    height: number;
+};
+/**
+ * La zona con la caja (sin girar) de `width` × `height`, manteniendo su curva.
+ * Es la inversa de `zoneLocalSize`: con ella las manijas y «mismo ancho» trabajan
+ * sobre la caja que se ve, no sobre el arco. Lo que no se puede (más alto que
+ * una porción de torta) se acota.
+ */
+declare function zoneWithLocalSize(zone: Zone, width: number, height: number): Zone;
+
+type Item = {
+    id: string;
+    x: number;
+    y: number;
+};
+/** Quadtree de puntos con id. Inmutable después de construido. */
+declare class SpatialIndex {
+    private readonly root;
+    readonly size: number;
+    constructor(items: Item[], capacity?: number);
+    queryRect(box: Box): string[];
+    nearest(p: Point, maxDistance: number): string | null;
+}
+
+type Command = {
+    type: "addElement";
+    element: Element;
+} | {
+    type: "removeElement";
+    id: string;
+} | {
+    type: "updateElement";
+    id: string;
+    patch: Record<string, unknown>;
+} | {
+    type: "moveElement";
+    id: string;
+    dx: number;
+    dy: number;
+} | {
+    type: "replaceElement";
+    element: Element;
+} | {
+    type: "setBackground";
+    background: Background | null;
+}
+/** Varios comandos como un solo cambio: alinear o mover varias piezas es un paso de deshacer. */
+ | {
+    type: "batch";
+    commands: Command[];
+};
+declare class CommandError extends Error {
+    constructor(message: string);
+}
+/** Aplica un comando y valida el resultado. Pura: nunca muta `layout`. */
+declare function applyCommand(layout: Layout, cmd: Command): Layout;
+declare const HISTORY_LIMIT = 100;
+/** Historial por snapshots: el documento pesa KB (guarda bloques, no asientos). */
+declare class History {
+    private past;
+    private future;
+    /** La clave de agrupación del último `apply`. Ver `apply`. */
+    private lastKey;
+    present: Layout;
+    constructor(initial: Layout);
+    get canUndo(): boolean;
+    get canRedo(): boolean;
+    /**
+     * Aplica un comando y lo anota en la historia.
+     *
+     * `key` agrupa: escribir un nombre en un campo son quince comandos seguidos,
+     * no quince pasos. Con la misma clave que el anterior, el comando pisa al
+     * presente sin apilar otro paso — Deshacer vuelve al nombre de antes, no
+     * borra una letra. Sin clave, cada comando es su propio paso, que es lo que
+     * corresponde a dibujar, borrar o mover.
+     */
+    apply(cmd: Command, key?: string): Layout;
+    /**
+     * Reemplaza el documento entero, y se puede deshacer.
+     *
+     * Es cargar un plano: elegir de qué forma partir, o abrir uno guardado. No es
+     * un comando porque no describe una edición — no hay un "cambio" que aplicar
+     * sobre lo anterior, hay un documento nuevo.
+     *
+     * Va a la historia igual, y ahí está la gracia: alguien que dibujó media hora
+     * y elige otra forma por error tiene que poder volver con Deshacer.
+     */
+    load(next: Layout): Layout;
+    /** El documento al que llevaría `undo`, sin moverse. Para chequearlo antes (el candado). */
+    peekUndo(): Layout | null;
+    peekRedo(): Layout | null;
+    undo(): Layout;
+    redo(): Layout;
+    /**
+     * Pasa todos los documentos (pasado, presente y futuro) por `fn`, sin agregar
+     * un paso. Es para lo que cambia por fuera del plano, como una entrada que el
+     * host borró: deshacer no puede devolver una pieza a un tipo que ya no existe.
+     */
+    rewrite(fn: (layout: Layout) => Layout): Layout;
+}
+
+/**
+ * Estado de una unidad para el comprador (spec §7.2). `held` es el `locked`
+ * del spec: retenida por mí, con la cuenta regresiva a cargo del host. Se
+ * llama distinto porque `locked` ya significa "vendida, el editor no la
+ * puede tocar" en §6.4.
+ */
+type UnitState = "free" | "taken" | "selected" | "held";
+/** Cuántas unidades entran en una compra si el host no dice otra cosa. */
+declare const DEFAULT_MAX_SELECTION = 10;
+/**
+ * Estado de cada unidad. Lo mío gana sobre lo ocupado: si `taken`
+ * todavía lista como tomada una butaca que acabo de retener, para mí sigue
+ * siendo mía (el polling de §8.5 llega tarde, no manda).
+ */
+declare function unitStates(units: SellableUnit[], taken: ReadonlySet<string>, selection: readonly string[], held: ReadonlySet<string>): Map<string, UnitState>;
+type ToggleResult = {
+    selection: string[];
+    rejected?: "taken" | "max";
+};
+/**
+ * Toca una unidad. Sacar siempre se puede; agregar sólo si está libre y hay
+ * lugar. Nunca lanza: devuelve `rejected` para que la UI diga por qué.
+ */
+declare function toggleUnit(selection: readonly string[], unitId: string, states: ReadonlyMap<string, UnitState>, maxSelection: number): ToggleResult;
+
+declare const CURRENT_VERSION = 2;
+declare class LayoutError extends Error {
+    readonly issues: {
+        path: string;
+        message: string;
+    }[];
+    constructor(message: string, issues?: {
+        path: string;
+        message: string;
+    }[]);
+}
+/** Única puerta de entrada de documentos externos: migra a la versión actual y valida. */
+declare function migrate(input: unknown): Layout;
+
+/**
+ * Las cosas del lugar que NO se venden.
+ *
+ * Un baño, la barra, el escenario: están en el plano porque el que compra
+ * necesita ubicarse —"quiero estar cerca de la barra"— pero no tienen precio
+ * ni stock, y nadie compra un baño.
+ *
+ * Por eso **no están atados a un tipo de lugar**. Lo vendible (bloques y
+ * mesas) se enlaza a un tipo de lugar del host y sale en el listado de venta.
+ * Meter un baño ahí lo dejaría pidiendo un tipo que no existe y apareciendo
+ * entre las opciones de compra. Un landmark es un elemento aparte del plano
+ * (`type: "landmark"`) que sólo lleva `kind` (este catálogo), nombre y medidas.
+ *
+ * El catálogo vive en `core` —sin DOM, sin React— porque es dato, no interfaz:
+ * el editor lo muestra en una lista, pero un host que arme planos por API usa
+ * los mismos nombres y las mismas medidas.
+ */
+type LandmarkGroup = "access" | "bar" | "service" | "stage" | "space";
+interface LandmarkDef {
+    id: string;
+    /** Lo que se dibuja en el plano y se lee en la lista. */
+    name: string;
+    group: LandmarkGroup;
+    /** Medida sugerida, en unidades del plano. Un click suelto lo crea así. */
+    width: number;
+    height: number;
+}
+/**
+ * Medidas: el plano de las plantillas mide 1200×800 y una butaca ocupa 26.
+ * Un baño de 120×80 son ~4 butacas de ancho, que es como se ve en un plano de
+ * boliche de verdad. El escenario es la excepción a propósito — es lo primero
+ * que el ojo tiene que encontrar.
+ */
+declare const landmarks: readonly LandmarkDef[];
+declare function landmarkById(id: string): LandmarkDef | null;
+
+declare const VERSION = "0.10.0";
+
+export { Background, Box, CURRENT_VERSION, type Command, CommandError, DEFAULT_MAX_SELECTION, Element, HISTORY_LIMIT, History, ID_SEP, LATIN_ALPHABET, type LabelAlphabet, type LabelPattern, LabelRule, type LandmarkDef, type LandmarkGroup, Layout, LayoutError, Point, SPANISH_ALPHABET, SellableUnit, SpatialIndex, type ToggleResult, type UnitState, VERSION, Zone, type ZoneArc, applyCommand, expandLabels, labelSequence, landmarkById, landmarks, letterIndex, letterLabel, migrate, parseUnitId, placeTypeBounds, placeUnitId, pointInZone, seatUnitId, toggleUnit, unitStates, zoneArc, zoneBounds, zoneLabelSize, zoneLocalSize, zoneOutline, zoneWithLocalSize };

package/dist/index.d.ts

@@ -0,0 +1,256 @@
+import { L as LabelRule, a as Layout, S as SellableUnit, B as Box, Z as Zone, P as Point, E as Element, b as Background } from './place-types-CeTjPHTF.js';
+export { C as CapacityViolation, D as DEFAULT_BLOCK, c as DEFAULT_TABLE_PLACES, d as DEFAULT_ZONE, e as Landmark, f as LockViolation, M as MAX_ELEMENTS, g as MAX_ID_LENGTH, h as MAX_LETTERS_START, i as MAX_NAME_LENGTH, j as MAX_REF_LENGTH, k as MAX_SCALE, l as MAX_SKIP, m as MAX_SRC_LENGTH, n as MAX_TABLE_LABEL_LENGTH, o as MAX_UNITS, p as MIN_SCALE, q as PLACE_OFFSET, r as PieceKind, s as PieceOptions, t as PlaceTypeAccepts, u as PlaceTypeLink, v as PlaceTypeOption, w as PlanSummary, R as Rotation, x as SeatBlock, T as TABLE_HEIGHT, y as TABLE_RADIUS, z as TABLE_WIDTH, A as Table, F as Transform, G as applyTransform, H as assignPlaceType, I as backgroundSchema, J as bbox, K as blockShape, N as canAssign, O as capacityViolations, Q as createPiece, U as distance, V as duplicatePiece, W as elementSchema, X as expand, Y as expandSeatBlock, _ as expandTable, $ as findLockViolations, a0 as idSchema, a1 as labelRuleSchema, a2 as landmarkSchema, a3 as layoutSchema, a4 as metaSchema, a5 as newElementId, a6 as nextBlockUnits, a7 as placeTypeCapacity, a8 as placeTypeLinkSchema, a9 as pointInPolygon, aa as rebindPlaceTypes, ab as rotatePiece, ac as rotationSchema, ad as scalePiece, ae as seatBlockSchema, af as snapScale, ag as spanishParseOptions, ah as summarize, ai as tableSchema, aj as tableSize, ak as toggleRemovedSeat, al as transformSchema, am as zoneSchema } from './place-types-CeTjPHTF.js';
+import 'zod';
+
+declare const LATIN_ALPHABET = "ABCDEFGHIJKLMNOPQRSTUVWXYZ";
+/** El alfabeto argentino: la Ñ va después de la N. */
+declare const SPANISH_ALPHABET = "ABCDEFGHIJKLMN\u00D1OPQRSTUVWXYZ";
+type LabelAlphabet = "latin" | "es";
+type LabelPattern = "sequential" | "odd" | "even" | "center";
+/** 0 → "A", 25 → "Z", 26 → "AA" (numeración bijectiva en base 26; 27 con la Ñ). */
+declare function letterLabel(index: number, alphabet?: LabelAlphabet): string;
+/** Inversa de letterLabel. "A" → 0, "AA" → 26. */
+declare function letterIndex(label: string, alphabet?: LabelAlphabet): number;
+/**
+ * Las `count` etiquetas en el orden en que se numeran (todavía sin acomodarlas en
+ * la fila): desde `start`, sin las de `skip`. Con `odd`/`even`, sólo impares o
+ * pares, desde el primero de esa clase que no sea menor que `start`.
+ */
+declare function labelSequence(rule: LabelRule, count: number): string[];
+/**
+ * Genera `count` etiquetas en el orden de la fila/columna (de izquierda a derecha).
+ * `skip` saca etiquetas de la secuencia (después de H viene J si skip incluye I).
+ * `pattern` (sólo números; ausente = `sequential`, como siempre): seguidas, sólo
+ * impares, sólo pares o desde el centro. `rtl` invierte el orden en que se asignan.
+ */
+declare function expandLabels(rule: LabelRule, count: number): string[];
+
+declare const ID_SEP = ":";
+declare function seatUnitId(blockId: string, rowLabel: string, seatLabel: string): string;
+declare function placeUnitId(tableId: string, n: number): string;
+declare function parseUnitId(id: string): string[];
+
+/**
+ * Caja que encierra las posiciones de las unidades de un tipo de lugar. Es lo
+ * que el selector usa para encuadrar la cámara sobre ese tipo.
+ *
+ * Devuelve `null` si no tiene ninguna — `bbox([])` devuelve una caja de
+ * ±Infinity, que como cámara es una pantalla en blanco sin explicación.
+ */
+declare function placeTypeBounds(_layout: Layout, units: SellableUnit[], ref: string): Box | null;
+
+/**
+ * Una zona curva es una banda de arco con la misma convención que un bloque curvo
+ * (`expand.ts`): el arco abre `curve` grados, el centro queda arriba y los extremos
+ * suben (la "sonrisa"). `width` se mide sobre el arco central y `height` es el grosor.
+ * El punto de la pieza (`transform`) es el medio del arco central.
+ */
+type ZoneArc = {
+    /** Mitad del ángulo, en radianes. */
+    half: number;
+    /** Radio del arco central. */
+    mid: number;
+    inner: number;
+    outer: number;
+};
+/** `null` si la zona es recta. */
+declare function zoneArc(zone: Zone): ZoneArc | null;
+/** Ancho y alto de la caja de la pieza sin girar. */
+declare function zoneLocalSize(zone: Zone): {
+    width: number;
+    height: number;
+};
+/** La caja que contiene la zona, en el mundo. */
+declare function zoneBounds(zone: Zone): Box;
+/** Si un punto del mundo cae adentro de la zona (de la banda, si es curva). */
+declare function pointInZone(zone: Zone, p: Point): boolean;
+/**
+ * El contorno de una zona curva en el mundo, con las cuatro esquinas suaves
+ * (`corner`, en unidades del plano). Vacío si la zona es recta: esa se dibuja como rect.
+ */
+declare function zoneOutline(zone: Zone, corner?: number): Point[];
+/**
+ * Cuánto lugar recto hay para un texto horizontal en el medio de la banda (sin girar).
+ * Recta, toda la zona; curva, lo que entra sobre la línea que pasa por su punto.
+ */
+declare function zoneLabelSize(zone: Zone): {
+    width: number;
+    height: number;
+};
+/**
+ * La zona con la caja (sin girar) de `width` × `height`, manteniendo su curva.
+ * Es la inversa de `zoneLocalSize`: con ella las manijas y «mismo ancho» trabajan
+ * sobre la caja que se ve, no sobre el arco. Lo que no se puede (más alto que
+ * una porción de torta) se acota.
+ */
+declare function zoneWithLocalSize(zone: Zone, width: number, height: number): Zone;
+
+type Item = {
+    id: string;
+    x: number;
+    y: number;
+};
+/** Quadtree de puntos con id. Inmutable después de construido. */
+declare class SpatialIndex {
+    private readonly root;
+    readonly size: number;
+    constructor(items: Item[], capacity?: number);
+    queryRect(box: Box): string[];
+    nearest(p: Point, maxDistance: number): string | null;
+}
+
+type Command = {
+    type: "addElement";
+    element: Element;
+} | {
+    type: "removeElement";
+    id: string;
+} | {
+    type: "updateElement";
+    id: string;
+    patch: Record<string, unknown>;
+} | {
+    type: "moveElement";
+    id: string;
+    dx: number;
+    dy: number;
+} | {
+    type: "replaceElement";
+    element: Element;
+} | {
+    type: "setBackground";
+    background: Background | null;
+}
+/** Varios comandos como un solo cambio: alinear o mover varias piezas es un paso de deshacer. */
+ | {
+    type: "batch";
+    commands: Command[];
+};
+declare class CommandError extends Error {
+    constructor(message: string);
+}
+/** Aplica un comando y valida el resultado. Pura: nunca muta `layout`. */
+declare function applyCommand(layout: Layout, cmd: Command): Layout;
+declare const HISTORY_LIMIT = 100;
+/** Historial por snapshots: el documento pesa KB (guarda bloques, no asientos). */
+declare class History {
+    private past;
+    private future;
+    /** La clave de agrupación del último `apply`. Ver `apply`. */
+    private lastKey;
+    present: Layout;
+    constructor(initial: Layout);
+    get canUndo(): boolean;
+    get canRedo(): boolean;
+    /**
+     * Aplica un comando y lo anota en la historia.
+     *
+     * `key` agrupa: escribir un nombre en un campo son quince comandos seguidos,
+     * no quince pasos. Con la misma clave que el anterior, el comando pisa al
+     * presente sin apilar otro paso — Deshacer vuelve al nombre de antes, no
+     * borra una letra. Sin clave, cada comando es su propio paso, que es lo que
+     * corresponde a dibujar, borrar o mover.
+     */
+    apply(cmd: Command, key?: string): Layout;
+    /**
+     * Reemplaza el documento entero, y se puede deshacer.
+     *
+     * Es cargar un plano: elegir de qué forma partir, o abrir uno guardado. No es
+     * un comando porque no describe una edición — no hay un "cambio" que aplicar
+     * sobre lo anterior, hay un documento nuevo.
+     *
+     * Va a la historia igual, y ahí está la gracia: alguien que dibujó media hora
+     * y elige otra forma por error tiene que poder volver con Deshacer.
+     */
+    load(next: Layout): Layout;
+    /** El documento al que llevaría `undo`, sin moverse. Para chequearlo antes (el candado). */
+    peekUndo(): Layout | null;
+    peekRedo(): Layout | null;
+    undo(): Layout;
+    redo(): Layout;
+    /**
+     * Pasa todos los documentos (pasado, presente y futuro) por `fn`, sin agregar
+     * un paso. Es para lo que cambia por fuera del plano, como una entrada que el
+     * host borró: deshacer no puede devolver una pieza a un tipo que ya no existe.
+     */
+    rewrite(fn: (layout: Layout) => Layout): Layout;
+}
+
+/**
+ * Estado de una unidad para el comprador (spec §7.2). `held` es el `locked`
+ * del spec: retenida por mí, con la cuenta regresiva a cargo del host. Se
+ * llama distinto porque `locked` ya significa "vendida, el editor no la
+ * puede tocar" en §6.4.
+ */
+type UnitState = "free" | "taken" | "selected" | "held";
+/** Cuántas unidades entran en una compra si el host no dice otra cosa. */
+declare const DEFAULT_MAX_SELECTION = 10;
+/**
+ * Estado de cada unidad. Lo mío gana sobre lo ocupado: si `taken`
+ * todavía lista como tomada una butaca que acabo de retener, para mí sigue
+ * siendo mía (el polling de §8.5 llega tarde, no manda).
+ */
+declare function unitStates(units: SellableUnit[], taken: ReadonlySet<string>, selection: readonly string[], held: ReadonlySet<string>): Map<string, UnitState>;
+type ToggleResult = {
+    selection: string[];
+    rejected?: "taken" | "max";
+};
+/**
+ * Toca una unidad. Sacar siempre se puede; agregar sólo si está libre y hay
+ * lugar. Nunca lanza: devuelve `rejected` para que la UI diga por qué.
+ */
+declare function toggleUnit(selection: readonly string[], unitId: string, states: ReadonlyMap<string, UnitState>, maxSelection: number): ToggleResult;
+
+declare const CURRENT_VERSION = 2;
+declare class LayoutError extends Error {
+    readonly issues: {
+        path: string;
+        message: string;
+    }[];
+    constructor(message: string, issues?: {
+        path: string;
+        message: string;
+    }[]);
+}
+/** Única puerta de entrada de documentos externos: migra a la versión actual y valida. */
+declare function migrate(input: unknown): Layout;
+
+/**
+ * Las cosas del lugar que NO se venden.
+ *
+ * Un baño, la barra, el escenario: están en el plano porque el que compra
+ * necesita ubicarse —"quiero estar cerca de la barra"— pero no tienen precio
+ * ni stock, y nadie compra un baño.
+ *
+ * Por eso **no están atados a un tipo de lugar**. Lo vendible (bloques y
+ * mesas) se enlaza a un tipo de lugar del host y sale en el listado de venta.
+ * Meter un baño ahí lo dejaría pidiendo un tipo que no existe y apareciendo
+ * entre las opciones de compra. Un landmark es un elemento aparte del plano
+ * (`type: "landmark"`) que sólo lleva `kind` (este catálogo), nombre y medidas.
+ *
+ * El catálogo vive en `core` —sin DOM, sin React— porque es dato, no interfaz:
+ * el editor lo muestra en una lista, pero un host que arme planos por API usa
+ * los mismos nombres y las mismas medidas.
+ */
+type LandmarkGroup = "access" | "bar" | "service" | "stage" | "space";
+interface LandmarkDef {
+    id: string;
+    /** Lo que se dibuja en el plano y se lee en la lista. */
+    name: string;
+    group: LandmarkGroup;
+    /** Medida sugerida, en unidades del plano. Un click suelto lo crea así. */
+    width: number;
+    height: number;
+}
+/**
+ * Medidas: el plano de las plantillas mide 1200×800 y una butaca ocupa 26.
+ * Un baño de 120×80 son ~4 butacas de ancho, que es como se ve en un plano de
+ * boliche de verdad. El escenario es la excepción a propósito — es lo primero
+ * que el ojo tiene que encontrar.
+ */
+declare const landmarks: readonly LandmarkDef[];
+declare function landmarkById(id: string): LandmarkDef | null;
+
+declare const VERSION = "0.10.0";
+
+export { Background, Box, CURRENT_VERSION, type Command, CommandError, DEFAULT_MAX_SELECTION, Element, HISTORY_LIMIT, History, ID_SEP, LATIN_ALPHABET, type LabelAlphabet, type LabelPattern, LabelRule, type LandmarkDef, type LandmarkGroup, Layout, LayoutError, Point, SPANISH_ALPHABET, SellableUnit, SpatialIndex, type ToggleResult, type UnitState, VERSION, Zone, type ZoneArc, applyCommand, expandLabels, labelSequence, landmarkById, landmarks, letterIndex, letterLabel, migrate, parseUnitId, placeTypeBounds, placeUnitId, pointInZone, seatUnitId, toggleUnit, unitStates, zoneArc, zoneBounds, zoneLabelSize, zoneLocalSize, zoneOutline, zoneWithLocalSize };