Type Exports

Die Paket-Exportfläche für ESM-Registry, Loader, API, RMT, Fabric und Komponenten.

Worum es geht

package.json ordnet jedem öffentlichen Subpath eine Runtime-Datei und, wo vorhanden, eine types Condition zu. Consumer importieren diese Subpaths; direkte Zugriffe auf interne Source- oder Testpfade sind nicht stabil.

Öffentliche Bausteine

. und ./registry exponieren die Browser-Registry über xtend.d.ts und den DOM-neutralen Node-Vertrag über xtend.ssr.d.ts.
./loader und ./api decken den expliziten Classic-Browser-Bootstrap und die UI-API ab.
./rmt, ./rmt/browser und RMT-Language-Subpaths decken Runtime und Tooling ab.
Fabric-, Maraca-, Builder- und Komponenten-Subpaths verweisen auf co-located .d.ts Dateien.

RMT TypeScript-Oberfläche

Der Root-Einstieg löst die benannten Aliase aus xtend.d.ts auf. Browserfähige Resolver verwenden xtend.js; Node und SSR verwenden xtend.ssr.mjs zusammen mit xtend.ssr.d.ts.

import { schedule, render, createApp, createStore } from '@ccslabs/xtend';
import type { XTendScheduleOptions, XTendRegistryConfiguration } from '@ccslabs/xtend';

XTend veröffentlicht die RMT-Laufzeit und die RMT-Werkzeuge mit stabilen types Conditions. Dadurch können Hosts die deklarative RMT-Schicht verwenden, ohne interne Quellen oder Build-Artefakte zu importieren.

import { createRmtRuntime } from '@ccslabs/xtend/rmt';
import { createRmtBrowserRuntime } from '@ccslabs/xtend/rmt/browser';
import { compileRmtVNextSource } from '@ccslabs/xtend/rmt-language/vnext-compiler';

Die wichtigsten Deklarationsdateien sind ./xtendrmt/rmt-core.d.ts für Kernel- und Browser-Runtime APIs sowie ./tools/rmt-language/rmt-tooling-public-types.d.ts für Editor-, Linter- und Language-Server-Integrationen. Diese Oberfläche enthält unter anderem RmtToolingDiagnostic, RmtTextEdit, RmtWorkspaceEdit, RmtLanguageServiceReport und RmtJsonRpcMessage.

Gate-Vertrag

plan: xtend.type-exports.plan.v1
drift report: xtend.type-exports.drift-report.v1
local gate: node scripts/run_xtend_tests.js type-exports --json
release gate: npm run test:type-exports:release
registry types: ./xtend.d.ts, ./xtend.ssr.d.ts
loader types: ./xtend-loader.d.ts via ./loader
api types: ./api.d.ts
decision: types-not-required

Maraca ist als Package-Export ./maraca und ./maraca/runtime klassifiziert und nutzt ./xtend-maraca/index.d.ts sowie ./xtend-maraca/runtime.d.ts.

Gepflegte Declaration-Wellen

WP-TypeExports-03: Core-API-Deklarationen in ./api.d.ts; siehe ./xtend-api-types.md.
WP-TypeExports-05: gemeinsame Policy-Deklarationen in ./fabric/xtend-policy-public-types.d.ts; siehe ./xtend-policy-types.md.
WP-TypeExports-06: Builder-Deklarationen teilen ./xtend-builder/builder-public-types.d.ts; siehe ./xtend-builder-types.md.
WP-TypeExports-07: Catalog-Deklarationen teilen ./catalog/catalog-public-types.d.ts; siehe ./xtend-catalog-types.md.
WP-TypeExports-08: Vendor-Deklarationen umfassen ./design-tokens/xtend-design-tokens.d.ts, ./design-tokens/xtheme-token-alias-layer.d.ts und ./components/prism.d.ts; siehe ./xtend-vendor-types.md.

Empfohlener Ablauf

Importiere ausschließlich einen Eintrag aus package.json#exports und lasse TypeScript mit derselben Package-Version auflösen. Prüfe Änderungen mit node scripts/run_xtend_tests.js type-exports --json; fehlende Types werden entweder ergänzt oder ausdrücklich als Runtime-only klassifiziert.

XTend Developer Center