⚙️

@tuvix.js/core

Çekirdek Orkestratör

Tuvix.js'in kalbi. Mikro uygulamaları kaydeder, yaşam döngülerini yönetir (mount, unmount, update) ve yönlendirme ile sandbox'ı koordine eder.

npm ↗ GitHub ↗

Kurulum

npm install @tuvix.js/core

Hızlı Başlangıç

import { createOrchestrator } from '@tuvix.js/core';

const orchestrator = createOrchestrator({ container: '#app' });

orchestrator.register('home', {
  entry: 'https://cdn.example.com/home.js',
});

orchestrator.register('dashboard', {
  entry: 'https://cdn.example.com/dashboard.js',
  props: { apiUrl: 'https://api.example.com' },
  sandbox: { css: true },
});

orchestrator.start();

API

createOrchestrator(options)

Ana orkestratör örneğini oluşturur.

interface OrchestratorConfig {
  container: string | HTMLElement;
  onBeforeMount?: (app: RegisteredApp) => void | Promise<void>;
  onAfterMount?: (app: RegisteredApp) => void | Promise<void>;
  onError?: (error: Error, app: RegisteredApp) => void;
}

orchestrator.register(name, options)

Bir mikro uygulama kaydeder.

interface AppOptions {
  entry: string | (() => Promise<string>);
  props?: Record<string, unknown>;
  container?: string | HTMLElement;
  sandbox?: { css?: boolean; js?: boolean };
}

orchestrator.mount(name, props?)

Bir mikro uygulamayı manuel olarak mount eder.

await orchestrator.mount('dashboard', { userId: '42' });

orchestrator.unmount(name)

Bir mikro uygulamayı manuel olarak unmount eder.

orchestrator.update(name, props)

Mount edilmiş bir mikro uygulamanın prop'larını günceller.

orchestrator.start()

Orkestratörü başlatır. Kayıtlı bir router varsa onunla entegre olur.

orchestrator.stop()

Orkestratörü durdurur. Tüm aktif mikro uygulamaları unmount eder ve temizler.

MicroApp Arayüzü

Mikro uygulama bundle'ınız bu arayüzü uygulayan bir nesne dışa aktarmalıdır:

interface MicroApp {
  mount(container: HTMLElement, props?: Record<string, unknown>): Promise<void>;
  unmount(container: HTMLElement): Promise<void>;
  update?(container: HTMLElement, props?: Record<string, unknown>): Promise<void>;
}

Örnek: Hata Sınırları

const orchestrator = createOrchestrator({
  container: '#app',

  onError(error, app) {
    console.error(`[${app.name}] çöktü:`, error);

    const container = document.querySelector(app.container as string);
    if (container) {
      container.innerHTML = `
        <div class="error-boundary">
          <p>Yüklenemedi. <button onclick="location.reload()">Yenile</button></p>
        </div>
      `;
    }
  },
});

TypeScript

import type { MicroAppDefinition, RegisteredApp, OrchestratorConfig } from '@tuvix.js/core';