@rynt/extension-build 0.9.0 → 0.9.1

package/package.json

@@ -1,14 +1,22 @@
 {
   "name": "@rynt/extension-build",
-  "version": "0.9.0",
+  "version": "0.9.1",
   "description": "Vite preset, host-shims and .ryntextension packer for Rynt Launcher extensions",
   "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
       "default": "./dist/index.js"
     }
   },
+  "files": [
+    "dist",
+    "shims",
+    "bin"
+  ],
   "bin": {
     "rynt-extension-pack": "./bin/pack.mjs"
   },
@@ -40,7 +48,8 @@
   "scripts": {
     "gen-host-shims": "node ./scripts/write-host-shims.mjs",
     "build": "tsc -p tsconfig.json",
-    "prepare": "pnpm run build"
+    "prepare": "pnpm run build",
+    "prepublishOnly": "pnpm run build"
   },
   "publishConfig": {
     "access": "public"

package/scripts/write-host-shims.mjs

@@ -1,68 +0,0 @@
-/**
- * Генерирует `shims/*.host-shim.js`: реэкспорт с `globalThis.__RYNT_EXTENSION_HOST_MODULES__`.
- *
- * Запуск: `pnpm --filter @rynt/extension-build run gen-host-shims`
- */
-import { mkdirSync, writeFileSync } from 'node:fs';
-import { dirname, join } from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-import * as tiptapCore from '@tiptap/core';
-import * as vue from 'vue';
-import * as vueRouter from 'vue-router';
-
-/** @type {readonly string[]} */
-export const RYNT_EXTENSION_HOST_TIPTAP_SPECIFIERS = ['@tiptap/core'];
-
-const root = dirname(fileURLToPath(import.meta.url));
-const shimsDir = join(root, '..', 'shims');
-mkdirSync(shimsDir, { recursive: true });
-
-const banner = `/* eslint-disable -- generated by write-host-shims.mjs */\n`;
-
-const header = `${banner}
-const HOST = '__RYNT_EXTENSION_HOST_MODULES__';
-
-function registry() {
-  const r = globalThis[HOST];
-  if (!r) {
-    throw new Error(
-      '[rynt/extension-build] Missing globalThis.' +
-        HOST +
-        ' — call registerRyntExtensionHostModules() in the launcher before loading extensions.',
-    );
-  }
-  return r;
-}
-`;
-
-/**
- * @param {string} fileBase
- * @param {string} slot
- * @param {Record<string, unknown>} mod
- */
-function writeNamespaceShim(fileBase, slot, mod) {
-  const keys = Object.keys(mod).filter(
-    (k) => k !== '__esModule' && k !== 'default',
-  );
-  const lines = [
-    header,
-    `const $ = registry()['${slot}'];`,
-    `if (!$) {`,
-    `  throw new Error('[rynt/extension-build] Host did not register module ${slot}');`,
-    `}`,
-    '',
-    ...keys.map((k) => `export const ${k} = $.${k};`),
-    '',
-  ];
-  writeFileSync(join(shimsDir, `${fileBase}.host-shim.js`), lines.join('\n'));
-}
-
-writeNamespaceShim('vue', 'vue', vue);
-writeNamespaceShim('vue-router', 'vue-router', vueRouter);
-writeNamespaceShim('tiptap-core', '@tiptap/core', tiptapCore);
-
-console.info(
-  '[write-host-shims] wrote vue, vue-router, @tiptap/core →',
-  shimsDir,
-);

package/src/extension-dev-bridge.ts

@@ -1,132 +0,0 @@
-import path from 'node:path';
-import { readFileSync } from 'node:fs';
-
-import type { Plugin } from 'vite';
-
-import { mergeExtensionManifestForDist } from './extension-manifest.js';
-
-/** URL dev-hub лаунчера по умолчанию (см. extension-dev-hub.ts). */
-export const RYNT_LAUNCHER_DEV_HUB_DEFAULT = 'http://127.0.0.1:39217';
-
-function devHubBaseUrl(): string {
-  return (
-    process.env.RYNT_LAUNCHER_DEV_HUB?.trim().replace(/\/+$/u, '') ||
-    RYNT_LAUNCHER_DEV_HUB_DEFAULT
-  );
-}
-
-function isDevBridgeActive(): boolean {
-  if (process.env.RYNT_DEV_BRIDGE === '0') return false;
-  return process.env.RYNT_DEV === '1' || process.env.RYNT_DEV === 'true';
-}
-
-async function postJson(url: string, body: Record<string, unknown>): Promise<void> {
-  const res = await fetch(url, {
-    method: 'POST',
-    headers: { 'Content-Type': 'application/json', Accept: 'application/json' },
-    body: JSON.stringify(body),
-  });
-  if (!res.ok) {
-    const text = await res.text().catch(() => '');
-    throw new Error(`HTTP ${res.status}${text ? `: ${text}` : ''}`);
-  }
-}
-
-function readManifestFromDist(distDir: string): Record<string, unknown> | null {
-  try {
-    const manifestPath = path.join(distDir, 'manifest.json');
-    const raw = readFileSync(manifestPath, 'utf-8');
-    const parsed: unknown = JSON.parse(raw);
-    if (parsed !== null && typeof parsed === 'object' && !Array.isArray(parsed)) {
-      return parsed as Record<string, unknown>;
-    }
-  } catch {
-    /* ignore */
-  }
-  return null;
-}
-
-let unregisterHookInstalled = false;
-let lastRegisteredId: string | null = null;
-
-function installUnregisterHook(extensionId: string): void {
-  lastRegisteredId = extensionId;
-  if (unregisterHookInstalled) return;
-  unregisterHookInstalled = true;
-
-  const unregister = () => {
-    if (!lastRegisteredId) return;
-    const id = lastRegisteredId;
-    void postJson(`${devHubBaseUrl()}/api/v1/dev/extensions/unregister`, { id }).catch(
-      () => {
-        /* hub может быть уже остановлен */
-      },
-    );
-  };
-
-  process.once('SIGINT', () => {
-    unregister();
-    process.exit(0);
-  });
-  process.once('SIGTERM', unregister);
-}
-
-/**
- * При `RYNT_DEV=1` + `vite build --watch` регистрирует dist/ в dev-hub лаунчера
- * после каждой сборки и снимает регистрацию при завершении процесса.
- *
- * Должен быть объявлен **до** `ryntExtensionEmitDistManifestPlugin`: Rollup вызывает
- * `closeBundle` в обратном порядке, manifest пишется первым, регистрация — второй.
- */
-export function ryntExtensionDevBridgePlugin(options: {
-  root: string;
-  manifestFromVite?: Record<string, unknown>;
-}): Plugin {
-  const distDir = path.join(options.root, 'dist');
-  let watchMode = false;
-
-  return {
-    name: 'rynt-extension-dev-bridge',
-    apply: 'build',
-
-    config(config) {
-      watchMode = Boolean(config.build?.watch);
-    },
-
-    async closeBundle() {
-      if (!isDevBridgeActive() && !watchMode) return;
-
-      const manifest =
-        readManifestFromDist(distDir) ??
-        (options.manifestFromVite
-          ? mergeExtensionManifestForDist(options.root, options.manifestFromVite)
-          : null);
-      if (!manifest) {
-        console.warn(
-          '[rynt/extension-build] dev-bridge: dist/manifest.json не найден, пропуск',
-        );
-        return;
-      }
-
-      const rootDir = path.resolve(distDir);
-      const hub = devHubBaseUrl();
-
-      try {
-        await postJson(`${hub}/api/v1/dev/extensions/register`, {
-          manifest,
-          rootDir,
-        });
-        const id = typeof manifest.id === 'string' ? manifest.id : '';
-        if (id) installUnregisterHook(id);
-        console.info(`[rynt/extension-build] dev-bridge: зарегистрировано ${id} → ${hub}`);
-      } catch (e) {
-        const msg = e instanceof Error ? e.message : String(e);
-        console.warn(
-          `[rynt/extension-build] dev-bridge: не удалось связаться с лаунчером (${hub}): ${msg}`,
-        );
-      }
-    },
-  };
-}
-
-export { isDevBridgeActive };

package/src/extension-icon.ts

@@ -1,120 +0,0 @@
-import { copyFileSync, existsSync, mkdirSync } from 'node:fs';
-import path from 'node:path';
-
-import { Jimp } from 'jimp';
-
-/** Максимальная сторона иконки в px после сборки. */
-export const EXTENSION_ICON_MAX_SIZE = 512;
-
-/** Имя файла иконки в `dist/` (растровая). */
-export const EXTENSION_ICON_DIST_PNG = 'icon.png';
-
-const RASTER_EXTENSIONS = new Set([
-  '.png',
-  '.jpg',
-  '.jpeg',
-  '.webp',
-  '.bmp',
-  '.gif',
-  '.tiff',
-  '.tif',
-]);
-
-export function isRemoteOrDataIcon(value: string): boolean {
-  return /^(https?:|data:)/i.test(value.trim());
-}
-
-export function isBundledExtensionIconRef(value: string): boolean {
-  const normalized = value.trim().replace(/\\/g, '/');
-  if (normalized.includes('/')) return false;
-  const base = normalized.toLowerCase();
-  return (
-    base === EXTENSION_ICON_DIST_PNG
-    || base === 'icon.jpg'
-    || base === 'icon.jpeg'
-    || base === 'icon.webp'
-    || base === 'icon.svg'
-  );
-}
-
-/** Локальный путь к исходнику иконки (относительно корня расширения). */
-export function isLocalIconSource(value: string): boolean {
-  const trimmed = value.trim();
-  if (!trimmed) return false;
-  if (isRemoteOrDataIcon(trimmed)) return false;
-  if (isBundledExtensionIconRef(trimmed)) return false;
-  return true;
-}
-
-/**
- * Берёт исходник по пути из vite-манифеста, кладёт в `dist/` и возвращает относительное имя
- * для `manifest.icon` (например `icon.png`).
- *
- * Растровые форматы масштабируются до {@link EXTENSION_ICON_MAX_SIZE}px по длинной стороне.
- * SVG копируется как есть (вектор не растеризуем — без native/wasm deps).
- */
-export async function processExtensionIconForDist(
-  root: string,
-  iconSource: string,
-  distDir: string,
-): Promise<string> {
-  const trimmed = iconSource.trim();
-  if (!isLocalIconSource(trimmed)) {
-    throw new Error(
-      `[rynt/extension-build] icon «${iconSource}» — не локальный путь к файлу`,
-    );
-  }
-
-  const absSource = path.resolve(root, trimmed);
-  if (!existsSync(absSource)) {
-    throw new Error(`[rynt/extension-build] icon file not found: ${absSource}`);
-  }
-
-  mkdirSync(distDir, { recursive: true });
-  const ext = path.extname(absSource).toLowerCase();
-
-  if (ext === '.svg') {
-    const destName = 'icon.svg';
-    copyFileSync(absSource, path.join(distDir, destName));
-    return destName;
-  }
-
-  if (!RASTER_EXTENSIONS.has(ext)) {
-    throw new Error(
-      `[rynt/extension-build] unsupported icon format «${ext}» (${absSource}); ` +
-        'use PNG, JPEG, WebP, GIF, BMP, TIFF or SVG',
-    );
-  }
-
-  const image = await Jimp.read(absSource);
-  if (
-    image.width > EXTENSION_ICON_MAX_SIZE
-    || image.height > EXTENSION_ICON_MAX_SIZE
-  ) {
-    image.scaleToFit({ w: EXTENSION_ICON_MAX_SIZE, h: EXTENSION_ICON_MAX_SIZE });
-  }
-
-  const destPath = path.join(distDir, EXTENSION_ICON_DIST_PNG);
-  await image.write(destPath as `${string}.${string}`);
-  return EXTENSION_ICON_DIST_PNG;
-}
-
-/**
- * Если в манифесте указан локальный путь — обрабатывает иконку и подменяет поле на имя файла в dist.
- * URL / data: URI остаются без изменений.
- */
-export async function applyExtensionIconToManifest(
-  root: string,
-  manifest: Record<string, unknown>,
-): Promise<void> {
-  const raw = manifest.icon;
-  if (typeof raw !== 'string' || !raw.trim()) return;
-
-  if (isRemoteOrDataIcon(raw) || isBundledExtensionIconRef(raw)) {
-    return;
-  }
-
-  const distDir = path.join(root, 'dist');
-  const distIcon = await processExtensionIconForDist(root, raw, distDir);
-  manifest.icon = distIcon;
-}

package/src/extension-manifest.ts

@@ -1,187 +0,0 @@
-import {
-  existsSync,
-  mkdirSync,
-  readFileSync,
-  writeFileSync,
-} from 'node:fs';
-import { createRequire } from 'node:module';
-import path from 'node:path';
-
-import type { Plugin } from 'vite';
-
-import { applyExtensionIconToManifest } from './extension-icon.js';
-
-const require = createRequire(import.meta.url);
-
-/** Валидация манифеста через SDK (devDependency extension-build, не бандлится в расширение). */
-async function loadManifestValidators(): Promise<{
-  normalizeExtensionApiInManifest: (
-    manifest: { extensionApi?: string; id?: string },
-    options?: { extensionId?: string },
-  ) => string | null;
-  applyValidatedRyntContributesToManifest: (manifest: {
-    id: string;
-    contributes?: Record<string, unknown>;
-  }) => string | null;
-}> {
-  const { createJiti } = await import('jiti');
-  const jiti = createJiti(import.meta.url, { interopDefault: true });
-  const extEntry = require.resolve('@rynt/sdk/extension');
-  const srcRoot = path.join(path.dirname(extEntry), '..');
-  const versionMod = jiti(path.join(srcRoot, 'extensions/version.ts')) as {
-    normalizeExtensionApiInManifest: (
-      manifest: { extensionApi?: string; id?: string },
-      options?: { extensionId?: string },
-    ) => string | null;
-  };
-  const ryntMod = jiti(
-    path.join(srcRoot, 'extensions/registries/manifest-rynt.ts'),
-  ) as {
-    applyValidatedRyntContributesToManifest: (manifest: {
-      id: string;
-      contributes?: Record<string, unknown>;
-    }) => string | null;
-  };
-  return {
-    normalizeExtensionApiInManifest: versionMod.normalizeExtensionApiInManifest,
-    applyValidatedRyntContributesToManifest:
-      ryntMod.applyValidatedRyntContributesToManifest,
-  };
-}
-
-function readJsonObject(filePath: string): Record<string, unknown> {
-  if (!existsSync(filePath)) {
-    return {};
-  }
-  try {
-    const raw = readFileSync(filePath, 'utf-8');
-    const parsed: unknown = JSON.parse(raw);
-    return typeof parsed === 'object' && parsed !== null && !Array.isArray(parsed)
-      ? (parsed as Record<string, unknown>)
-      : {};
-  } catch (e) {
-    console.warn(`[rynt/extension-build] Failed to read JSON at ${filePath}:`, e);
-    return {};
-  }
-}
-
-function versionFromPackageJson(pkg: Record<string, unknown>): string | null {
-  const v = pkg.version;
-  if (v == null) return null;
-  const s = String(v).trim();
-  return s.length > 0 ? s : null;
-}
-
-function manifestVersionString(value: unknown): string | null {
-  if (typeof value === 'string') {
-    const t = value.trim();
-    return t.length > 0 ? t : null;
-  }
-  if (typeof value === 'number' && Number.isFinite(value)) {
-    return String(value);
-  }
-  return null;
-}
-
-export function mergeExtensionManifestForDist(
-  root: string,
-  manifestFromVite: Record<string, unknown>,
-): Record<string, unknown> {
-  const pkg = readJsonObject(path.join(root, 'package.json'));
-  const merged: Record<string, unknown> = { ...manifestFromVite };
-
-  if (typeof merged.name !== 'string' || !merged.name) {
-    if (typeof pkg.name === 'string' && pkg.name) merged.name = pkg.name;
-  }
-  const fromManifest = manifestVersionString(merged.version);
-  const fromPkg = versionFromPackageJson(pkg);
-  if (fromManifest) {
-    merged.version = fromManifest;
-  } else if (fromPkg) {
-    merged.version = fromPkg;
-  } else {
-    merged.version = '0.0.0';
-    console.warn(
-      '[rynt/extension-build] В manifest и package.json нет version — подставлено 0.0.0.',
-    );
-  }
-  if (merged.description === undefined || merged.description === null) {
-    if (typeof pkg.description === 'string' && pkg.description) {
-      merged.description = pkg.description;
-    }
-  }
-  if (typeof merged.id !== 'string' || !merged.id) {
-    if (typeof pkg.name === 'string' && pkg.name) merged.id = pkg.name;
-  }
-  if (typeof merged.main !== 'string' || !merged.main) {
-    merged.main = 'index.js';
-  }
-
-  return merged;
-}
-
-export function ryntExtensionEmitDistManifestPlugin(options: {
-  root: string;
-  manifestFromVite: Record<string, unknown>;
-}): Plugin {
-  const { root, manifestFromVite } = options;
-  return {
-    name: 'rynt-extension-emit-dist-manifest',
-    apply: 'build',
-    async closeBundle() {
-      const merged = mergeExtensionManifestForDist(root, manifestFromVite);
-      if (typeof merged.id !== 'string' || !merged.id) {
-        console.warn(
-          '[rynt/extension-build] manifest.id обязателен; skip writing dist/manifest.json',
-        );
-        return;
-      }
-
-      try {
-        const { normalizeExtensionApiInManifest, applyValidatedRyntContributesToManifest } =
-          await loadManifestValidators();
-
-        const apiErr = normalizeExtensionApiInManifest(
-          merged as { extensionApi?: string; id?: string },
-          { extensionId: merged.id },
-        );
-        if (apiErr) {
-          console.warn(
-            `[rynt/extension-build] extensionApi для «${merged.id}»: ${apiErr}`,
-          );
-        }
-
-        const contribErr = applyValidatedRyntContributesToManifest({
-          id: merged.id,
-          contributes:
-            merged.contributes &&
-            typeof merged.contributes === 'object' &&
-            !Array.isArray(merged.contributes)
-              ? (merged.contributes as Record<string, unknown>)
-              : undefined,
-        });
-        if (contribErr) {
-          console.warn(
-            `[rynt/extension-build] contributes.rynt для «${merged.id}»: ${contribErr}`,
-          );
-        }
-      } catch (e) {
-        console.warn(
-          '[rynt/extension-build] Пропуск валидации manifest через SDK:',
-          e,
-        );
-      }
-
-      try {
-        await applyExtensionIconToManifest(root, merged);
-      } catch (e) {
-        const msg = e instanceof Error ? e.message : String(e);
-        throw new Error(msg);
-      }
-
-      const outPath = path.join(root, 'dist', 'manifest.json');
-      mkdirSync(path.dirname(outPath), { recursive: true });
-      writeFileSync(outPath, `${JSON.stringify(merged, null, 2)}\n`, 'utf-8');
-    },
-  };
-}