@thinking-home/ui

Базовая библиотека для разработки плагинов ThinkingHome System.

• общие интерфейсы и API для хоста и плагинов;
• сборка плагинов в самодостаточные ESM-бандлы (Vite), которые хост загружает через import(url).

Сборка плагина

Разработчику плагина не нужно добавлять Vite или конфиги — всё внутри @thinking-home/ui. Достаточно раннера th-build.

npm init -y
npm install @thinking-home/ui

Опиши точки входа — любым из двух способов:

A. По соглашению (без конфига): каждый файл в src/entries/ — это точка входа, имя бандла совпадает с именем файла.

src/entries/widget.tsx      ->  dist/widget.js
src/entries/settings.tsx    ->  dist/settings.js

B. Явно, в package.json (полный контроль над именами и путями):

{
  "thPlugin": {
    "entries": {
      "widget": "src/widget.tsx",
      "settings": "src/panels/settings.tsx"
    }
  }
}

Каждая точка входа экспортирует экземпляр плагина как default:

import React from "react";
import { createModule } from "@thinking-home/ui";

function Widget() {
  return <div>hello</div>;
}

export default createModule(Widget);

Собери:

{
  "scripts": {
    "build": "th-build"
  }
}

npm run build          # -> dist/widget.js, dist/settings.js (по одному на точку входа)
npm run build -- --mode development   # dev-сборка с sourcemap

В dist/ появится по одному самодостаточному ESM-бандлу на каждую точку входа — их можно грузить через import(url).

Экспорт хелперов

Если нужен собственный vite.config, базовый конфиг доступен отдельно:

import { createPluginConfig, resolveEntries } from "@thinking-home/ui/build";