@adatechnology/game-floorplan-interactables 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Anderson Fernandes
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/MIGRATION.md

@@ -0,0 +1,307 @@
+# Migration notes
+
+Port of `AdaptadorInterativos` v0.3.0, the IIFE of the team's pages (`area-casas.html`, `visor-casas-3d.html`, `zombiada-modo-livre.html`; the three copies are identical).
+The port is literal: the same planning, the same order of draws, the same fitting of the doors. What changed is the **names** (Portuguese to English), where the
+**tables** live (registries the game can override) and where the adapter **reads** the house (the plan of the kit, not the `PlantasSDK` result).
+
+The tests run the team's original code in a `vm` (`tests/fixtures/team-golden/adaptador-interativos.js`, verbatim, sha256
+`0cc377e6248bbbad3b49c82e7b8b864f3449442923a0c32a2d53f4129d72d7c4`) on the same houses and compare the answers, after renaming, with `toEqual`: the plan of 17
+typologies over 3 seeds and the states, the serialization of the world, the result of `add` (hinges turned, objects moved), `blockedOf` on a grid of points, the chimney and the contents drawn from the goods catalog.
+
+## Functions
+
+| Team | Here |
+|---|---|
+| `AdaptadorInterativos.criar(opcoes)` | `create(options)` (also `FloorplanInteractables.create`) |
+| `.planejar(res, opcoes)` | `plan(house, planOptions)` |
+| `.criarMundo(res, opcoes)` | `createWorld(house, worldOptions)` |
+| `.adicionar(mundo, plano, opcoes)` | `add(world, planned, addOptions)` |
+| `.bloqueadoDe(res, opcoes)` | `blockedOf(house, options)` |
+| `.pontoDe(mundo, id)` | `pointOf(world, id)` |
+| `.especProprio(tipo, ...)` | `ownSpec(type, ...)` |
+| `.versao` | `.version` (`'0.3.0'`) |
+
+## Options
+
+| Team | Here |
+|---|---|
+| `regiao` | `region` (default `'br'`) |
+| `locale` | `locale` (default `'pt-BR'`) |
+| `cadeiras` | `chairs` (also a plan option) |
+| `semente` | `seed` |
+| `andar` | `floor` |
+| `externos` | `externals` |
+| `noite` | `night` |
+| `luzesLigadas` | `lightsOn` |
+| `origemX`, `origemZ` | `originX`, `originZ` |
+| `base`, `inw` | `base`, `inw` |
+| `rede` | `grid` |
+| `agua` | `water` |
+| `bloqueado` | `isBlocked` |
+| `construir` | `build` |
+| `folga` | `margin` |
+
+New: `typeMap`, `contentMap`, `contentByGroup`, `contentFallback`, `groupOf`, `chairTables`, `chairSide`, `fixturesOfPoint`, `substitutes`, `preference`, `ownTypes`,
+`frozenItems`, `drawerItems`, `seedKey`, `messages`. Each table of the team became a registry with the team's values as default; a key with `null` removes the entry.
+
+## Answer of `plan` (`planejar`)
+
+| Team | Here |
+|---|---|
+| `versao`, `template`, `semente` | `version`, `template`, `seed` |
+| `andar` / `piso` (of an entry) | `floor` / `floorY` |
+| `itens` | `items` |
+| `tomadas`, `interruptores`, `luzes`, `lampioes` | `outlets`, `switches`, `lights`, `lanterns` |
+| `botijoes`, `fogoes`, `pontos` | `cylinders`, `stoves`, `points` |
+| `entradaEnergia`, `quadro`, `medidor`, `conduites` | `serviceEntrance`, `panel`, `meter`, `conduits` |
+| `mapeados`, `naoMapeados`, `descartados`, `avisos` | `mapped`, `unmapped`, `discarded`, `warnings` |
+| `cadeiras`, `origem` | `chairs`, `origin` |
+| entry `{ tipo, origem, ligacoes, ligada, ponto, afastado }` | `{ type, origin, connections, lit, point, moved }` |
+| connections `chuveiro, tomada, botijao, circuito, controla, topoChamine, vazao_lpm, circuitoTomada` | `shower, outlet, cylinder, circuit, controls, chimneyTop, flowLpm, outletCircuit` |
+| fixture `{ objeto, tipoPonto }` (`torneira`, `chuveiro`, `descarga`, `tanque`, `maquina`) | `{ object, pointKind }` (`tap`, `shower`, `flush`, `tub`, `machine`) |
+| botijao `{ fogao, local }` (`ao_lado`, `nicho_externo`, `sob_bancada`) | cylinder `{ stove, place }` (`beside`, `external_niche`, `under_counter`) |
+| `add` answer `{ adicionados, partes, dobradicas, afastados, avisos }` | `{ added, parts, hinges, moved, warnings }` |
+| stack data `{ nome_pt, origem, categoria, pegavel }` | `{ source, group, pickable }` (`nome_pt` is dropped: the item has its own name) |
+
+## Ids the adapter creates
+
+| Team | Here |
+|---|---|
+| `entrada_energia` | `service_entrance` |
+| `quadro`, `medidor` | `panel`, `meter` |
+| `gas_encanado` (type `gas_encanado`) | `piped_gas` (type `gas_piped`) |
+| `conduite_descida`, `circuito_avulso` | `conduit_descent`, `standalone_circuit` |
+| `<id>#aereo`, `<id>#armario`, `<id>#cadeiraN` | `<id>#overhead`, `<id>#cabinet`, `<id>#chairN` |
+
+Seeds: the objects the adapter creates are drawn from the seed of their id, so the renamed ids draw different numbers than the team's. A game that must reproduce a scene
+saved with the team's ids passes `seedKey` (the house renderer forwards its own `seedKey` option).
+
+## Furniture types (team `tipo` to the type of the plan)
+
+| Kit type (key of `typeMap`) | Team `tipo` |
+|---|---|
+| `table_lamp` | `abajur` |
+| `sideboard` | `aparador` |
+| `console_table` | `aparador_c` |
+| `kitchen_cabinet` | `armario_cozinha` |
+| `kitchen_cabinet_large` | `armario_cozinha_g` |
+| `kitchen_cabinet_small` | `armario_cozinha_p` |
+| `laundry_cabinet` | `armario_lav` |
+| `filing_cabinet` | `arquivo` |
+| `workbench` | `bancada_ferr` |
+| `bench` | `banco` |
+| `garden_bench` | `banco_jardim` |
+| `log_bench` | `banco_tronco` |
+| `stool` | `banqueta` |
+| `bunk_bed` | `beliche` |
+| `gas_cylinder` | `botijao` |
+| `camp_gas_canister` | `botijao_camping` |
+| `cooking_gas_cylinder` | `botijao_gas` |
+| `shower` | `box` |
+| `shower_large` | `box_g` |
+| `buffet` | `bufe` |
+| `rocking_chair` | `cadeira_balanco` |
+| `camp_chair` | `cadeira_camping` |
+| `mailbox` | `caixa_correio` |
+| `double_bed` | `cama_casal` |
+| `improvised_bed` | `cama_improvisada` |
+| `king_bed` | `cama_king` |
+| `queen_bed` | `cama_queen` |
+| `single_bed` | `cama_solteiro` |
+| `doghouse` | `casinha_cachorro` |
+| `bbq_grill` | `churrasqueira` |
+| `bbq_simple` | `churrasqueira_simples` |
+| `dresser` | `comoda` |
+| `cooler` | `cooler` |
+| `curtain` | `cortina` |
+| `nightstand` | `criado` |
+| `china_cabinet` | `cristaleira` |
+| `pantry` | `despensa` |
+| `desk` | `escrivaninha` |
+| `waiting_bench` | `espera` |
+| `tool_shelf` | `estante_ferr` |
+| `stove` | `fogao` |
+| `stove_4burner` | `fogao4` |
+| `wood_stove` | `fogao_lenha` |
+| `camp_stove` | `fogareiro` |
+| `campfire` | `fogueira` |
+| `freezer` | `freezer` |
+| `fridge` | `geladeira` |
+| `fridge_large` | `geladeira2` |
+| `display_fridge_medium` | `geladeira_med` |
+| `wardrobe` | `guarda` |
+| `closet_wardrobe` | `guarda_closet` |
+| `wardrobe_large` | `guarda_g` |
+| `wardrobe_small` | `guarda_peq` |
+| `oil_lamp` | `lampiao` |
+| `camp_lantern` | `lampiao_camping` |
+| `ceiling_oil_lamp` | `lampiao_teto` |
+| `fireplace` | `lareira` |
+| `trash_bin` | `lixeira` |
+| `outdoor_bin` | `lixeira_ext` |
+| `floor_lamp` | `luminaria` |
+| `chandelier` | `lustre` |
+| `washing_machine` | `maquina` |
+| `dining_table` | `mesa` |
+| `camp_table` | `mesa_camping` |
+| `office_desk` | `mesa_escr` |
+| `office_desk_large` | `mesa_escr_g` |
+| `outdoor_table` | `mesa_ext` |
+| `gourmet_table` | `mesa_gourmet` |
+| `gourmet_table_small` | `mesa_gourmet_peq` |
+| `dining_table_large` | `mesa_grande` |
+| `dining_table_small` | `mesa_peq` |
+| `dining_table_round` | `mesa_red` |
+| `microwave` | `microondas` |
+| `pendant` | `pendente` |
+| `blinds` | `persiana` |
+| `washbasin` | `pia_b` |
+| `pedestal_basin` | `pia_coluna` |
+| `rustic_sink` | `pia_rustica` |
+| `ceiling_light` | `plafon` |
+| `well` | `poco` |
+| `armchair` | `poltrona` |
+| `armchair_high` | `poltrona_alta` |
+| `plank_shelf` | `prateleira_tabua` |
+| `outhouse` | `privada` |
+| `tv_unit` | `rack` |
+| `tv_unit_large` | `rack_grande` |
+| `tv_unit_small` | `rack_peq` |
+| `display_fridge` | `refrig_exp` |
+| `sofa_2seat` | `sofa2` |
+| `sofa_3seat` | `sofa3` |
+| `sofa_l` | `sofa_l` |
+| `sofa_xl` | `sofa_xl` |
+| `track_spot` | `spot_trilho` |
+| `laundry_tub` | `tanque` |
+| `tv` | `tv` |
+| `tv_large` | `tv_grande` |
+| `clothesline` | `varal` |
+| `toilet` | `vaso` |
+
+## Content ids (team to household item)
+
+The team's table was keyed by the ids of `PlantasSDK`; the plan of the kit carries the ids of `game-items-goods` and of the structure pack, which the adapter resolves
+before using `contentMap` (31 ids of the structure table were matched by name; see the evidence of spec 001).
+
+| Kit id (key of `contentMap`) | Team id |
+|---|---|
+| `sugar` | `acucar` |
+| `water_jug_5l` | `agua_galao` |
+| `water_jug` | `agua_galao` |
+| `water_bottle` | `agua_garrafa` |
+| `bleach` | `agua_sanitaria` |
+| `alcohol_70` | `alcool` |
+| `rubbing_alcohol` | `alcool` |
+| `pliers` | `alicate` |
+| `fabric_softener` | `amaciante` |
+| `rice` | `arroz` |
+| `bucket` | `balde` |
+| `biscuits` | `biscoito` |
+| `cable_bundle` | `cabos` |
+| `cables` | `cabos` |
+| `coffee` | `cafe` |
+| `jeans` | `calca` |
+| `trousers` | `calca` |
+| `tshirt` | `camisa` |
+| `shirt` | `camisa` |
+| `t_shirt` | `camiseta` |
+| `mug` | `caneca` |
+| `pen` | `caneta` |
+| `frozen_meat` | `carne` |
+| `raw_beef` | `carne` |
+| `packed_meat` | `carne` |
+| `phone_charger` | `carregador` |
+| `charger` | `carregador` |
+| `letter` | `carta` |
+| `jacket` | `casaco` |
+| `coat` | `casaco` |
+| `clothespins` | `cesto_pregadores` |
+| `screwdriver` | `chave_fenda` |
+| `house_key` | `chaves` |
+| `keys` | `chaves` |
+| `flip_flops` | `chinelo` |
+| `blanket` | `cobertor` |
+| `bill` | `conta` |
+| `remote_control` | `controle_remoto` |
+| `cup` | `copo` |
+| `rope` | `corda` |
+| `adhesive_bandages` | `curativo` |
+| `bandages` | `curativo` |
+| `disinfectant` | `desinfetante` |
+| `detergent` | `detergente` |
+| `dish_soap` | `detergente` |
+| `documents` | `documento` |
+| `dvd` | `dvd` |
+| `dvds` | `dvd` |
+| `food_packaging` | `embalagem` |
+| `packaging` | `embalagem` |
+| `toothbrush` | `escova_dente` |
+| `sponge` | `esponja` |
+| `knife` | `faca` |
+| `kitchen_knife` | `faca` |
+| `flour` | `farinha` |
+| `beans` | `feijao` |
+| `electrical_tape` | `fita_isolante` |
+| `insulating_tape` | `fita_isolante` |
+| `apple` | `fruta` |
+| `fruit` | `fruta` |
+| `stapler` | `grampeador` |
+| `shoe_polish` | `graxa` |
+| `insulin` | `insulina` |
+| `yogurt` | `iogurte` |
+| `flashlight` | `lanterna` |
+| `canned_food` | `lata_atum` |
+| `canned_tuna` | `lata_atum` |
+| `canned_corn_and_peas` | `lata_milho` |
+| `canned_corn` | `lata_milho` |
+| `paint_can` | `lata_tinta` |
+| `empty_can` | `lata_vazia` |
+| `milk_carton` | `leite` |
+| `book` | `livro` |
+| `rubber_gloves` | `luvas` |
+| `pasta` | `macarrao` |
+| `hammer` | `martelo` |
+| `socks` | `meias` |
+| `backpack` | `mochila` |
+| `eyeglasses` | `oculos` |
+| `glasses` | `oculos` |
+| `cooking_oil` | `oleo` |
+| `eggs` | `ovos` |
+| `pot` | `panela` |
+| `flyer` | `panfleto` |
+| `crumpled_paper` | `papel_amassado` |
+| `toilet_paper` | `papel_higienico` |
+| `painkillers` | `paracetamol` |
+| `painkiller` | `paracetamol` |
+| `screws` | `parafusos` |
+| `batteries` | `pilhas` |
+| `plate` | `prato` |
+| `china_plates` | `prato` |
+| `plates` | `prato` |
+| `nails` | `pregos` |
+| `cheese` | `queijo` |
+| `soda_can` | `refrigerante` |
+| `soda` | `refrigerante` |
+| `maintenance_medication` | `remedio` |
+| `medicine` | `remedio` |
+| `underwear` | `roupa_intima` |
+| `laundry_powder` | `sabao_po` |
+| `washing_powder` | `sabao_po` |
+| `soap` | `sabonete` |
+| `trash_bag` | `saco_lixo` |
+| `full_trash_bag` | `saco_lixo_cheio` |
+| `shoes` | `sapato` |
+| `handsaw` | `serrote` |
+| `hand_saw` | `serrote` |
+| `shampoo` | `shampoo` |
+| `leftover_meal` | `sobras` |
+| `leftovers` | `sobras` |
+| `ice_cream` | `sorvete` |
+| `wine_glass` | `taca` |
+| `wine_glasses` | `taca` |
+| `seasoning` | `tempero` |
+| `spices` | `tempero` |
+| `sneakers` | `tenis` |
+| `scissors` | `tesoura` |
+| `broom` | `vassoura` |

