@arki/dot 0.2.0 → 0.4.0

package/dist/define-app.js

@@ -1,12 +1,12 @@
 /**
  * Public entry point for the DOT kernel (v2).
  *
- * `defineApp(name)` returns a `DotAppBuilder` that accumulates pips via
- * `.use(pip)`, then transitions through the 5-hook lifecycle:
+ * `defineApp(name)` returns a `DotAppBuilder` that accumulates plugins via
+ * `.use(plugin)`, then transitions through the 5-hook lifecycle:
  *
  *   defineApp -> use* -> configure() -> boot() -> start() -> stop() -> dispose()
  *
- * `.use()` is compile-time guarded: a pip whose `needs` are not satisfied
+ * `.use()` is compile-time guarded: a plugin whose `needs` are not satisfied
  * by services provided so far — or whose provides collide with existing
  * wire keys — fails to typecheck at the call site ("Expected 2 arguments,
  * but got 1", with the diagnostic embedded in the expected second
@@ -25,8 +25,8 @@ import { renderTimeline } from './timeline.js';
  *
  * @example
  * const app = await defineApp('my-app')
- *   .use(dbPip)
- *   .use(billingPip)   // billing's needs must be satisfied by now
+ *   .use(dbPlugin)
+ *   .use(billingPlugin)   // billing's needs must be satisfied by now
  *   .boot();
  *
  * await app.start();
@@ -38,7 +38,7 @@ export function defineApp(name, options = {}) {
     const state = {
         appName: name,
         appVersion: options.version,
-        pips: [],
+        plugins: [],
         config: options.config,
         observers: options.observers,
         hookTimeoutMs: options.hookTimeoutMs,
@@ -49,7 +49,7 @@ function buildImpl(state) {
     return new DotAppImpl({
         appName: state.appName,
         appVersion: state.appVersion,
-        pips: state.pips,
+        plugins: state.plugins,
         config: state.config,
         observers: state.observers,
         hookTimeoutMs: state.hookTimeoutMs,
@@ -60,10 +60,17 @@ function makeBuilder(state) {
     // at the type level); the single cast below is the same kernel boundary
     // v1 crossed in its wrapApp helper.
     const impl = {
-        use(pip, ..._guard) {
+        use(plugin, ..._guard) {
             const nextState = {
                 ...state,
-                pips: [...state.pips, pip],
+                plugins: [...state.plugins, plugin],
+            };
+            return makeBuilder(nextState);
+        },
+        useAll(plugins, ..._guard) {
+            const nextState = {
+                ...state,
+                plugins: [...state.plugins, ...plugins],
             };
             return makeBuilder(nextState);
         },

package/dist/define-app.js.map

@@ -1 +1 @@
-{"version":3,"file":"define-app.js","sourceRoot":"","sources":["../src/define-app.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"define-app.js","sourceRoot":"","sources":["../src/define-app.ts"],"names":[],"mappings":"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"}

package/dist/diagnostics.d.ts

@@ -3,67 +3,71 @@
  *
  * Where the manifest describes the static shape of an app, a
  * `DotDiagnosticsSnapshot` is a point-in-time observability record: the
- * lifecycle state of the app and every pip, plus structured issues with
+ * lifecycle state of the app and every plugin, plus structured issues with
  * remediation guidance.
  *
  * CONTRACT: `DotDiagnosticsSnapshot` always exposes the same five arrays
- * (`pips`, `routes`, `services`, `lifecycle`, `issues`). Consumers must
+ * (`plugins`, `actions`, `services`, `lifecycle`, `issues`). Consumers must
  * never see an omitted array — empty is empty, but never missing.
  * This is the "5 arrays" contract referenced by the kernel spec.
  */
 import type { DotLifecycleHook, DotLifecycleState } from './lifecycle.js';
 /** Severity of a single diagnostic issue. */
 export type DiagnosticSeverity = 'info' | 'warning' | 'error';
-/** Status of a pip/route/service/lifecycle entry. */
+/** Status of a plugin/action/service/lifecycle entry. */
 export type DiagnosticStatus = 'ok' | 'degraded' | 'failed' | 'skipped' | 'missing';
 /**
  * Single point-in-time diagnostic snapshot of a DotApp.
  *
- * Five top-level arrays — pips, routes, services, lifecycle, issues —
+ * Five top-level arrays — plugins, actions, services, lifecycle, issues —
  * are guaranteed to be present even when empty.
  */
 export type DotDiagnosticsSnapshot = {
+    /** Diagnostic snapshot schema version. 2 = actions/projections era. */
+    snapshotVersion: 2;
     /** ISO-8601 timestamp at which the snapshot was generated. */
     generatedAt: string;
     app: {
         name: string;
         state: DotLifecycleState;
     };
-    pips: PipDiagnostic[];
-    routes: RouteDiagnostic[];
+    plugins: PluginDiagnostic[];
+    actions: ActionDiagnostic[];
     services: ServiceDiagnostic[];
     lifecycle: LifecycleDiagnostic[];
     issues: DiagnosticIssue[];
 };
