@vargov/mcp 0.0.0-stage → 0.1.0

package/dist/bim.js

@@ -0,0 +1,165 @@
+// how_to_get_bim: the steps and the contents of the IFC4 / FBX files.
+// Wording follows the public sources of the brand, not this server's own ideas:
+//  - en/llms.txt and llms.txt of vargov-ai-kb (sections "For architects and specifiers", "New in October 2026");
+//  - knowledge/ifc4-in-the-model-essay.md (IfcDiscreteAccessory, IfcLightFixture/IfcFurnishingElement, GUIDs);
+//  - knowledge/whats-new-2026-10.md (FBX, production brief, 1:1 drawing);
+//  - docs/ssylka-i-tekst-dlya-tz.md of the configurator (link keys; the "Share" button).
+import { findEntry, hasMountScheme, kindNotes, mountSchemeNote } from './catalog.js';
+import { getData } from './data.js';
+function statusEn(code, kind, configurable, page) {
+    if (!configurable) {
+        return (`## ${code}: calculated individually\n\n` +
+            `The configurator does not calculate ${code}, so there is no IFC4 export, no FBX export, no PDF specification from the configurator and no 1:1 ceiling drawing for it, and the production brief cannot be started for it (360 of the 605 compositions open with a full calculation; this one is not among them). ` +
+            `Product page: ${page}. For a calculation contact the brand: info@vargov.ru, WhatsApp +7 916 537 33 52, Telegram @AntonVargov.\n`);
+    }
+    const lines = [`## ${code}: opens in the configurator with a full calculation (${kind})`, ''];
+    lines.push(`IFC4 (BIM) and FBX (3ds Max) are exported by the visitor; the PDF specification and the tender sheet come from the same "Documents" drawer.`);
+    lines.push(hasMountScheme(kind) ? `1:1 ceiling drawing: yes, from the production brief after the brief is started in production (see below).` : `1:1 ceiling drawing: no. ${mountSchemeNote(kind) ?? ''}`);
+    for (const n of kindNotes(code, kind))
+        lines.push(n);
+    lines.push('');
+    return lines.join('\n') + '\n';
+}
+function statusRu(code, kind, configurable, page) {
+    if (!configurable) {
+        return (`## ${code}: рассчитывается индивидуально\n\n` +
+            `Конфигуратор не рассчитывает ${code}: у этой композиции нет выгрузки IFC4 и FBX, нет PDF-спецификации из конфигуратора и нет монтажной схемы 1:1, ТЗ на производство для неё не заводится (с полным расчётом открываются 360 композиций из 605; этой среди них нет). ` +
+            `Карточка: ${page}. За расчётом — к бренду: info@vargov.ru, WhatsApp +7 916 537 33 52, Telegram @AntonVargov.\n`);
+    }
+    const kindRu = { cloud: 'облако элементов', ribbon: 'лента', chain: 'цепочка', frame: 'композиция на каркасе', 'ready-scene': 'готовая сцена' };
+    const lines = [`## ${code}: открывается в конфигураторе с полным расчётом (${kindRu[kind ?? 'cloud'] ?? kind})`, ''];
+    lines.push('IFC4 (BIM) и FBX (3ds Max) посетитель выгружает сам; PDF-спецификация и тендерный лист — в том же ящике «Документы».');
+    if (hasMountScheme(kind))
+        lines.push('Монтажная схема 1:1: есть — со страницы ТЗ, после запуска ТЗ в производство (ниже).');
+    else if (kind === 'ribbon')
+        lines.push('Монтажной схемы 1:1 нет: у ленты нет облака элементов, устройство своё.');
+    else if (kind === 'frame')
+        lines.push('Монтажной схемы 1:1 нет: у элементов своих нитей к потолку нет — они висят на каркасе, а сам каркас подвешен к потолку; в IFC4 записано число подвесов каркаса (свойство SuspensionCount), но не их координаты, а сами точки видны на чертеже каркаса и на виде сбоку в конфигураторе.');
+    else if (kind === 'ready-scene')
+        lines.push('Монтажной схемы 1:1 нет: это настенное бра — композиция готовая, а не рассчитанная, раскладки нет, значит, нет и разметки потолка; точек крепления к потолку в IFC4 нет.');
+    if (kind === 'ribbon')
+        lines.push('Лента: длина и ширина плана и высота композиции читаются из ссылки; пластика ленты (волна/спираль) выбирается в конфигураторе; кнопка выгрузки FBX у ленты — в панели ленты.');
+    if (kind === 'chain')
+        lines.push('Цепочка: форма на сборку не влияет — её раскладывает свой движок.');
+    if (kind === 'frame')
+        lines.push('Каркас: число элементов конфигуратор считает по шагу и длине каркаса, руками его не ввести.');
+    if (kind === 'ready-scene')
+        lines.push('Готовая сцена: открывается как собственная 3D-модель; размеры плана в ссылке заменяются размером изделия; поля «Высота потолка» нет: в IFC4 модель ставится под потолок 2700 мм (значение по умолчанию), и в самом файле эта высота свойством не объявлена.');
+    if (code === 'LC0106')
+        lines.push('LC0106: вместо размеров плана конфигуратор берёт число медуз и просвет между ними (ключи jelly и jgap); w/l/h в ссылке для этой композиции не действуют.');
+    lines.push('');
+    return lines.join('\n') + '\n';
+}
+const GUIDE_EN = `# How to get the IFC4 (BIM) and FBX files of a Vargov®Design composition
+
+**Scope.** The configurator (https://vargov.design, Russian copy https://configurator.vargov.ru) opens 360 of the 605 catalogue compositions with a full calculation: a 3D layout for the room, the ceiling fixing points, a PDF specification, a tender sheet, an IFC4 model for BIM and an FBX model for 3ds Max (verified 25 October 2026 against the configurator's open-skus.json and the catalogue dataset). The other compositions are calculated individually by the brand: they have no export and no 1:1 drawing. The site page of a composition that qualifies carries the line "IFC4 · PDF spec sheet · tender sheet — in the configurator".
+
+## Steps
+
+1. Open the configurator with the composition — a link from \`build_configurator_link\` already carries the plan dimensions, the ceiling height and the language (for example \`https://vargov.design/?sku=LC0599&w=1000&l=1000&ceil=3200&lang=en\`).
+2. Set the plan (Length × Width — the zone the composition is laid out in), the height of the cloud of elements, pick element sizes and colours, and choose the form of the composition at the step "Composition form". The configurator lays the elements out in 3D and counts the ceiling fixing points.
+3. Go to the step **"3D composition scheme"** and open the **"Documents"** drawer.
+4. Set the **ceiling height** in the field above the IFC button (default 2,700 mm — the room height, not a product size). It goes into the IFC4 file (the model is built under that ceiling, the fixing points sit on its plane, property CeilingHeight) and into AR; it does not change the layout, the mass or the specification. The ready scene LC0406-1 has no such field: its IFC4 model is placed under a 2,700 mm ceiling (the default), and the file does not declare that height as a property.
+5. Click **"Download IFC (BIM)"**. Right under it, click **"Download FBX (3ds Max)"**. A ribbon has its own export button, in the ribbon panel.
+6. The **"Share"** button copies a link that reopens the very same calculation (the address bar of the configurator does not reflect the state — use the copied link). The configurator's **"Fill in the spec"** button carries the composition into the online production brief (see below).
+
+## What is in the IFC4 file
+
+- Schema IFC4. Lit elements are exported as \`IfcLightFixture\`, unlit ones as \`IfcFurnishingElement\` — the test is applied to the element, not to the article. Known exception: in LC0523 the light comes from backlight contours, so its elements go out as \`IfcFurnishingElement\`.
+- Every point where the composition meets the ceiling is its own \`IfcDiscreteAccessory\` object in its own place, with the number of elements hanging from it and, where the mass is known, the estimated load on that point (a backlight-contour point carries a load of zero). Compositions on a frame hang from the frame, and the frame itself is suspended from the ceiling — the file records the number of frame suspensions (property SuspensionCount) but not their coordinates; the ready scene LC0406-1 is a wall sconce. Their files carry no ceiling fixing points (5 of the 360).
+- The BIM properties — loads, mass, power, article codes — are in the IFC4 file (the FBX has none).
+- What the IFC4 file does not contain: the cables and wires themselves (only the points where they reach the ceiling), the load-bearing frame, and the backlight contours.
+- GUIDs are derived from the configuration: the same configuration always gives the same GUIDs, different ones give different GUIDs, so two compositions of one article combine in one federated model without clashes.
+- The origin stays on the floor; the model is built for the stated ceiling height. On a non-Russian interface the names in the file are in English.
+- There is no Revit family (.rfa) — the brand does not issue one. DXF drawings exist for the brand's production and dealers only.
+
+## What is in the FBX file
+
+- The composition assembled, as separate objects, in millimetres; the suspension strands as solid bodies; the ceiling fixings as separate objects (one per ceiling hole: two strands meeting in one hole share one fixing; a strand that runs from the frame rather than from the ceiling carries none); the ceiling plane. Unlike IFC4, the FBX also carries the frame and the metal base.
+- The origin is the ceiling and the composition hangs down (IFC4 keeps the origin on the floor).
+- Colour and opacity carry over; there are no textures and no UVs; identical elements are copies of one geometry.
+- No BIM properties: loads, mass, power and article codes stay in the IFC4 file.
+- Plain import: the scale is declared inside the file, so a 1,500 mm composition opens as 1,500 mm whatever the system units are, and the importer itself turns it to the Z-up that 3ds Max expects.
+
+## 1:1 ceiling setting-out drawing (PDF)
+
+- Comes from the online production brief, https://vargov.ru/en/specifications (Russian and English only): no sign-in and no registration, only the "Object" field is required; a saved brief opens by its own link with a key. Available right after saving: the "3D configuration" page, the brief as a PDF in Russian and English, and the FBX export. The brief carries no price — it is a production brief, not a quote and not an order.
+- The 1:1 drawing **unlocks only after a manager starts the brief in production**; until then the button is inactive. It is preliminary: before the ceiling is set out it is confirmed by the production engineer, and that note is printed on the sheets.
+- Four sheets — plotter and A4, each for the ceiling and for the floor; print at exactly 100 % (a 100 mm segment on the sheet is there to check with a ruler); the plotter sheet runs in one piece up to 5 m and is split beyond that.
+- Exists for 345 of the 360 compositions: not for the 10 ribbons, not for the 4 compositions on a frame, not for the ready scene LC0406-1. Not issued to the client when the brief specifies mounting on the metal base: the base arrives with its holes and fixings already in place (with that mounting the brief offers one power option, 12 V through a driver).
+
+## Pages
+
+- IFC4 export: https://vargov.ru/en/configurator/ifc4 · FBX export: https://vargov.ru/en/configurator/fbx
+- How many ceiling mounting points a fitting needs: https://vargov.ru/en/guides/mounting-points
+- Essay "The light fitting that never arrives in the model": https://raw.githubusercontent.com/vargov3-spec/vargov-ai-kb/main/knowledge/ifc4-in-the-model-essay.md
+- Installation and wiring guides (PDF, eight languages): https://vargov.ru/en/installation
+`;
+const GUIDE_RU = `# Как получить IFC4 (BIM) и FBX композиции Vargov®Design
+
+**Круг.** Конфигуратор (https://configurator.vargov.ru, международная площадка https://vargov.design) открывает с полным расчётом 360 композиций каталога из 605: 3D-раскладка под помещение, точки крепления к потолку, PDF-спецификация, тендерный лист, модель IFC4 для BIM и модель FBX для 3ds Max (проверено 25.10.2026 прогоном open-skus.json конфигуратора и датасета каталога). Остальные композиции бренд рассчитывает индивидуально: выгрузки и схемы 1:1 у них нет. На карточке композиции, которая открывается с расчётом, стоит строка «IFC4 · PDF-спецификация · тендерный лист — в конфигураторе».
+
+## Шаги
+
+1. Откройте конфигуратор с композицией — ссылка из \`build_configurator_link\` уже несёт размеры плана, высоту потолка и язык (например \`https://configurator.vargov.ru/?sku=LC0599&w=1000&l=1000&ceil=3200&lang=ru\`).
+2. Задайте план (Длина × Ширина — зона, в которой раскладывается композиция), высоту облака элементов, размеры и цвета элементов и выберите форму на шаге «Форма композиции». Конфигуратор раскладывает элементы в 3D и считает точки крепления к потолку.
+3. Перейдите на шаг **«3D схема композиции»** и откройте ящик **«Документы»**.
+4. Укажите **высоту потолка** в поле над кнопкой IFC (по умолчанию 2700 мм — высота помещения, не размер изделия). Она уходит в IFC4 (сборка под потолок, точки крепления на его плоскости, свойство CeilingHeight) и в AR; на раскладку, массу и спецификацию не влияет. У готовой сцены LC0406-1 этого поля нет: в IFC4 она ставится под потолок 2700 мм (значение по умолчанию), и в самом файле эта высота свойством не объявлена.
+5. Нажмите **«Скачать IFC (BIM)»**. Сразу под ней — **«Скачать FBX (3ds Max)»**. У ленты своя кнопка выгрузки — в панели ленты.
+6. Кнопка **«Поделиться»** копирует ссылку, которая открывает тот же расчёт (адресная строка конфигуратора состояние не отражает — берите скопированную ссылку). Кнопка **«Заполнить ТЗ»** переносит композицию в онлайн-ТЗ на производство (ниже).
+
+## Что лежит в файле IFC4
+
+- Схема IFC4. Светящиеся элементы выгружаются классом \`IfcLightFixture\`, несветящиеся — \`IfcFurnishingElement\`; признак берётся по элементу, а не по артикулу. Известное исключение: у LC0523 свет дают контуры подсветки, поэтому её элементы уходят классом \`IfcFurnishingElement\`.
+- Каждая точка, где композиция встречается с потолком, — свой объект \`IfcDiscreteAccessory\` на своём месте; на нём записано число элементов, которые на нём висят, и, когда масса известна, расчётная нагрузка на эту точку (у точки контура подсветки нагрузка нулевая). Композиции на каркасе висят на каркасе, а сам каркас подвешен к потолку — в файл уходит число подвесов каркаса (свойство SuspensionCount), но не их координаты; готовая сцена LC0406-1 — настенное бра. Точек крепления к потолку в их файлах нет (5 артикулов из 360).
+- Свойства BIM — нагрузки, масса, мощность, коды артикулов — лежат в IFC4 (в FBX их нет).
+- Чего в IFC4 нет: самих тросов и проводов (только точки, где они приходят в потолок), несущего каркаса и контуров подсветки.
+- GUID строятся от конфигурации: одна и та же конфигурация даёт те же GUID, разные — разные, поэтому две композиции одного артикула сводятся в одну BIM-модель без совпадений.
+- Начало координат — на полу; файл строится под заданную высоту потолка. На нерусском интерфейсе имена в файле английские.
+- Библиотечного семейства Revit (.rfa) у бренда нет. Чертежи DXF — только для производства и дилеров бренда.
+
+## Что лежит в файле FBX
+
+- Композиция в сборе отдельными объектами, в миллиметрах; нити подвеса — телами; потолочные крепления — отдельными объектами (одно крепление на каждое отверстие в потолке: две нити, сошедшиеся в одно отверстие, несут один узел; нить от каркаса крепления не несёт); плоскость потолка. В отличие от IFC4, в FBX есть каркас и металлическая база.
+- Начало координат — потолок, композиция висит вниз (у IFC4 начало на полу).
+- Цвет и прозрачность переносятся; текстур и UV нет; одинаковые элементы — копии одной геометрии.
+- Свойств BIM нет: нагрузки, масса, мощность и коды артикулов остаются в IFC4.
+- Вставляется обычным импортом: масштаб объявлен внутри файла, композиция 1500 мм открывается как 1500 мм при любых системных единицах, разворот в Z-вверх делает сам импортёр.
+
+## Монтажная схема разметки потолка 1:1 (PDF)
+
+- Выдаётся страницей онлайн-ТЗ https://vargov.ru/specifications (только русский и английский): вход и регистрация не нужны, обязательно только поле «Объект»; сохранённое ТЗ открывается по своей ссылке с ключом. Сразу после сохранения доступны страница «3D-конфигурация», PDF ТЗ на русском и английском и выгрузка FBX. Цены в ТЗ нет — это техническое задание на производство, не заявка и не заказ.
+- Схема 1:1 **открывается только после того, как менеджер запустит ТЗ в производство**; до этого кнопка неактивна. Схема предварительная: перед разметкой потолка её подтверждает технолог производства, и эта пометка напечатана на самих листах.
+- Четыре листа — для плоттера и A4, каждый на потолок и на пол; печать строго 100 % (на листе отрезок 100 мм для проверки линейкой); лист плоттера идёт одним куском до 5 м, дальше режется.
+- Есть у 345 из 360 композиций: нет у 10 лент, у 4 композиций на каркасе и у готовой сцены LC0406-1. Заказчику не выдаётся, если в ТЗ выбран монтаж на металлическую базу: база приходит с готовыми отверстиями и монтажными элементами (при таком монтаже подключение в ТЗ одно — 12 В через драйвер).
+
+## Страницы
+
+- Выгрузка IFC4: https://vargov.ru/configurator/ifc4 · выгрузка FBX: https://vargov.ru/configurator/fbx
+- Сколько точек крепления нужно светильнику: https://vargov.ru/guides/tochki-krepleniya
+- Эссе «Светильник, который не доезжает до модели»: https://raw.githubusercontent.com/vargov3-spec/vargov-ai-kb/main/knowledge/ifc4-in-the-model-essay.md
+- Монтаж и подключение (PDF на восьми языках): https://vargov.ru/installation
+`;
+export function bimGuide(codeInput, lang = 'en') {
+    const ru = lang === 'ru';
+    let head = '';
+    if (codeInput && codeInput.trim()) {
+        const e = findEntry(codeInput);
+        if (!e) {
+            head = ru
+                ? `## Код «${codeInput}» в каталоге не найден (LC0001…LC0602, у части артикулов суффикс -1/-2). Найдите код через search_compositions.\n\n`
+                : `## Code "${codeInput}" is not in the catalogue (LC0001…LC0602, some with a -1/-2 suffix). Find the code with search_compositions.\n\n`;
+        }
+        else {
+            const page = e.p.urls?.[ru ? 'ru' : 'en'] ?? '';
+            head = (ru ? statusRu : statusEn)(e.code, e.kind, e.configurable, page) + '\n';
+        }
+    }
+    return head + (ru ? GUIDE_RU : GUIDE_EN);
+}
+export function bimCounts() {
+    const d = getData();
+    const open = d.openSet.size;
+    const withScheme = [...d.openSet].filter((c) => hasMountScheme(d.byCode.get(c)?.kind ?? (d.ribbons.has(c) ? 'ribbon' : d.chains.has(c) ? 'chain' : d.frames.has(c) ? 'frame' : d.readyScenes.has(c) ? 'ready-scene' : 'cloud'))).length;
+    return { open, withScheme, ribbons: d.ribbons.size, frames: d.frames.size, readyScenes: d.readyScenes.size, chains: d.chains.size };
+}