package/README.md

@@ -1,3 +1,45 @@
-# Temporary Holding Version
+# @adatechnology/game-floorplan-interactables
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Adapter from the plan of `@adatechnology/game-floorplan` to the objects of the interactables kit (`game-interactables` + `game-interactables-household`). It turns
+each piece of furniture of a house into a household object with its doors, drawers, hinges, sockets, switches, lamps, appliances and containers, wires the
+house (service entrance, meter, panel, circuits, gas cylinders and pipes, water points), puts chairs around the tables, fills the containers with the finds of the plan and fits the
+hinged doors against the walls. Port of the team's `AdaptadorInterativos` v0.3.0 (the names are in `MIGRATION.md`).
+
+No three.js and no game names: the three.js side is `game-interactables-three`, and `game-floorplan-three` uses this package as the default of its `interactives` option.
+
+```ts
+import * as GameInteractables from '@adatechnology/game-interactables'
+import * as GameInteractablesHousehold from '@adatechnology/game-interactables-household'
+import { create } from '@adatechnology/game-floorplan-interactables'
+
+const adapter = create({ GameInteractables, GameInteractablesHousehold })   // locale 'pt-BR', region 'br': the team's defaults
+const planned = adapter.plan(house, { seed: house.seed, night: true })      // items, outlets, switches, lights, cylinders, fixtures, chairs, unmapped...
+const world = adapter.createWorld(house, { seed: house.seed })
+const out = adapter.add(world, planned, { isBlocked: adapter.blockedOf(house) }) // { added, parts, hinges, moved, warnings }
+```
+
+## Everything is a registry
+
+Each table of the team is a default the game can extend, replace or empty (a key with `null` removes the entry), without touching the adapter:
+
+| Option | Table |
+|---|---|
+| `typeMap` | furniture type of the plan to household type, variant, compound (sink, basin), dimensions, watts |
+| `contentMap`, `contentByGroup`, `contentFallback`, `groupOf` | item of the plan to household item |
+| `chairTables`, `chairSide`, `chairs` | tables that get chairs |
+| `fixturesOfPoint` | plumbing points to fixtures |
+| `substitutes`, `preference`, `ownTypes`, `frozenItems`, `drawerItems` | substitutes by type, who takes a stack first, types the adapter builds itself, frozen items, drawer items |
+| `locale`, `region`, `messages` | language of the household pack and of the warnings (`en`, `pt-BR`), texts |
+| `seedKey` | maps an id to the key of its seeded draws (reproduces another scene's seeds) |
+
+No `Math.random`: every draw is seeded.
+
+## Reading the plan
+
+The adapter reads the plan of the kit (English names, `contents` as stacks of the goods catalog, `utilities` from the structure pack). Without the structure pack there are no
+utilities and the house gets furniture only. Lights follow `electrical.mode` (grid, tap, off-grid) and the `night` / `lightsOn` options.
+
+## Tests
+
+`tests/team-golden.test.ts` runs the team's original code (`tests/fixtures/team-golden/adaptador-interativos.js`, verbatim) in a `vm` on the same houses and compares everything
+after renaming: the plan of 17 typologies over several seeds and the states fortified and abandoned, the serialization of the world, `add`, `blockedOf`, the chimney and the goods contents.

package/dist/index.d.ts

@@ -0,0 +1,167 @@
+declare const en: {
+    readonly 'error.missingKit': "game-floorplan-interactables: create needs GameInteractables and GameInteractablesHousehold";
+    readonly 'error.unknownOwnType': "game-floorplan-interactables: unknown own type: {type}";
+    readonly 'warn.cylinderNoCabinet': "cylinder {id} under the counter has no kitchen cabinet to hide it";
+    readonly 'warn.cabinetNoDoor': "cabinet {cabinet} has no door for the cylinder {id}";
+    readonly 'warn.switchUnknownLamp': "switch {id} controls {lamp}, which does not exist";
+    readonly 'warn.pointNoObject': "point {id} ({kind}) has no object for {item}";
+    readonly 'warn.buildEmpty': "build returned nothing for {id}";
+};
+type MessageKey = keyof typeof en;
+type Messages = Record<MessageKey, string>;
+declare const locales: Record<string, Messages>;
+/** Translator for a locale (`pt-BR`, `pt`, `en`, another falls back to `en`); `table` adds or replaces keys. */
+declare function createTranslator(locale?: string, table?: Partial<Messages>): (key: MessageKey, params?: Record<string, string | number>) => string;
+
+/** How a furniture type of the plan becomes an object of the household pack. */
+interface TypeMapEntry {
+    /** Household type (`hh.types`), or one the adapter creates itself (`lamp`). */
+    type?: string;
+    /** Household variant (`steel`, `garage`, `hanging`). */
+    variant?: string;
+    /** The furniture becomes more than one object: `sink` (basin + base cabinet + wall cabinet), `basin` (bathroom basin + wall cabinet), `rustic_sink`. */
+    compound?: 'sink' | 'basin' | 'rustic_sink';
+    /**
+     * Which sizes of the furniture go to the drawing: `wdh` (default), `wd` (width and depth: the plan gives the height of the base, not of the whole drawing, like the
+     * 10 cm shower tray or the 50 cm bench without a back), `wh`, `w`, `x` (none, but the height off the floor `y` stays) or `none` (none, not even `y`).
+     */
+    dim?: 'wdh' | 'wd' | 'wh' | 'w' | 'x' | 'none';
+    /** Power of a lamp (W). */
+    watts?: number;
+}
+/** Furniture type of the plan to the object of the kit (`TypeMapEntry`). */
+declare const TYPE_MAP: Readonly<Record<string, TypeMapEntry>>;
+/**
+ * Tables that get chairs of the kit (the plan puts none around them). `dining`: chairs on both long sides (and at the ends if the table is 1.6 m or more); `office`:
+ * one armchair on the front side of the desk. The adapter only puts a chair where it fits (walls and other furniture).
+ */
+declare const CHAIR_TABLES: Readonly<Record<string, 'dining' | 'office'>>;
+/** Side of the dining chair of the pack (m). */
+declare const DINING_CHAIR_SIDE = 0.45;
+/**
+ * What a content stack of the plan (`FindStack.itemId`) becomes in the household catalog (`hh.items`). The ids on the left are the ones the structure pack
+ * puts in `result.contents` by default and the ones of the goods catalog (`game-items-goods`, through its provenance); the right side is the team's choice.
+ * An id that is not here but is a household item stays as it is.
+ */
+declare const CONTENT_MAP: Readonly<Record<string, string>>;
+/** When the item is in no table: the closest household item by the group of the stack (`FindStack.group`). */
+declare const CONTENT_BY_GROUP: Readonly<Record<string, string>>;
+/** The item for a stack with no table entry, no household id and no known group. */
+declare const CONTENT_FALLBACK = "crumpled_paper";
+/** Items that go in the freezer first (the team asked for it by the name of the stack: ice cream and "frozen meat"). */
+declare const FROZEN_ITEMS: readonly string[];
+/** Items that go in the drawers of a wardrobe first (underwear and socks). */
+declare const DRAWER_ITEMS: readonly string[];
+/** Groups that go in the drawer of a kitchen base cabinet first. */
+declare const DRAWER_GROUPS: readonly string[];
+/** The last resort when nothing of the category fits the slots of the object (a mailbox holds only thin paper). */
+declare const OBJECT_SUBSTITUTES: Readonly<Record<string, readonly string[]>>;
+/** Point of the plumbing (`plumbing.points[].kind`) to the fixtures of the household object that use it. */
+declare const FIXTURES_OF_POINT: Readonly<Record<string, readonly string[]>>;
+/** Objects the kit does not have and the adapter creates itself (without going through `build`). */
+declare const OWN_TYPES: Readonly<Record<string, true>>;
+
+/** Loosely typed data: the plan of the engine (`result` of `generate`), the kit objects and the specs of the household pack. */
+type Json = any;
+type Registry<T> = Readonly<Record<string, T | null | undefined>>;
+interface AdapterOptions {
+    /** The `game-interactables` module (or its global): `createWorld`, `fitsSlot`, `hashString`. Required. */
+    GameInteractables?: Json;
+    /** The `game-interactables-household` module (or its global): `createHousehold`, `createRecorder`. Required. */
+    GameInteractablesHousehold?: Json;
+    /** Locale of the household pack and of the warnings (default `pt-BR`, the team's). */
+    locale?: string;
+    /** Region of the household pack (default `br`, the team's). */
+    region?: string;
+    /** `false`: no chairs around the tables (also a plan option). */
+    chairs?: boolean;
+    /** Side of the dining chair (m, default 0.45, the chair of the pack). */
+    chairSide?: number;
+    /** Maps the id of an object to the key of its seeded random (default: the id itself); the house renderer passes its `seedKey` to reproduce the team's seeds. */
+    seedKey?: (id: string) => string | null | undefined;
+    /** Texts of the warnings and errors, by key. */
+    messages?: Partial<Record<MessageKey, string>>;
+    /** Furniture type of the plan to object of the kit; `null` drops a default entry. */
+    typeMap?: Registry<TypeMapEntry>;
+    /** Id of a content stack to household item. */
+    contentMap?: Registry<string>;
+    /** Group of a content stack (`food`, `tool`...) to the household item used when no table entry exists. */
+    contentByGroup?: Registry<string>;
+    /** Item for a stack that is in no table, is no household item and has no known group (default `crumpled_paper`). */
+    contentFallback?: string;
+    /** Group of an item id, for stacks that carry none (the goods finds provider answers `{ itemId, count }` only). */
+    groupOf?: (itemId: string) => string | null | undefined;
+    /** Tables that get chairs: furniture type to `dining` or `office`. */
+    chairTables?: Registry<'dining' | 'office'>;
+    /** Kind of plumbing point to the fixtures of the household object. */
+    fixturesOfPoint?: Registry<readonly string[]>;
+    /** Substitute items by object type, the last resort when nothing of the category fits. */
+    substitutes?: Registry<readonly string[]>;
+    /** Order of the containers of an object for a stack, by household type. */
+    preference?: Registry<(stack: Json, context: {
+        frozen(stack: Json): boolean;
+        group(stack: Json): string | null;
+        drawerItem(stack: Json): boolean;
+    }) => string[]>;
+    /** Types the adapter builds itself (default `lamp`, `gas_piped`). */
+    ownTypes?: Registry<true>;
+    /** Items that go to the freezer first (default `ice_cream`, `frozen_meat`). */
+    frozenItems?: readonly string[];
+    /** Items that go to the wardrobe drawers first (default `underwear`, `socks`). */
+    drawerItems?: readonly string[];
+}
+interface FloorplanAdapter {
+    version: string;
+    /** The household pack the adapter was made with (`types`, `items`, `loot`, `strings`, `build`). */
+    household: Json;
+    /** Plans the objects of a plan; pure data, nothing is drawn. Options: `floor`, `externals`, `seed`, `night`, `lightsOn`, `chairs`, `originX`, `originZ`, `inw`, `base`. */
+    plan(result: Json, options?: Json): Json;
+    /** Creates the kit world with texts, items, loot and the water network. Options: `water` (`{ consume(point, liters) }`), `seed`, `grid`, `onEvent`, `canInteract`, `lightsOn`. */
+    createWorld(result: Json, options?: Json): Json;
+    /** Adds the planned objects to the world and fits the doors against the walls. Options: `build(type, item)`, `isBlocked(x, z, floor)`, `lightsOn`. */
+    add(world: Json, plan: Json, options?: Json): Json;
+    /** `(x, z, floor)` to true inside a wall of the plan. Options: `originX`, `originZ`, `inw`, `margin`. */
+    blockedOf(result: Json, options?: Json): (x: number, z: number, floor?: number | null) => boolean;
+    /** The plumbing point behind a global fixture id (`object:fixture`) of a world made by `createWorld`. */
+    pointOf(world: object, fixtureId: string): string | undefined;
+    /** The spec of an object the adapter builds itself (`lamp`, `gas_piped`). */
+    ownSpec(entry: Json): Json;
+    /** The registries in use (defaults with the overrides of the game). */
+    registries: Record<string, Json>;
+}
+
+/** Version of the team's adapter this is the port of. */
+declare const ADAPTER_VERSION = "0.3.0";
+/** Copy of a table with the overrides applied: a `null` or `undefined` value removes the entry. */
+declare function mergeRegistry<T>(base: Readonly<Record<string, T>>, extra?: Readonly<Record<string, T | null | undefined>> | null): Record<string, T>;
+/** The helpers the preference functions of a container get. */
+interface PreferenceContext {
+    /** The stack goes in the freezer first (ice cream, frozen meat). */
+    frozen(stack: Json): boolean;
+    /** Group of the stack (`food`, `tool`, ...), or null. */
+    group(stack: Json): string | null;
+    /** The stack is underwear or socks. */
+    drawerItem(stack: Json): boolean;
+}
+/** Order of the containers of an object for a stack (the first with a free slot that fits takes the stack). */
+type Preference = (stack: Json, context: PreferenceContext) => string[];
+/** Default preference by household type. */
+declare const PREFERENCE: Readonly<Record<string, Preference>>;
+declare function create(options?: AdapterOptions): FloorplanAdapter;
+
+/**
+ * The adapter as the house renderer takes it (`interactives.adapter`): `create(options)` makes the adapter; the tables are on it too.
+ * Same shape as the team's `AdaptadorInterativos` (`criar`, `MAPA_TIPOS`, `MAPA_CONTEUDO`, `CONTEUDO_POR_CATEGORIA`).
+ */
+declare const FloorplanInteractables: {
+    version: string;
+    create: typeof create;
+    TYPE_MAP: Readonly<Record<string, TypeMapEntry>>;
+    CONTENT_MAP: Readonly<Record<string, string>>;
+    CONTENT_BY_GROUP: Readonly<Record<string, string>>;
+    CHAIR_TABLES: Readonly<Record<string, "dining" | "office">>;
+    PREFERENCE: Readonly<Record<string, Preference>>;
+    mergeRegistry: typeof mergeRegistry;
+};
+
+export { ADAPTER_VERSION, type AdapterOptions, CHAIR_TABLES, CONTENT_BY_GROUP, CONTENT_FALLBACK, CONTENT_MAP, DINING_CHAIR_SIDE, DRAWER_GROUPS, DRAWER_ITEMS, FIXTURES_OF_POINT, FROZEN_ITEMS, type FloorplanAdapter, FloorplanInteractables, type Json, type MessageKey, type Messages, OBJECT_SUBSTITUTES, OWN_TYPES, PREFERENCE, type Preference, type PreferenceContext, type Registry, TYPE_MAP, type TypeMapEntry, create, createTranslator, locales, mergeRegistry };