-export type PipDiagnostic = {
-    pip: string;
+export type PluginDiagnostic = {
+    plugin: string;
     status: Extract<DiagnosticStatus, 'ok' | 'degraded' | 'failed' | 'skipped'>;
     issues: DiagnosticIssue[];
 };
-export type RouteDiagnostic = {
+export type ActionDiagnostic = {
     id: string;
-    pip: string;
+    plugin: string;
+    binding: string;
+    /** Structural configure-phase health only; not runtime liveness. */
     status: Extract<DiagnosticStatus, 'ok' | 'degraded' | 'failed'>;
     issues: DiagnosticIssue[];
 };
 export type ServiceDiagnostic = {
     service: string;
-    pip: string;
+    plugin: string;
     status: Extract<DiagnosticStatus, 'ok' | 'degraded' | 'failed' | 'missing'>;
     issues: DiagnosticIssue[];
 };
 export type LifecycleDiagnostic = {
-    pip: string;
+    plugin: string;
     hook: DotLifecycleHook;
     state: DotLifecycleState;
-    /** 0-based topological order of this pip within the hook pass. */
+    /** 0-based topological order of this plugin within the hook pass. */
     order: number;
     /** Wall-clock duration of the hook call, in milliseconds. */
     durationMs?: number;
     issues: DiagnosticIssue[];
 };
 /**
- * Single structured issue surfaced by the kernel or by a pip.
+ * Single structured issue surfaced by the kernel or by a plugin.
  *
  * `code`, `message`, `remediation` and `docsUrl` are required so that issues
  * are always actionable — never just "something went wrong".
@@ -72,7 +76,7 @@ export type DiagnosticIssue = {
     /** Stable machine-readable code, e.g. `DOT_LIFECYCLE_E003`. */
     code: string;
     severity: DiagnosticSeverity;
-    pip?: string;
+    plugin?: string;
     message: string;
     /** Human-readable remediation: what the developer should do. */
     remediation: string;

package/dist/diagnostics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAE1E,6CAA6C;AAC7C,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAE9D,qDAAqD;AACrD,MAAM,MAAM,gBAAgB,GAAG,IAAI,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;AAEpF;;;;;GAKG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,8DAA8D;IAC9D,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE;QACH,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,iBAAiB,CAAC;KAC1B,CAAC;IACF,IAAI,EAAE,aAAa,EAAE,CAAC;IACtB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,SAAS,EAAE,mBAAmB,EAAE,CAAC;IACjC,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,OAAO,CAAC,gBAAgB,EAAE,IAAI,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC,CAAC;IAC5E,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,OAAO,CAAC,gBAAgB,EAAE,IAAI,GAAG,UAAU,GAAG,QAAQ,CAAC,CAAC;IAChE,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,OAAO,CAAC,gBAAgB,EAAE,IAAI,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC,CAAC;IAC5E,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,gBAAgB,CAAC;IACvB,KAAK,EAAE,iBAAiB,CAAC;IACzB,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,WAAW,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,CAAC"}
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAE1E,6CAA6C;AAC7C,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAE9D,yDAAyD;AACzD,MAAM,MAAM,gBAAgB,GAAG,IAAI,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;AAEpF;;;;;GAKG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,uEAAuE;IACvE,eAAe,EAAE,CAAC,CAAC;IACnB,8DAA8D;IAC9D,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE;QACH,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,iBAAiB,CAAC;KAC1B,CAAC;IACF,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,SAAS,EAAE,mBAAmB,EAAE,CAAC;IACjC,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC,gBAAgB,EAAE,IAAI,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC,CAAC;IAC5E,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,MAAM,EAAE,OAAO,CAAC,gBAAgB,EAAE,IAAI,GAAG,UAAU,GAAG,QAAQ,CAAC,CAAC;IAChE,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC,gBAAgB,EAAE,IAAI,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC,CAAC;IAC5E,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,gBAAgB,CAAC;IACvB,KAAK,EAAE,iBAAiB,CAAC;IACzB,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,WAAW,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,CAAC"}

package/dist/diagnostics.js

@@ -3,11 +3,11 @@
  *
  * Where the manifest describes the static shape of an app, a
  * `DotDiagnosticsSnapshot` is a point-in-time observability record: the
- * lifecycle state of the app and every pip, plus structured issues with
+ * lifecycle state of the app and every plugin, plus structured issues with
  * remediation guidance.
  *
  * CONTRACT: `DotDiagnosticsSnapshot` always exposes the same five arrays
- * (`pips`, `routes`, `services`, `lifecycle`, `issues`). Consumers must
+ * (`plugins`, `actions`, `services`, `lifecycle`, `issues`). Consumers must
  * never see an omitted array — empty is empty, but never missing.
  * This is the "5 arrays" contract referenced by the kernel spec.
  */

package/dist/index.d.ts

@@ -3,25 +3,28 @@
  *
  * Public surface:
  *   - `defineApp(name)` — the entry point for composing applications.
- *   - `pip(config)` — author lifecycle-aware pips with typed needs/provides.
+ *   - `plugin(config)` — author lifecycle-aware plugins with typed needs/provides.
  *   - `service<T>()` / `token<T>()(key)` — service witnesses for DI wiring.
- *   - `rename(pip, map)` — mount-time multi-instance primitive.
+ *   - `rename(plugin, map)` — mount-time multi-instance primitive.
  *   - Lifecycle / manifest / diagnostics types.
- *   - `testApp` / `bootTestApp` — test harnesses for pip authors.
+ *   - `testApp` / `bootTestApp` — test harnesses for plugin authors.
  */
 export { defineApp } from './define-app.js';
-export type { DotApp, DotAppBuilder, DotAppConfigured, UseGuard } from './define-app.js';
-export { isLazy, lazy, lazyOf, pip, provide, rename, service, token, DotPipError } from './pip-contract.js';
-export type { AnyPip, CtxOf, DotConfigureContext, EmptyShape, KernelCtx, Lazy, LazyService, NeedsShape, Pip, PipNeeds, PipProvides, RenamedProvides, Service, ServiceRecord, Token, WireNeeds, } from './pip-contract.js';
+export type { DotApp, DotAppBuilder, DotAppConfigured, NormalizeProvides, UseAllAvail, UseAllGuard, UseGuard, } from './define-app.js';
+export { isLazy, lazy, lazyOf, plugin, provide, rename, service, token, DotPluginError } from './plugin-contract.js';
+export type { AnyPlugin, ActionSource, CtxOf, DotConfigureContext, EmptyShape, InferredProvides, KernelCtx, Lazy, LazyService, NeedsShape, NoReservedKeys, Plugin, PluginNeeds, PluginProvides, RenamedProvides, Service, ServiceRecord, Token, WireNeeds, } from './plugin-contract.js';
+export { initPlugins } from './init-plugins.js';
+export type { InitPluginsFactory } from './init-plugins.js';
 export { DotLifecycleError, DotLifecycleErrorCode, DOT_LIFECYCLE_HOOKS, } from './lifecycle.js';
-export type { DotLifecycleHook, DotLifecycleState, DotLifecyclePipFailure, DotLifecycleErrorCodeValue, } from './lifecycle.js';
-export type { DotAppManifest, PipManifest, RouteManifest, ServiceManifest, LifecycleManifest, DependencyEdge, DependencyEdgeKind, ServiceKind, RouteTransport, } from './manifest.js';
-export type { DotDiagnosticsSnapshot, PipDiagnostic, RouteDiagnostic, ServiceDiagnostic, LifecycleDiagnostic, DiagnosticIssue, DiagnosticSeverity, DiagnosticStatus, } from './diagnostics.js';
-export type { DotLifecycleEvent, DotLifecycleEventStatus, DotLifecycleObserver, DotPhaseLifecycleEvent, DotPipHookLifecycleEvent, } from './lifecycle-observer.js';
+export type { DotLifecycleHook, DotLifecycleState, DotLifecyclePluginFailure, DotLifecycleErrorCodeValue, } from './lifecycle.js';
+export type { DotAppManifest, ActionDirection, ActionManifest, JsonObject, JsonValue, PluginManifest, ProjectionManifest, ServiceManifest, LifecycleManifest, DependencyEdge, DependencyEdgeKind, ServiceKind, } from './manifest.js';
+export { toJsonObject } from './manifest.js';
+export type { DotDiagnosticsSnapshot, PluginDiagnostic, ActionDiagnostic, ServiceDiagnostic, LifecycleDiagnostic, DiagnosticIssue, DiagnosticSeverity, DiagnosticStatus, } from './diagnostics.js';
+export type { DotLifecycleEvent, DotLifecycleEventStatus, DotLifecycleObserver, DotPhaseLifecycleEvent, DotPluginHookLifecycleEvent, } from './lifecycle-observer.js';
 export { renderTimeline } from './timeline.js';
 export type { RenderTimelineOptions } from './timeline.js';
-export { testApp, bootTestApp, testPip } from './test-harness.js';
-export type { TestAppOptions, TestPipBuilder } from './test-harness.js';
+export { testApp, bootTestApp, testPlugin } from './test-harness.js';
+export type { TestAppOptions, TestPluginBuilder } from './test-harness.js';
 export { hookSignals } from './signals.js';
 export type { HookSignalsOptions, SignalTarget } from './signals.js';
 export type { DotCliEnvelope, DotCliEnvelopeStatus } from './cli/render-explain.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEzF,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC5G,YAAY,EACV,MAAM,EACN,KAAK,EACL,mBAAmB,EACnB,UAAU,EACV,SAAS,EACT,IAAI,EACJ,WAAW,EACX,UAAU,EACV,GAAG,EACH,QAAQ,EACR,WAAW,EACX,eAAe,EACf,OAAO,EACP,aAAa,EACb,KAAK,EACL,SAAS,GACV,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,cAAc,EACd,WAAW,EACX,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,cAAc,GACf,MAAM,eAAe,CAAC;AAEvB,YAAY,EACV,sBAAsB,EACtB,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EACV,iBAAiB,EACjB,uBAAuB,EACvB,oBAAoB,EACpB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,YAAY,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAE3D,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAClE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,YAAY,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAIrE,YAAY,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EACV,MAAM,EACN,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,WAAW,EACX,QAAQ,GACT,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACrH,YAAY,EACV,SAAS,EACT,YAAY,EACZ,KAAK,EACL,mBAAmB,EACnB,UAAU,EACV,gBAAgB,EAChB,SAAS,EACT,IAAI,EACJ,WAAW,EACX,UAAU,EACV,cAAc,EACd,MAAM,EACN,WAAW,EACX,cAAc,EACd,eAAe,EACf,OAAO,EACP,aAAa,EACb,KAAK,EACL,SAAS,GACV,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,cAAc,EACd,eAAe,EACf,cAAc,EACd,UAAU,EACV,SAAS,EACT,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,WAAW,GACZ,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,YAAY,EACV,sBAAsB,EACtB,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EACV,iBAAiB,EACjB,uBAAuB,EACvB,oBAAoB,EACpB,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,YAAY,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAE3D,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACrE,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3E,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,YAAY,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAIrE,YAAY,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -3,18 +3,20 @@
  *
  * Public surface:
  *   - `defineApp(name)` — the entry point for composing applications.
- *   - `pip(config)` — author lifecycle-aware pips with typed needs/provides.
+ *   - `plugin(config)` — author lifecycle-aware plugins with typed needs/provides.
  *   - `service<T>()` / `token<T>()(key)` — service witnesses for DI wiring.
- *   - `rename(pip, map)` — mount-time multi-instance primitive.
+ *   - `rename(plugin, map)` — mount-time multi-instance primitive.
  *   - Lifecycle / manifest / diagnostics types.
- *   - `testApp` / `bootTestApp` — test harnesses for pip authors.
+ *   - `testApp` / `bootTestApp` — test harnesses for plugin authors.
  */
 // #region Kernel — public surface
 export { defineApp } from './define-app.js';
-export { isLazy, lazy, lazyOf, pip, provide, rename, service, token, DotPipError } from './pip-contract.js';
+export { isLazy, lazy, lazyOf, plugin, provide, rename, service, token, DotPluginError } from './plugin-contract.js';
+export { initPlugins } from './init-plugins.js';
 export { DotLifecycleError, DotLifecycleErrorCode, DOT_LIFECYCLE_HOOKS, } from './lifecycle.js';
+export { toJsonObject } from './manifest.js';
 export { renderTimeline } from './timeline.js';
-export { testApp, bootTestApp, testPip } from './test-harness.js';
+export { testApp, bootTestApp, testPlugin } from './test-harness.js';
 export { hookSignals } from './signals.js';
 // #endregion
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,kCAAkC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAoB5G,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AAuCxB,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG/C,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAGlE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAM3C,aAAa"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,kCAAkC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAW5C,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAuBrH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AAsBxB,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAqB7C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG/C,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGrE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAM3C,aAAa"}

package/dist/init-pips.d.ts

@@ -0,0 +1,45 @@
+import type { CtxOf, DotConfigureContext, EmptyShape, InferredProvides, KernelCtx, NeedsShape, NoReservedKeys, Pip, ActionSource, Service, ServiceRecord, WireNeeds } from './pip-contract.js';
+type MaybePromise<T> = T | Promise<T>;
+type ServiceKey<TServices extends object> = Extract<keyof TServices, string>;
+type ServiceKeys<TServices extends object> = readonly ServiceKey<TServices>[];
+type PickServices<TServices extends object, TKeys extends ServiceKeys<TServices>> = {
+    readonly [K in TKeys[number]]: TServices[K];
+};
+type WitnessesFor<TServices extends object, TKeys extends ServiceKeys<TServices>> = {
+    readonly [K in TKeys[number]]: Service<TServices[K]>;
+};
+type SchemaCheckedProvides<TServices extends object, TProvides extends ServiceRecord> = {
+    readonly [K in keyof TProvides]: K extends keyof TServices ? TProvides[K] extends TServices[K] ? TProvides[K] : never : TProvides[K];
+};
+type CommonPipDefinition = {
+    readonly name: string;
+    readonly version?: string;
+    readonly actions?: readonly ActionSource[];
+    readonly configure?: (ctx: DotConfigureContext) => void;
+};
+type KeyArrayPipDefinition<TServices extends object, TKeys extends ServiceKeys<TServices>, TProvides extends ServiceRecord & NoReservedKeys> = CommonPipDefinition & {
+    readonly needs?: TKeys;
+    readonly boot?: (ctx: PickServices<TServices, TKeys> & KernelCtx) => MaybePromise<SchemaCheckedProvides<TServices, TProvides> | void>;
+    readonly start?: (ctx: PickServices<TServices, TKeys> & TProvides & KernelCtx) => MaybePromise<void>;
+    readonly stop?: (ctx: PickServices<TServices, TKeys> & TProvides & KernelCtx) => MaybePromise<void>;
+    readonly dispose?: (ctx: PickServices<TServices, TKeys> & TProvides & KernelCtx) => MaybePromise<void>;
+};
+type WitnessPipDefinition<TServices extends object, TShape extends NeedsShape & NoReservedKeys, TProvides extends ServiceRecord & NoReservedKeys> = CommonPipDefinition & {
+    readonly needs: TShape;
+    readonly boot?: (ctx: CtxOf<TShape> & KernelCtx) => MaybePromise<SchemaCheckedProvides<TServices, TProvides> | void>;
+    readonly start?: (ctx: CtxOf<TShape> & TProvides & KernelCtx) => MaybePromise<void>;
+    readonly stop?: (ctx: CtxOf<TShape> & TProvides & KernelCtx) => MaybePromise<void>;
+    readonly dispose?: (ctx: CtxOf<TShape> & TProvides & KernelCtx) => MaybePromise<void>;
+};
+export type InitPipsFactory<TServices extends object> = {
+    pip<const TKeys extends ServiceKeys<TServices> = readonly [], TProvides extends ServiceRecord & NoReservedKeys = EmptyShape>(def: KeyArrayPipDefinition<TServices, TKeys, TProvides>): Pip<PickServices<TServices, TKeys>, InferredProvides<TProvides>>;
+    pip<TShape extends NeedsShape & NoReservedKeys, TProvides extends ServiceRecord & NoReservedKeys = EmptyShape>(def: WitnessPipDefinition<TServices, TShape, TProvides>): Pip<WireNeeds<TShape>, InferredProvides<TProvides>>;
+    needs<const TKeys extends ServiceKeys<TServices>>(...keys: TKeys): WitnessesFor<TServices, TKeys>;
+};
+export declare const initPips: {
+    context<TServices extends object>(): {
+        create(): InitPipsFactory<TServices>;
+    };
+};
+export {};
+//# sourceMappingURL=init-pips.d.ts.map

package/dist/init-pips.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-pips.d.ts","sourceRoot":"","sources":["../src/init-pips.ts"],"names":[],"mappings":"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"}

package/dist/init-pips.js

@@ -0,0 +1,49 @@
+import { pip as definePip, service } from './pip-contract.js';
+function needsFor(keys) {
+    const needs = {};
+    for (const key of keys) {
+        needs[key] = service();
+    }
+    return needs;
+}
+function isServiceKeyArray(needs) {
+    return Array.isArray(needs);
+}
+function createPipFactory() {
+    const factory = {
+        pip(def) {
+            const rawNeeds = def.needs;
+            const needs = isServiceKeyArray(rawNeeds)
+                ? needsFor(rawNeeds)
+                : rawNeeds;
+            // Factory seam: key-array authoring is runtime-compiled to the same
+            // witness record that the kernel already understands.
+            const kernelDef = {
+                name: def.name,
+                ...(def.version === undefined ? {} : { version: def.version }),
+                ...(needs === undefined ? {} : { needs }),
+                ...(def.actions === undefined ? {} : { actions: def.actions }),
+                ...(def.configure === undefined ? {} : { configure: def.configure }),
+                ...(def.boot === undefined ? {} : { boot: def.boot }),
+                ...(def.start === undefined ? {} : { start: def.start }),
+                ...(def.stop === undefined ? {} : { stop: def.stop }),
+                ...(def.dispose === undefined ? {} : { dispose: def.dispose }),
+            };
+            return definePip(kernelDef);
+        },
+        needs(...keys) {
+            return needsFor(keys);
+        },
+    };
+    return factory;
+}
+export const initPips = {
+    context() {
+        return {
+            create() {
+                return createPipFactory();
+            },
+        };
+    },
+};
+//# sourceMappingURL=init-pips.js.map

package/dist/init-pips.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-pips.js","sourceRoot":"","sources":["../src/init-pips.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,GAAG,IAAI,SAAS,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AA0E9D,SAAS,QAAQ,CACf,IAAW;IAEX,MAAM,KAAK,GAAqC,EAAE,CAAC;IACnD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,KAAK,CAAC,GAAG,CAAC,GAAG,OAAO,EAAyB,CAAC;IAChD,CAAC;IACD,OAAO,KAAuC,CAAC;AACjD,CAAC;AAED,SAAS,iBAAiB,CACxB,KAA8C;IAE9C,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED,SAAS,gBAAgB;IACvB,MAAM,OAAO,GAAG;QACd,GAAG,CAAC,GAAmC;YACrC,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC;YAC3B,MAAM,KAAK,GAAG,iBAAiB,CAAY,QAAQ,CAAC;gBAClD,CAAC,CAAC,QAAQ,CAAoC,QAAQ,CAAC;gBACvD,CAAC,CAAC,QAAQ,CAAC;YACb,oEAAoE;YACpE,sDAAsD;YACtD,MAAM,SAAS,GAAwB;gBACrC,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,GAAG,CAAC,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;gBAC9D,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;gBACzC,GAAG,CAAC,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;gBAC9D,GAAG,CAAC,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC;gBACpE,GAAG,CAAC,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAmC,EAAE,CAAC;gBACpF,GAAG,CAAC,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAqC,EAAE,CAAC;gBACxF,GAAG,CAAC,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAmC,EAAE,CAAC;gBACpF,GAAG,CAAC,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAyC,EAAE,CAAC;aACjG,CAAC;YACF,OAAO,SAAS,CAAC,SAAS,CAAiD,CAAC;QAC9E,CAAC;QACD,KAAK,CAA6C,GAAG,IAAW;YAC9D,OAAO,QAAQ,CAAyB,IAAI,CAAC,CAAC;QAChD,CAAC;KACF,CAAC;IACF,OAAO,OAAqC,CAAC;AAC/C,CAAC;AAED,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,OAAO;QACL,OAAO;YACL,MAAM;gBACJ,OAAO,gBAAgB,EAAa,CAAC;YACvC,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/init-plugins.d.ts

@@ -0,0 +1,45 @@
+import type { CtxOf, DotConfigureContext, EmptyShape, InferredProvides, KernelCtx, NeedsShape, NoReservedKeys, Plugin, ActionSource, Service, ServiceRecord, WireNeeds } from './plugin-contract.js';
+type MaybePromise<T> = T | Promise<T>;
+type ServiceKey<TServices extends object> = Extract<keyof TServices, string>;
+type ServiceKeys<TServices extends object> = readonly ServiceKey<TServices>[];
+type PickServices<TServices extends object, TKeys extends ServiceKeys<TServices>> = {
+    readonly [K in TKeys[number]]: TServices[K];
+};
+type WitnessesFor<TServices extends object, TKeys extends ServiceKeys<TServices>> = {
+    readonly [K in TKeys[number]]: Service<TServices[K]>;
+};
+type SchemaCheckedProvides<TServices extends object, TProvides extends ServiceRecord> = {
+    readonly [K in keyof TProvides]: K extends keyof TServices ? TProvides[K] extends TServices[K] ? TProvides[K] : never : TProvides[K];
+};
+type CommonPluginDefinition = {
+    readonly name: string;
+    readonly version?: string;
+    readonly actions?: readonly ActionSource[];
+    readonly configure?: (ctx: DotConfigureContext) => void;
+};
+type KeyArrayPluginDefinition<TServices extends object, TKeys extends ServiceKeys<TServices>, TProvides extends ServiceRecord & NoReservedKeys> = CommonPluginDefinition & {
+    readonly needs?: TKeys;
+    readonly boot?: (ctx: PickServices<TServices, TKeys> & KernelCtx) => MaybePromise<SchemaCheckedProvides<TServices, TProvides> | void>;
+    readonly start?: (ctx: PickServices<TServices, TKeys> & TProvides & KernelCtx) => MaybePromise<void>;
+    readonly stop?: (ctx: PickServices<TServices, TKeys> & TProvides & KernelCtx) => MaybePromise<void>;
+    readonly dispose?: (ctx: PickServices<TServices, TKeys> & TProvides & KernelCtx) => MaybePromise<void>;
+};
+type WitnessPluginDefinition<TServices extends object, TShape extends NeedsShape & NoReservedKeys, TProvides extends ServiceRecord & NoReservedKeys> = CommonPluginDefinition & {
+    readonly needs: TShape;
+    readonly boot?: (ctx: CtxOf<TShape> & KernelCtx) => MaybePromise<SchemaCheckedProvides<TServices, TProvides> | void>;
+    readonly start?: (ctx: CtxOf<TShape> & TProvides & KernelCtx) => MaybePromise<void>;
+    readonly stop?: (ctx: CtxOf<TShape> & TProvides & KernelCtx) => MaybePromise<void>;
+    readonly dispose?: (ctx: CtxOf<TShape> & TProvides & KernelCtx) => MaybePromise<void>;
+};
+export type InitPluginsFactory<TServices extends object> = {
+    plugin<const TKeys extends ServiceKeys<TServices> = readonly [], TProvides extends ServiceRecord & NoReservedKeys = EmptyShape>(def: KeyArrayPluginDefinition<TServices, TKeys, TProvides>): Plugin<PickServices<TServices, TKeys>, InferredProvides<TProvides>>;
+    plugin<TShape extends NeedsShape & NoReservedKeys, TProvides extends ServiceRecord & NoReservedKeys = EmptyShape>(def: WitnessPluginDefinition<TServices, TShape, TProvides>): Plugin<WireNeeds<TShape>, InferredProvides<TProvides>>;
+    needs<const TKeys extends ServiceKeys<TServices>>(...keys: TKeys): WitnessesFor<TServices, TKeys>;
+};
+export declare const initPlugins: {
+    context<TServices extends object>(): {
+        create(): InitPluginsFactory<TServices>;
+    };
+};
+export {};
+//# sourceMappingURL=init-plugins.d.ts.map

package/dist/init-plugins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-plugins.d.ts","sourceRoot":"","sources":["../src/init-plugins.ts"],"names":[],"mappings":"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"}

package/dist/init-plugins.js

@@ -0,0 +1,49 @@
+import { plugin as definePlugin, service } from './plugin-contract.js';
+function needsFor(keys) {
+    const needs = {};
+    for (const key of keys) {
+        needs[key] = service();
+    }
+    return needs;
+}
+function isServiceKeyArray(needs) {
+    return Array.isArray(needs);
+}
+function createPluginFactory() {
+    const factory = {
+        plugin(def) {
+            const rawNeeds = def.needs;
+            const needs = isServiceKeyArray(rawNeeds)
+                ? needsFor(rawNeeds)
+                : rawNeeds;
+            // Factory seam: key-array authoring is runtime-compiled to the same
+            // witness record that the kernel already understands.
+            const kernelDef = {
+                name: def.name,
+                ...(def.version === undefined ? {} : { version: def.version }),
+                ...(needs === undefined ? {} : { needs }),
+                ...(def.actions === undefined ? {} : { actions: def.actions }),
+                ...(def.configure === undefined ? {} : { configure: def.configure }),
+                ...(def.boot === undefined ? {} : { boot: def.boot }),
+                ...(def.start === undefined ? {} : { start: def.start }),
+                ...(def.stop === undefined ? {} : { stop: def.stop }),
+                ...(def.dispose === undefined ? {} : { dispose: def.dispose }),
+            };
+            return definePlugin(kernelDef);
+        },
+        needs(...keys) {
+            return needsFor(keys);
+        },
+    };
+    return factory;
+}
+export const initPlugins = {
+    context() {
+        return {
+            create() {
+                return createPluginFactory();
+            },
+        };
+    },
+};
+//# sourceMappingURL=init-plugins.js.map

package/dist/init-plugins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-plugins.js","sourceRoot":"","sources":["../src/init-plugins.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,MAAM,IAAI,YAAY,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AA0EvE,SAAS,QAAQ,CACf,IAAW;IAEX,MAAM,KAAK,GAAqC,EAAE,CAAC;IACnD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,KAAK,CAAC,GAAG,CAAC,GAAG,OAAO,EAAyB,CAAC;IAChD,CAAC;IACD,OAAO,KAAuC,CAAC;AACjD,CAAC;AAED,SAAS,iBAAiB,CACxB,KAAiD;IAEjD,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED,SAAS,mBAAmB;IAC1B,MAAM,OAAO,GAAG;QACd,MAAM,CAAC,GAAsC;YAC3C,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC;YAC3B,MAAM,KAAK,GAAG,iBAAiB,CAAY,QAAQ,CAAC;gBAClD,CAAC,CAAC,QAAQ,CAAoC,QAAQ,CAAC;gBACvD,CAAC,CAAC,QAAQ,CAAC;YACb,oEAAoE;YACpE,sDAAsD;YACtD,MAAM,SAAS,GAA2B;gBACxC,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,GAAG,CAAC,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;gBAC9D,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;gBACzC,GAAG,CAAC,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;gBAC9D,GAAG,CAAC,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC;gBACpE,GAAG,CAAC,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAsC,EAAE,CAAC;gBACvF,GAAG,CAAC,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAwC,EAAE,CAAC;gBAC3F,GAAG,CAAC,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAsC,EAAE,CAAC;gBACvF,GAAG,CAAC,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAA4C,EAAE,CAAC;aACpG,CAAC;YACF,OAAO,YAAY,CAAC,SAAS,CAAoD,CAAC;QACpF,CAAC;QACD,KAAK,CAA6C,GAAG,IAAW;YAC9D,OAAO,QAAQ,CAAyB,IAAI,CAAC,CAAC;QAChD,CAAC;KACF,CAAC;IACF,OAAO,OAAwC,CAAC;AAClD,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,OAAO;QACL,OAAO;YACL,MAAM;gBACJ,OAAO,mBAAmB,EAAa,CAAC;YAC1C,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/kernel/app-instance.d.ts

@@ -8,11 +8,11 @@ import type { DotDiagnosticsSnapshot } from '../diagnostics.js';
 import type { DotLifecycleObserver } from '../lifecycle-observer.js';
 import type { DotLifecycleState } from '../lifecycle.js';
 import type { DotAppManifest } from '../manifest.js';
-import type { AnyPip } from '../pip-contract.js';
+import type { AnyPlugin } from '../plugin-contract.js';
 export type DotAppInternalConfig = {
     appName: string;
     appVersion?: string;
-    pips: readonly AnyPip[];
+    plugins: readonly AnyPlugin[];
     /** Runtime config bag passed to every `boot` hook. */
     config?: Readonly<Record<string, unknown>>;
     /**
@@ -58,7 +58,7 @@ export declare class DotAppImpl {
     /** Public dispose(). Idempotent + concurrent-safe. */
     dispose(): Promise<void>;
 }
-/** Re-export `ServiceKind` and `RouteTransport` for the kernel's internal use. */
-export { type RouteTransport, type ServiceKind } from '../manifest.js';
-export { type Pip } from '../pip-contract.js';
+/** Re-export `ServiceKind` for the kernel's internal use. */
+export { type ServiceKind } from '../manifest.js';
+export { type Plugin } from '../plugin-contract.js';
 //# sourceMappingURL=app-instance.d.ts.map

package/dist/kernel/app-instance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-instance.d.ts","sourceRoot":"","sources":["../../src/kernel/app-instance.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAEV,sBAAsB,EAKvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAqB,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACxF,OAAO,KAAK,EAA4C,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACnG,OAAO,KAAK,EAEV,cAAc,EAKf,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,MAAM,EAA4C,MAAM,oBAAoB,CAAC;AAkE3F,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,sDAAsD;IACtD,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3C;;;;OAIG;IACH,SAAS,CAAC,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAC5C,kFAAkF;IAClF,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF;;;GAGG;AACH,qBAAa,UAAU;;gBAsET,MAAM,EAAE,oBAAoB;IAqExC;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,IAAI;IAuIrD,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,KAAK,IAAI,iBAAiB,CAE7B;IAED,IAAI,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEtC;IAED,IAAI,QAAQ,IAAI,cAAc,CAE7B;IAED,IAAI,WAAW,IAAI,sBAAsB,CAExC;IAED;;;;OAIG;IACH,YAAY,IAAI,IAAI;IA8KpB,oDAAoD;IAC9C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA8T3B,2EAA2E;IACrE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAsI5B,mDAAmD;IAC7C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAsH3B,sDAAsD;IAChD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CA6T/B;AA0BD,kFAAkF;AAElF,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACvE,OAAO,EAAE,KAAK,GAAG,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"app-instance.d.ts","sourceRoot":"","sources":["../../src/kernel/app-instance.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAGV,sBAAsB,EAIvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAqB,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACxF,OAAO,KAAK,EAA+C,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACtG,OAAO,KAAK,EAGV,cAAc,EAMf,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAA4C,MAAM,uBAAuB,CAAC;AAqEjG,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,SAAS,SAAS,EAAE,CAAC;IAC9B,sDAAsD;IACtD,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3C;;;;OAIG;IACH,SAAS,CAAC,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAC5C,kFAAkF;IAClF,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF;;;GAGG;AACH,qBAAa,UAAU;;gBAsET,MAAM,EAAE,oBAAoB;IAsExC;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,IAAI;IAiOrD,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,KAAK,IAAI,iBAAiB,CAE7B;IAED,IAAI,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEtC;IAED,IAAI,QAAQ,IAAI,cAAc,CAE7B;IAED,IAAI,WAAW,IAAI,sBAAsB,CAExC;IAED;;;;OAIG;IACH,YAAY,IAAI,IAAI;IA+MpB,oDAAoD;IAC9C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA8T3B,2EAA2E;IACrE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAsI5B,mDAAmD;IAC7C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAsH3B,sDAAsD;IAChD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAmU/B;AAqCD,6DAA6D;AAE7D,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC"}