package/dist/brand.js

@@ -0,0 +1,133 @@
+// brand_facts: a compact card of the brand. Numbers are computed from the bundled data
+// (products.json, open-skus.json, organization.jsonld) so that they can be checked, not typed in.
+import { bimCounts } from './bim.js';
+import { CONFIGURATOR_INTL, CONFIGURATOR_RU, SITE } from './catalog.js';
+import { FAMILIES, getData } from './data.js';
+const FAMILY_PAGES = {
+    lighting: 'lighting',
+    decorative: 'decorative',
+    'sculptural-decor': 'sculptural-decor',
+    'floor-table-lamps': 'floor-table-lamps',
+};
+export function brandFacts(lang = 'en') {
+    const d = getData();
+    const org = d.organization;
+    const person = d.person;
+    const store = d.store;
+    const counts = bimCounts();
+    const ru = lang === 'ru';
+    const families = Object.fromEntries(FAMILIES.map((f) => {
+        const items = d.products.filter((p) => p.category === f);
+        const label = items[0]?.category_label ?? { ru: f, en: f };
+        return [f, { count: items.length, label_ru: label.ru, label_en: label.en, page_ru: `${SITE}/${FAMILY_PAGES[f]}`, page_en: `${SITE}/en/${FAMILY_PAGES[f]}` }];
+    }));
+    const codes = d.products.map((p) => p.code).sort();
+    const awards = org?.award ?? [];
+    const awardsCount = awards.length;
+    // If the knowledge base ships references/brand-facts.json, pass it through under its own key — minus the
+    // `forbidden` wordings: they exist for the knowledge base's own checker, and an assistant reading them
+    // here could repeat the very phrases they forbid.
+    const extra = d.brandFacts ? { brand_facts_file: withoutKey(d.brandFacts, 'forbidden') } : {};
+    return {
+        name: org?.name ?? 'Vargov®Design',
+        alternate_names: org?.alternateName ?? ['Vargov Design', 'VARGOV'],
+        description: org?.description,
+        founded: org?.foundingDate,
+        founder: person ? { name: person.name, name_ru: person.alternateName, title: person.jobTitle, page: person.url, links: person.sameAs } : undefined,
+        made_to_order: ru
+            ? 'Каждая композиция собирается под конкретный интерьер: масштаб и геометрия подстраиваются под пространство. Цены, материалы и размеры композиций не публикуются; стоимость — по заявке.'
+            : 'Every composition is assembled for a specific interior; its scale and geometry are adjusted to the space. Prices, materials and composition dimensions are not published; a quote comes per request.',
+        catalogue: {
+            compositions: d.products.length,
+            code_range: `${codes[0]}…${codes[codes.length - 1]}`,
+            families,
+            page_ru: `${SITE}/catalog`,
+            page_en: `${SITE}/en/catalog`,
+            product_page_pattern: `${SITE}/en/catalog/<code in lower case>  (Russian: ${SITE}/catalog/<code>)`,
+        },
+        configurator: {
+            url_international: CONFIGURATOR_INTL,
+            url_russian: CONFIGURATOR_RU,
+            compositions_with_full_calculation: counts.open,
+            compositions_with_1to1_ceiling_drawing: counts.withScheme,
+            without_1to1_drawing: { ribbons: counts.ribbons, on_frame: counts.frames, ready_scenes: counts.readyScenes },
+            exports_by_the_visitor: ['IFC4 model (BIM)', 'FBX model (3ds Max)', 'PDF specification', 'tender sheet'],
+            production_brief: ru ? `${SITE}/specifications` : `${SITE}/en/specifications`,
+            llms: 'https://vargov.design/llms.txt',
+            ifc4_page: ru ? `${SITE}/configurator/ifc4` : `${SITE}/en/configurator/ifc4`,
+            fbx_page: ru ? `${SITE}/configurator/fbx` : `${SITE}/en/configurator/fbx`,
+        },
+        awards: {
+            count: awardsCount,
+            wording_en: `${awardsCount} awards from international juries`,
+            wording_ru: `${awardsCount} достижений на международных премиях`,
+            note: ru
+                ? 'Среди них — номинация Awwwards 2026 за 3D-конфигуратор (номинация, не победа) и членство Антона Варгова в High Jury премии ADD Awards 2024.'
+                : 'Among them: an Awwwards 2026 nomination for the 3D configurator (a nomination, not a win) and Anton Vargov\'s High Jury membership at ADD Awards 2024.',
+            page: ru ? `${SITE}/awards` : `${SITE}/en/awards`,
+            verified_list: 'https://raw.githubusercontent.com/vargov3-spec/vargov-ai-kb/main/knowledge/awards-verified.md',
+            list: awards,
+        },
+        certification: {
+            summary: ru
+                ? 'Два серийных сертификата ТР ЕАЭС (ТР ТС 004/2011, 020/2011) и две декларации ТР ЕАЭС 037/2016 на 310 артикулов LC, знак EAC, действуют до 2031 года; сертификат серийный — покрывает каждое изделие артикула, а не партию.'
+                : 'Two EAEU serial certificates (TR CU 004/2011, 020/2011) and two TR EAEU 037/2016 declarations covering 310 LC articles, EAC mark, valid until 2031; serial scope means every unit of a listed article is covered, not a single batch.',
+            page: ru ? `${SITE}/certification` : `${SITE}/en/certification`,
+            certified_in_dataset: d.products.filter((p) => p.cert).length,
+        },
+        trademarks: org?.identifier?.map((i) => ({ registry: i.propertyID, number: i.value, url: i.url })),
+        showroom: store
+            ? {
+                name: store.name,
+                address: store.address ? `${store.address.streetAddress}, ${store.address.addressLocality}, ${store.address.postalCode ?? ''} ${store.address.addressCountry}`.trim() : undefined,
+                address_en: '24 Nakhimovsky Prospekt, bldg. 1, Pavilion 2, Stand 212, Moscow',
+                hours: store.openingHoursSpecification?.map((h) => `${h.dayOfWeek.length === 7 ? 'daily' : h.dayOfWeek.join(', ')} ${h.opens}–${h.closes}`),
+                telephone: store.telephone,
+                page: ru ? `${SITE}/showroom` : `${SITE}/en/showroom`,
+                maps: store.hasMap,
+            }
+            : undefined,
+        contacts: {
+            email: org?.email,
+            whatsapp: org?.telephone,
+            telegram_requests: '@AntonVargov (https://t.me/AntonVargov)',
+            telegram_channel: '@vargov_design (https://t.me/vargov_design)',
+        },
+        dealers: {
+            official_dealers_page: ru ? `${SITE}/official-dealers` : `${SITE}/en/official-dealers`,
+            installations_page: ru ? `${SITE}/official-dealers` : `${SITE}/en/official-dealers`,
+            installations_list: 'https://raw.githubusercontent.com/vargov3-spec/vargov-ai-kb/main/knowledge/installations.md',
+        },
+        languages: {
+            site: ['ru', 'en', 'de', 'it', 'fr', 'es', 'vi', 'ar'],
+            site_pattern: `${SITE}/<lang>/…  (Russian at the root, English at /en)`,
+            knowledge_base_only: ['zh'],
+            production_brief: ['ru', 'en'],
+        },
+        links: {
+            site: SITE,
+            site_llms: `${SITE}/llms.txt`,
+            knowledge_base: 'https://github.com/vargov3-spec/vargov-ai-kb',
+            knowledge_base_llms_en: 'https://raw.githubusercontent.com/vargov3-spec/vargov-ai-kb/main/en/llms.txt',
+            knowledge_base_llms_ru: 'https://raw.githubusercontent.com/vargov3-spec/vargov-ai-kb/main/llms.txt',
+            configurator_llms: 'https://vargov.design/llms.txt',
+            dataset_huggingface: 'https://huggingface.co/datasets/vargov-design/vargov-design-catalog',
+            dataset_json: 'https://raw.githubusercontent.com/vargov3-spec/vargov-ai-kb/main/datasets/products.json',
+            catalog_jsonld: 'https://raw.githubusercontent.com/vargov3-spec/vargov-ai-kb/main/references/catalog.jsonld',
+            press_kit: ru ? `${SITE}/press` : `${SITE}/en/press`,
+            social: org?.sameAs,
+        },
+        data_snapshot: d.manifest ? { updated_at: d.manifest.updated_at, files: d.manifest.files?.map((f) => ({ file: f.file, sha256: f.sha256.slice(0, 16) })) } : undefined,
+        licence: 'Data: CC BY 4.0 (Vargov®Design). Server code: MIT.',
+        ...extra,
+    };
+}
+/** Deep copy of a JSON value with every property named `key` removed at any depth. */
+function withoutKey(value, key) {
+    if (Array.isArray(value))
+        return value.map((v) => withoutKey(v, key));
+    if (value && typeof value === 'object') {
+        return Object.fromEntries(Object.entries(value).filter(([k]) => k !== key).map(([k, v]) => [k, withoutKey(v, key)]));
+    }
+    return value;
+}

package/dist/catalog.js

@@ -0,0 +1,329 @@
+// Tool logic: search, composition card, configurator link. Pure functions over getData().
+import { FAMILIES, LANGS, getData, normalizeCode } from './data.js';
+export const SEARCH_LIMIT_MAX = 50;
+export const SEARCH_LIMIT_DEFAULT = 10;
+const TEXT_CAP = 2000;
+export const SITE = 'https://vargov.ru';
+/** Hosts of the configurator: the Russian interface lives on the Russian copy, every other language on vargov.design
+ *  (docs/ssylka-i-tekst-dlya-tz.md of the configurator, section 4; the knowledge base links them the same way). */
+export const CONFIGURATOR_RU = 'https://configurator.vargov.ru/';
+export const CONFIGURATOR_INTL = 'https://vargov.design/';
+export function cap(s, n = TEXT_CAP) {
+    if (!s)
+        return undefined;
+    return s.length > n ? s.slice(0, n - 1).trimEnd() + '…' : s;
+}
+export function sitePage(code, lang = 'en') {
+    const slug = code.toLowerCase();
+    return lang === 'ru' ? `${SITE}/catalog/${slug}` : `${SITE}/${lang}/catalog/${slug}`;
+}
+const CODE_RE = /^lc\d{4}(-\d)?$/i;
+function tokens(q) {
+    return q
+        .toLowerCase()
+        .normalize('NFC')
+        .split(/[^\p{L}\p{N}-]+/u)
+        .map((t) => t.replace(/^-+|-+$/g, ''))
+        .filter((t) => t.length >= 2);
+}
+const esc = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+const WORD_START = '(?:^|[^\\p{L}\\p{N}])';
+const WORD_END = '(?=$|[^\\p{L}\\p{N}])';
+/**
+ * Word-level matching with a light stem tolerance:
+ *  - short tokens (< 5 letters) match whole words only ("spa" does not find "space");
+ *  - longer tokens match the start of a word ("lobby" finds "lobbies"), and so do their stems
+ *    minus one letter (≥ 5) and minus two letters (≥ 7): "гостиная" finds "гостиной".
+ */
+function compileToken(t) {
+    const isCode = CODE_RE.test(t) || /^\d{4}$/.test(t);
+    if (isCode)
+        return { raw: t, code: normalizeCode(t), res: [] };
+    const res = [];
+    if (t.length < 5)
+        res.push(new RegExp(WORD_START + esc(t) + WORD_END, 'u'));
+    else {
+        res.push(new RegExp(WORD_START + esc(t), 'u'));
+        res.push(new RegExp(WORD_START + esc(t.slice(0, -1)), 'u'));
+        if (t.length >= 7)
+            res.push(new RegExp(WORD_START + esc(t.slice(0, -2)), 'u'));
+    }
+    return { raw: t, code: null, res };
+}
+function hit(field, tok) {
+    if (!field)
+        return false;
+    for (const re of tok.res)
+        if (re.test(field))
+            return true;
+    return false;
+}
+function scoreEntry(e, toks) {
+    let score = 0;
+    let matched = 0;
+    for (const t of toks) {
+        let s = 0;
+        if (t.code) {
+            // a code token matches codes only — no tolerance, or "LC0564" would bring every LC05xx
+            if (e.code === t.code)
+                s += 1000;
+            else if (e.code.startsWith(t.code))
+                s += 500; // LC0543 also brings LC0543-1, LC0543-2
+            if (s > 0)
+                matched++;
+            score += s;
+            continue;
+        }
+        if (hit(e.f.code, t))
+            s += 100;
+        if (hit(e.f.type, t))
+            s += 10;
+        if (hit(e.f.where, t))
+            s += 5;
+        if (hit(e.f.style, t))
+            s += 3;
+        if (hit(e.f.desc, t))
+            s += 1;
+        if (s === 0 && hit(e.f.other, t))
+            s += 1;
+        if (s > 0)
+            matched++;
+        score += s;
+    }
+    return { score, matched };
+}
+export function searchCompositions(params) {
+    const d = getData();
+    const limit = Math.max(1, Math.min(SEARCH_LIMIT_MAX, Math.floor(params.limit ?? SEARCH_LIMIT_DEFAULT)));
+    const toks = tokens(params.query ?? '').map(compileToken);
+    let pool = d.entries.filter((e) => {
+        if (params.family && e.p.category !== params.family)
+            return false;
+        if (params.lit !== undefined && e.lit !== params.lit)
+            return false;
+        if (params.awarded !== undefined && e.p.award_winning !== params.awarded)
+            return false;
+        if (params.configurable !== undefined && e.configurable !== params.configurable)
+            return false;
+        return true;
+    });
+    let note;
+    let scored;
+    if (toks.length === 0) {
+        scored = pool.map((e) => ({ e, score: 0 }));
+    }
+    else {
+        const all = pool.map((e) => ({ e, ...scoreEntry(e, toks) }));
+        let kept = all.filter((x) => x.matched === toks.length && x.score > 0);
+        if (kept.length === 0) {
+            kept = all.filter((x) => x.score > 0);
+            if (kept.length > 0)
+                note = 'No composition matched every word of the query; showing compositions that match some of them.';
+        }
+        scored = kept;
+    }
+    scored.sort((a, b) => b.score - a.score || Number(b.e.p.award_winning) - Number(a.e.p.award_winning) || a.e.code.localeCompare(b.e.code));
+    const results = scored.slice(0, limit).map(({ e }) => toRow(e));
+    return { total_matches: scored.length, shown: results.length, results, ...(note ? { note } : {}) };
+}
+function toRow(e) {
+    return {
+        code: e.code,
+        name_en: e.nameEn,
+        name_ru: e.nameRu,
+        family: e.p.category,
+        type_en: e.p.type?.en ?? '',
+        configurable: e.configurable,
+        kind: e.kind,
+        awarded: e.p.award_winning,
+        lit_hint: e.lit,
+        page_en: e.p.urls?.en ?? sitePage(e.code, 'en'),
+        page_ru: e.p.urls?.ru ?? sitePage(e.code, 'ru'),
+        image: e.p.image,
+        snippet_en: cap(e.p.snippet?.en, 200),
+    };
+}
+// ---------------------------------------------------------------------------------------------
+// get_composition
+export function findEntry(codeInput) {
+    return getData().byCode.get(normalizeCode(codeInput)) ?? null;
+}
+export function mountSchemeNote(kind) {
+    switch (kind) {
+        case 'ribbon':
+            return 'No 1:1 ceiling drawing: a ribbon has no cloud of elements; it is built differently.';
+        case 'frame':
+            return 'No 1:1 ceiling drawing: the elements have no strands of their own to the ceiling — they hang from the frame, and the frame itself is suspended from the ceiling; the IFC4 file records the number of frame suspensions (property SuspensionCount) but not their coordinates, and the suspension points themselves are shown on the frame drawing and on the side view in the configurator.';
+        case 'ready-scene':
+            return 'No 1:1 ceiling drawing: it is a wall sconce — the composition is ready-made rather than calculated, so there is no layout and no ceiling setting-out; the IFC4 file has no ceiling fixing points.';
+        default:
+            return null;
+    }
+}
+export function hasMountScheme(kind) {
+    return kind === 'cloud' || kind === 'chain';
+}
+export function kindNotes(code, kind) {
+    const notes = [];
+    if (kind === 'ribbon')
+        notes.push('Ribbon: the plan Length/Width and the composition height are read from the link; the ribbon shape (wave/spiral) is chosen in the configurator; the FBX export button of a ribbon is in the ribbon panel.');
+    if (kind === 'chain')
+        notes.push('Chain composition: the form card has no effect on the assembly — the configurator lays the chain out with its own engine.');
+    if (kind === 'frame')
+        notes.push('Composition on a load-bearing frame: the number of elements is computed by the configurator from the frame pitch and length and cannot be typed by hand.');
+    if (kind === 'ready-scene')
+        notes.push('Ready scene: the composition opens as its own 3D model; plan dimensions in the link are replaced by the size of the piece; there is no ceiling-height field: the IFC4 model is placed under a 2,700 mm ceiling (the default), and the file does not declare that height as a property.');
+    if (code === 'LC0106')
+        notes.push('LC0106: instead of plan dimensions the configurator takes the number of jellyfish and the gap between them (link keys jelly and jgap); w/l/h in the link are not used for this composition.');
+    return notes;
+}
+export function compositionCard(codeInput, lang = 'en') {
+    const d = getData();
+    const e = findEntry(codeInput);
+    if (!e)
+        return null;
+    const p = e.p;
+    const L = LANGS.includes(lang) ? lang : 'en';
+    const sk = d.sketchfab.get(e.code);
+    const configurator = e.configurable
+        ? {
+            opens_with_full_calculation: true,
+            kind: e.kind,
+            exports: ['IFC4 model (BIM)', 'FBX model (3ds Max)', 'PDF specification', 'tender sheet'],
+            mount_scheme_1to1: hasMountScheme(e.kind),
+            ...(mountSchemeNote(e.kind) ? { mount_scheme_1to1_note: mountSchemeNote(e.kind) } : {}),
+            // element_size_series_mm (ряды размеров элементов из open-skus.json) снят 27.10.2026 до слова владельца:
+            // правило бренда «размеры не называть» — решение за ним, вернуть можно, восстановив этот блок из истории.
+            ...(d.open.mixPairs?.[e.code] ? { paired_with: d.open.mixPairs[e.code] } : {}),
+            link_en: linkUrl(e.code, 'en'),
+            link_ru: linkUrl(e.code, 'ru'),
+            notes: kindNotes(e.code, e.kind),
+            how_to_get_bim: 'call how_to_get_bim with this code',
+        }
+        : {
+            opens_with_full_calculation: false,
+            note: 'Calculated individually: the configurator does not calculate this composition, so it has no IFC4/FBX export, no PDF specification from the configurator and no 1:1 ceiling drawing. The link below opens the configurator showcase without a calculation; the production brief cannot be started for it. Contact the brand for a calculation.',
+            link_en: `${CONFIGURATOR_INTL}?sku=${encodeURIComponent(e.code)}&lang=en`,
+            link_ru: `${CONFIGURATOR_RU}?sku=${encodeURIComponent(e.code)}&lang=ru`,
+        };
+    const otherType = L !== 'ru' && L !== 'en' && p.type?.[L] ? { [L]: p.type[L] } : {};
+    return {
+        code: e.code,
+        name: { ru: e.nameRu, en: e.nameEn },
+        family: p.category,
+        family_label: p.category_label,
+        type: { ru: p.type?.ru, en: p.type?.en, ...otherType },
+        lit_hint: e.lit,
+        pages: p.urls,
+        image: p.image,
+        gallery_images: p.gallery_total,
+        texts: {
+            lang: L,
+            description: cap(p.description?.[L] ?? p.description?.en),
+            where_it_works: cap(p.where_it_works?.[L] ?? p.where_it_works?.en),
+            style: cap(p.style?.[L] ?? p.style?.en),
+            made_to_order: cap(p.made_to_order?.[L] ?? p.made_to_order?.en),
+        },
+        models_3d: {
+            ...(p.model3d ? { '3ddd_ru': p.model3d } : {}),
+            ...(p.model3d_en ? { '3dsky_en': p.model3d_en } : {}),
+            ...(p.models_all ? { all_models_3ddd: p.models_all } : {}),
+            ...(p.models_all_en ? { all_models_3dsky: p.models_all_en } : {}),
+            ...(sk ? { sketchfab: { url: sk.url, published_models_of_this_code: sk.count } } : {}),
+        },
+        awards: {
+            award_winning: p.award_winning,
+            list: (p.awards ?? []).map((a) => ({ program: a.program_en ?? a.program, year: a.year, level_en: a.level_en, level_ru: a.level_ru, source: a.href })),
+        },
+        certification: {
+            certified: p.cert !== null && p.cert !== undefined,
+            note: p.cert
+                ? 'Covered by the brand\'s EAEU serial certification (every unit of the article, not a batch). Details: https://vargov.ru/en/certification'
+                : 'Not in the list of certified articles of the dataset snapshot. Details: https://vargov.ru/en/certification',
+        },
+        configurator,
+        elements_in_stock: 'Stock changes four times a day; see https://vargov.ru/en/in-stock',
+        not_published: 'No price, no materials and no composition dimensions are published: every composition is made to order and scaled to the room. Quotes come per request (info@vargov.ru, WhatsApp +7 916 537 33 52, Telegram @AntonVargov).',
+    };
+}
+/** The configurator does not build a plan smaller than 300 × 300 mm (link-keys contract, memory of the configurator's author, 25.09.2026). */
+export const PLAN_MIN_MM = 300;
+/** Sanity ceiling of this server, not a rule of the configurator. */
+const MM_SANITY_MAX = 50_000;
+function intMm(name, v, min) {
+    if (v === undefined || v === null)
+        return undefined;
+    if (!Number.isFinite(v) || !Number.isInteger(v))
+        return { error: `${name} must be an integer number of millimetres (the configurator reads integer mm only)` };
+    if (v < min)
+        return { error: `${name} must be at least ${min} mm` + (min === PLAN_MIN_MM ? ' — the configurator does not build a plan smaller than 300 × 300 mm' : '') };
+    if (v > MM_SANITY_MAX)
+        return { error: `${name} exceeds ${MM_SANITY_MAX} mm — check the units (millimetres expected)` };
+    return v;
+}
+export function buildConfiguratorLink(params) {
+    const d = getData();
+    const code = normalizeCode(params.code);
+    const e = d.byCode.get(code);
+    const lang = params.lang && LANGS.includes(params.lang) ? params.lang : 'en';
+    if (!d.openSet.has(code)) {
+        return {
+            error: e
+                ? `${code} is calculated individually: the configurator does not open it with a calculation (360 of 605 compositions do). A link with ?sku=${code} would only open the showcase. Use the product page and contact the brand for a calculation.`
+                : `${code} is not a code of the Vargov®Design catalogue (LC0001…LC0602, some with a -1/-2 suffix). Use search_compositions to find the code.`,
+            code,
+            ...(e ? { product_page: e.p.urls?.[lang] ?? sitePage(code, lang) } : {}),
+        };
+    }
+    const w = intMm('lengthMm', params.lengthMm, PLAN_MIN_MM);
+    const l = intMm('widthMm', params.widthMm, PLAN_MIN_MM);
+    const h = intMm('heightMm', params.heightMm, 1);
+    const ceil = intMm('ceilingMm', params.ceilingMm, 1);
+    for (const v of [w, l, h, ceil])
+        if (v && typeof v === 'object')
+            return v;
+    const q = new URLSearchParams();
+    const keys = {};
+    q.set('sku', code);
+    keys.sku = 'article code';
+    if (typeof w === 'number') {
+        q.set('w', String(w));
+        keys.w = 'the "Length" field of the plan, mm (the letter is misleading: w = Length)';
+    }
+    if (typeof l === 'number') {
+        q.set('l', String(l));
+        keys.l = 'the "Width" field of the plan, mm (l = Width)';
+    }
+    if (typeof h === 'number') {
+        q.set('h', String(h));
+        keys.h = 'height of the cloud of elements, mm (for a ribbon: the composition height)';
+    }
+    if (typeof ceil === 'number') {
+        q.set('ceil', String(ceil));
+        keys.ceil = 'room ceiling height, mm (default 2700): goes into the IFC4 file and AR, does not change the layout';
+    }
+    q.set('lang', lang);
+    keys.lang = 'interface language';
+    if (params.openOnFormStep) {
+        q.set('step', 'form');
+        keys.step = 'form — opens the page scrolled to the "Composition form" step';
+    }
+    const host = lang === 'ru' ? CONFIGURATOR_RU : CONFIGURATOR_INTL;
+    const notes = [
+        lang === 'ru'
+            ? 'Russian interface: the Russian copy configurator.vargov.ru; the same query works on vargov.design.'
+            : 'Visitors from Russia are redirected from vargov.design to configurator.vargov.ru with the same query.',
+        'All dimensions are integer millimetres. The plan Length × Width is the zone the composition is laid out in, not a product size; the composition is scaled to it.',
+        'Element sizes, colours and the composition form are chosen in the configurator; its "Share" button then copies a link that reopens the exact same calculation (the address bar does not reflect the state).',
+        ...kindNotes(code, d.byCode.get(code)?.kind ?? null),
+    ];
+    return { url: host + '?' + q.toString(), code, lang, keys, notes };
+}
+export function isLinkError(x) {
+    return !!x && typeof x === 'object' && 'error' in x;
+}
+function linkUrl(code, lang) {
+    const r = buildConfiguratorLink({ code, lang });
+    return isLinkError(r) ? null : r.url;
+}
+export { FAMILIES };